如何在AWS CDK代码中引用BuildSpec文件？

三种BuildSpec方式的区别与适用场景 #

1. BuildSpec.fromSourceFileName #

• 核心逻辑：指定CodeBuild从CodePipeline拉取的业务源码仓库中读取buildspec文件
• 适用场景：buildspec与业务代码同仓维护，需随业务代码版本同步更新的场景
• 路径规则：路径为业务源码仓库根目录的相对路径。比如业务仓库根目录下有buildspecs/UnitTestsBuildSpec.yml，直接写'buildspecs/UnitTestsBuildSpec.yml'即可
• 注意：若buildspec仅存于CDK项目本地、未提交到业务源码仓库，该方法会失效，因为CodeBuild无法在拉取的业务源码中找到对应文件

2. BuildSpec.fromObject #

• 核心逻辑：直接在CDK代码中用JS/TS对象定义buildspec的完整内容，无需单独维护yml文件
• 适用场景：构建逻辑简单，不想额外维护独立配置文件；或需要通过CDK动态生成构建步骤（比如根据环境变量调整脚本）
• 用法示例：

import { BuildSpec } from 'aws-cdk-lib/aws-codebuild';

const buildSpec = BuildSpec.fromObject({
  version: '0.2',
  phases: {
    build: {
      commands: [
        'npm install',
        'npm run test'
      ]
    }
  }
});

3. BuildSpec.fromAsset #

• 核心逻辑：将CDK项目本地的buildspec文件作为AWS资产上传至S3，CodeBuild运行时从S3拉取该文件
• 适用场景：buildspec存于CDK项目本地（如你的当前场景），无需与业务代码仓库绑定，或多个流水线复用同一份CDK项目中的buildspec
• 路径规则：路径为CDK项目根目录的相对路径。从你的unit-test-stage.ts文件出发，需写'../../../buildspecs/UnitTestsBuildSpec.yml'（往上三级回到项目根目录，再进入buildspecs文件夹）
• 用法示例：

import { BuildSpec } from 'aws-cdk-lib/aws-codebuild';

const buildSpec = BuildSpec.fromAsset('../../../buildspecs/UnitTestsBuildSpec.yml');

针对你的场景的选型建议 #

你当前将buildspec放在CDK项目根目录的buildspecs文件夹下，需要从不同流水线阶段文件引用，最适合使用BuildSpec.fromAsset：

• 无需将buildspec提交到业务源码仓库，直接复用CDK项目内的文件
• 路径采用当前TS文件到项目根目录的相对路径即可，即你提到的../../../buildspecs/UnitTestsBuildSpec.yml

若后续需要将buildspec与业务代码绑定（比如修改业务代码时同步更新构建逻辑），再切换为fromSourceFileName，此时需确保buildspec已提交到业务源码仓库，路径使用仓库根目录的相对路径。

内容的提问来源于stack exchange，提问作者Prerak Jain