如何为AWS CDK部署的NodejsFunction安装GraphicsMagick二进制文件？

需要通过AWS CDK部署Lambda函数，使用gm将PDF第一页转换为PNG。本地运行正常，但Lambda中因缺少GraphicsMagick二进制文件，出现Error: Stream yields empty buffer错误。尝试添加Layer未成功，想了解如何通过Docker为NodejsFunction安装GraphicsMagick。

现有代码 #

NodejsFunction定义 #

const designerHandler = new NodejsFunction(this, "designer-server", {
  functionName: "designer-server",
  memorySize: 512,
  runtime: lambda.Runtime.NODEJS_12_X,
  handler: "handler",
  entry: path.join(__dirname, "./server/src/index.ts"),
  timeout: cdk.Duration.seconds(30),
});

尝试添加Layer的代码 #

designerHandler.addLayers(
  lambda.LayerVersion.fromLayerVersionArn(
    this,
    "layer-graphicsmagick",
    "arn:aws:lambda:ap-southeast-2:391641713082:layer:graphicsmagick-layer:1"
  )
);

使用gm的业务代码 #

const pngOf = (pdf: Buffer) => {
  return new Promise(
    (resolve: (value: Buffer) => void, reject: (reason: any) => void) => {
      gm(pdf)
        .density(600, 600)
        .resize(600)
        .toBuffer('PNG', (err, png) => {
          if (err) {
            reject(err);
          }
          resolve(png);
        });
    }
  );
};

方案一：修复Layer使用问题（无需Docker） #

你之前使用的Layer可能存在路径结构错误，导致Lambda无法识别GraphicsMagick二进制文件。Lambda要求Layer的可执行文件必须放在bin/目录下（解压后会位于/opt/bin/，该路径默认在Lambda的环境PATH中）。

自定义构建GraphicsMagick Layer步骤： #

1. 本地创建Layer目录结构：

   mkdir -p gm-layer/bin
   

2. 下载适配Amazon Linux 2（Lambda Node.js 12运行时的基础系统）编译的GraphicsMagick二进制文件，放入gm-layer/bin/并赋予执行权限：

   chmod +x gm-layer/bin/gm
   

3. 在CDK中定义并发布Layer：

   const gmLayer = new lambda.LayerVersion(this, 'GraphicsMagickLayer', {
     code: lambda.Code.fromAsset(path.join(__dirname, 'gm-layer')),
     compatibleRuntimes: [lambda.Runtime.NODEJS_12_X],
     description: 'GraphicsMagick for PDF to PNG conversion',
   });
   

4. 为Lambda函数添加该Layer：

   designerHandler.addLayers(gmLayer);
   

方案二：Docker构建自定义Lambda镜像 #

如果Layer方式仍无法解决问题，可通过Docker构建包含Node.js和GraphicsMagick的自定义镜像：

1. 项目根目录创建Dockerfile：

   # 基于官方Lambda Node.js 12镜像
   FROM public.ecr.aws/lambda/nodejs:12
   
   # 安装GraphicsMagick及依赖
   RUN yum install -y GraphicsMagick && yum clean all
   
   # 复制业务代码到Lambda工作目录
   COPY server/src/* ${LAMBDA_TASK_ROOT}/
   
   # 安装npm依赖
   RUN npm install
   
   # 指定Lambda handler入口
   CMD ["index.handler"]
   

2. 在CDK中替换NodejsFunction为DockerImageFunction：

   const designerHandler = new lambda.DockerImageFunction(this, "designer-server", {
     functionName: "designer-server",
     memorySize: 512,
     timeout: cdk.Duration.seconds(30),
     code: lambda.DockerImageCode.fromImageAsset(path.join(__dirname, '.'), {
       dockerfile: 'Dockerfile',
     }),
   });
   

3. 部署时，CDK会自动构建镜像并推送到AWS ECR，随后创建使用该镜像的Lambda函数。

注意：Node.js 12已停止官方支持，建议升级至LTS版本（如18.x）以避免安全风险。

内容的提问来源于stack exchange，提问作者Lachlan Smith