CDK CICD流水线部署时无法找到栈中资源引用的问题

问题根源 #

本地手动部署时，lambda.Code.fromAsset('resources/layers/helper')的相对路径以项目根目录为基准，能正常找到资源；但CDK流水线执行时，工作目录切换到了CICD栈所在的子目录（如/infra/lib），导致相对路径指向错误，无法定位到资源文件。

解决方案 #

1. 用绝对路径替代相对路径

利用Node.js的__dirname变量（指向当前文件所在目录），拼接出资源的绝对路径，彻底摆脱工作目录的影响。

修改前代码：

const helperLayer = new lambda.LayerVersion(this, 'HelperLayer', {
  code: lambda.Code.fromAsset('resources/layers/helper'),
  // 其他配置项
});

修改后代码：

import * as path from 'path';

const helperLayer = new lambda.LayerVersion(this, 'HelperLayer', {
  code: lambda.Code.fromAsset(path.join(__dirname, '../../resources/layers/helper')),
  // 其他配置项
});

注：../../的层级需根据当前文件在项目中的实际位置调整，确保能正确回溯到项目根目录下的resources文件夹。

2. 统一配置资源根路径（可选优化）

在项目根目录创建全局配置文件，统一管理资源根路径，避免多处调整层级：

1. 根目录新建config.ts：

import * as path from 'path';

export const RESOURCES_ROOT = path.join(__dirname, 'resources');

2. 在Lambda层定义文件中引用：

import { RESOURCES_ROOT } from '../../config';
import * as path from 'path';

const helperLayer = new lambda.LayerVersion(this, 'HelperLayer', {
  code: lambda.Code.fromAsset(path.join(RESOURCES_ROOT, 'layers/helper')),
  // 其他配置项
});

3. 检查流水线配置

• 确保CodePipeline的Source阶段拉取完整项目仓库，而非仅子目录，保证resources文件夹存在于流水线工作目录中。
• 若使用CodeBuild，检查buildspec.yml的工作目录和命令执行路径，确保在项目根目录下执行cdk synth和cdk deploy命令：

version: 0.2
phases:
  install:
    commands:
      - npm install -g aws-cdk
      - npm install
  build:
    commands:
      - cdk synth
      - cdk deploy --require-approval never

内容的提问来源于stack exchange，提问作者Neville Bamshoot