AWS CDK NodejsFunction部署uplink-nodejs依赖问题求助

基于AWS基础设施开发项目，采用aws-cdk-lib作为IaC工具，业务流程如下：

• 用户上传音视频至S3 Bucket
• 触发Lambda通过sharp压缩文件，存入带短TTL的另一S3 Bucket
• 该S3 Bucket的对象创建通知触发Lambda，通过uplink-nodejs库将对象上传至Storj Bucket

但uplink-nodejs的安装有特殊要求：

1. 需预先安装make命令
2. 需将./node_modules/uplink-nodejs/*复制到系统目录

尝试两种方案均失败：

1. 使用NodejsFunction的beforeInstall等打包钩子时，因无sudo权限无法安装make
2. 在Lambda目录创建.dockerfile未解决依赖问题

方案1：使用Lambda容器镜像（正确配置Dockerfile） #

Lambda容器镜像支持自定义运行环境，可完整解决依赖安装与权限问题，步骤如下：

1. 在Lambda函数目录编写Dockerfile：

# 采用AWS官方Node.js运行时镜像（与Lambda兼容）
FROM public.ecr.aws/lambda/nodejs:20

# 安装系统依赖（make、编译工具链）
RUN yum install -y make gcc-c++

# 切换至Lambda任务根目录
WORKDIR ${LAMBDA_TASK_ROOT}

# 复制依赖配置文件
COPY package*.json ./

# 安装npm依赖（包括uplink-nodejs）
RUN npm install

# 将uplink-nodejs文件复制到系统目录（根据库要求调整路径）
RUN cp -r ./node_modules/uplink-nodejs/* /usr/local/lib/

# 复制Lambda业务代码
COPY index.js ./

# 设置Lambda入口函数
CMD ["index.handler"]

2. 在CDK中用DockerImageFunction替代NodejsFunction：

import { DockerImageFunction, DockerImageCode } from 'aws-cdk-lib/aws-lambda';
import { Construct } from 'constructs';
import * as path from 'path';
import * as s3 from 'aws-cdk-lib/aws-s3';
import * as targets from 'aws-cdk-lib/aws-s3-notifications';

// 在Stack中定义Storj上传函数
const storjUploadFunction = new DockerImageFunction(this, 'StorjUploadFunction', {
  code: DockerImageCode.fromImageAsset(path.join(__dirname, './lambda/storj-upload')),
  memorySize: 1024,
  timeout: cdk.Duration.seconds(30),
});

// 绑定S3触发器
const compressedBucket = s3.Bucket.fromBucketName(this, 'CompressedBucket', 'your-compressed-bucket-name');
compressedBucket.addEventNotification(
  s3.EventType.OBJECT_CREATED,
  new targets.LambdaDestination(storjUploadFunction)
);

方案2：预构建Lambda依赖层（Layer） #

在本地有完整权限的环境中预构建uplink-nodejs依赖，打包为Lambda Layer，避免部署时的依赖安装问题：

1. 创建Layer目录结构：

uplink-layer/
└── nodejs/
    ├── package.json
    └── node_modules/

2. 在uplink-layer/nodejs目录下执行：

# 安装uplink-nodejs（本地需提前安装make）
npm install uplink-nodejs
# 复制库文件到Layer的lib目录（Lambda运行时会挂载Layer到/opt）
cp -r ./node_modules/uplink-nodejs/* ./lib/

3. 打包Layer为zip：

cd uplink-layer
zip -r uplink-layer.zip nodejs/

4. 在CDK中创建Layer并关联到Lambda：

import { LayerVersion, NodejsFunction } from 'aws-cdk-lib/aws-lambda';
import * as path from 'path';

const uplinkLayer = new LayerVersion(this, 'UplinkNodejsLayer', {
  code: cdk.AssetCode.fromAsset(path.join(__dirname, './uplink-layer/uplink-layer.zip')),
  compatibleRuntimes: [lambda.Runtime.NODEJS_20_X],
});

// 关联Layer到Lambda函数
const storjUploadFunction = new NodejsFunction(this, 'StorjUploadFunction', {
  entry: path.join(__dirname, './lambda/storj-upload/index.js'),
  runtime: lambda.Runtime.NODEJS_20_X,
  layers: [uplinkLayer],
  memorySize: 1024,
});

注意：预构建需使用与Lambda运行时兼容的系统（如Amazon Linux 2），避免二进制兼容性问题，可通过Docker的Amazon Linux镜像完成构建。

方案3：调整打包钩子，规避sudo限制 #

Lambda构建环境为Amazon Linux 2，当前用户拥有yum安装权限（无需sudo），可调整打包钩子配置：

import { NodejsFunction } from 'aws-cdk-lib/aws-lambda';
import * as path from 'path';

const storjUploadFunction = new NodejsFunction(this, 'StorjUploadFunction', {
  entry: path.join(__dirname, './lambda/storj-upload/index.js'),
  runtime: lambda.Runtime.NODEJS_20_X,
  bundling: {
    beforeInstall: [
      // 直接安装make与编译工具
      'yum install -y make gcc-c++'
    ],
    afterInstall: [
      // 将uplink-nodejs复制到Lambda任务目录（无需系统目录）
      'cp -r ./node_modules/uplink-nodejs/* /asset-output/'
    ],
  },
});

在Lambda代码中添加路径配置，确保Node.js能找到模块：

// Lambda入口文件index.js
process.env.NODE_PATH = `${process.env.NODE_PATH}:${process.env.LAMBDA_TASK_ROOT}`;
const uplink = require('uplink-nodejs');

• 查看Lambda的CloudWatch日志，定位具体错误（如模块找不到、系统依赖缺失）
• 确认Dockerfile中是否安装了gcc-c++（uplink-nodejs可能需要编译二进制文件）
• 检查Layer目录结构是否符合要求：node_modules必须放在layer/nodejs下，Lambda才会自动识别

内容的提问来源于stack exchange，提问作者Thomas Geenen