如何修改AWS CDK Pipeline默认构建阶段？解决UpdatePipeline阶段目录错误导致的部署失败

针对你遇到的问题，我先确认你的推测是正确的：UpdatePipeline阶段确实没有进入指定的subfolder，而是在仓库根目录执行CDK命令，导致找不到对应文件报错。下面逐一解答你的疑问，并给出具体解决方案：

1. 该Buildspec是否为CDK默认生成的构建动作？ #

是的，这个Buildspec是AWS CDK Pipeline自动生成的自更新（Self-Mutation）步骤配置。CDK Pipeline默认开启自更新能力，目的是让Pipeline能够自动更新自身的CloudFormation栈（也就是你用Python编写的Pipeline_test栈），确保Pipeline的定义始终和你的CDK代码保持同步。

2. 如何修改UpdatePipeline阶段，使其添加"cd subfolder"命令？ #

你需要自定义自更新步骤的行为，替代CDK默认生成的Buildspec。具体来说，可以通过创建自定义CodeBuildStep来替换默认的自更新逻辑，在其中加入cd subfolder命令，同时配置匹配你Pipeline代码的运行环境（比如你的Pipeline是Python编写的，就需要用Python环境，而非默认的Node环境）。

示例代码（自定义自更新步骤） #

from aws_cdk import Construct, aws_codecommit as codecommit, aws_codebuild as codebuild
from aws_cdk.pipelines import CodePipeline, CodePipelineSource, ShellStep, CodeBuildStep, Stage

def __init__(self, scope: Construct, construct_id: str, **kwargs) -> None:
    super().__init__(scope, construct_id, **kwargs)
    repo = codecommit.Repository.from_repository_name(self, "my-3tier-app", repository_name="my-3tier-app" )

    # 自定义自更新步骤：进入subfolder并执行Pipeline栈部署命令
    self_mutation_step = CodeBuildStep("SelfMutate",
        commands=[
            "cd subfolder",
            # 如果你的Pipeline是Python编写的，执行以下命令
            "pip install -r requirements.txt",
            "cdk deploy PipelineStack --require-approval=never --verbose"
            # 如果你的Pipeline是TypeScript编写的，替换为下面两行
            # "npm install",
            # "npx cdk deploy PipelineStack --require-approval=never --verbose"
        ],
        build_environment=codebuild.BuildEnvironment(
            # 根据语言选择镜像：Python用STANDARD_7_0，Node也可以用该镜像或指定Node专属镜像
            build_image=codebuild.LinuxBuildImage.STANDARD_7_0
        ),
        input=CodePipelineSource.code_commit(repo, "main")
    )

    # 创建Pipeline，禁用默认自更新，改用自定义步骤
    pipeline = CodePipeline(self, "Pipeline_test",
        pipeline_name="my-3tier-app-pipeline",
        synth=ShellStep("Synth",
            input=CodePipelineSource.code_commit(repo, "main"),
            commands=[
                "cd subfolder",
                "npm install",
                "npx cdk synth"
            ],
            primary_output_directory="subfolder"
        ),
        self_mutation=False,  # 禁用默认自更新逻辑
    )

    # 添加自定义的自更新阶段到Pipeline
    pipeline.add_stage(Stage(self, "UpdatePipeline", steps=[self_mutation_step]))

3. 或者是否可以全局定义子目录，避免多次添加"cd"命令？ #

当然可以，有两种简洁的方式实现：

方式1：设置Step的working_directory属性 #

无论是ShellStep还是CodeBuildStep，都支持通过working_directory指定全局工作目录，所有命令都会自动在该目录下执行，无需重复写cd subfolder。

修改Synth步骤示例：

synth=ShellStep("Synth",
    input=CodePipelineSource.code_commit(repo, "main"),
    commands=[
        "npm install",
        "npx cdk synth"
    ],
    primary_output_directory="subfolder",
    working_directory="subfolder"  # 全局指定工作目录
)

自定义自更新步骤示例：

self_mutation_step = CodeBuildStep("SelfMutate",
    commands=[
        # 无需再写cd subfolder，直接执行命令
        "pip install -r requirements.txt",
        "cdk deploy PipelineStack --require-approval=never --verbose"
    ],
    working_directory="subfolder",
    build_environment=codebuild.BuildEnvironment(
        build_image=codebuild.LinuxBuildImage.STANDARD_7_0
    ),
    input=CodePipelineSource.code_commit(repo, "main")
)

方式2：在自定义Buildspec中指定工作目录 #

如果需要更精细的控制，可以在自定义CodeBuild步骤的Buildspec里设置working_directory：

self_mutation_step = CodeBuildStep("SelfMutate",
    build_spec=codebuild.BuildSpec.from_object({
        "version": "0.2",
        "working_directory": "subfolder",
        "phases": {
            "install": {
                "commands": ["pip install -r requirements.txt"]
            },
            "build": {
                "commands": ["cdk deploy PipelineStack --require-approval=never --verbose"]
            }
        }
    }),
    input=CodePipelineSource.code_commit(repo, "main")
)

额外注意事项 #

你的场景中，Pipeline用Python编写、应用CDK用TypeScript编写，需要特别注意自更新步骤的运行环境：

• 如果自更新是部署Python编写的Pipeline栈，必须使用Python环境（安装pip依赖），不能用默认的Node环境，否则会调用Node版本的CDK命令导致错误。
• 确保你的Pipeline代码（Python）和应用代码（TypeScript）都在同一个CodeCommit仓库中，否则自更新步骤会找不到Pipeline栈的定义代码。

内容的提问来源于stack exchange，提问作者0r4cl3