AWS CDK Pipelines无法自动触发：Git Push后无法拉取仓库EVENTS

问题描述 #

向CodeCommit仓库的dev分支推送代码后，无法自动触发CodePipeline，但手动点击“Release Change”可以正常启动流水线。CDK配置的源阶段代码如下：

this.codePipeline.addStage({
  stageName: "Source",
  actions: [
    new CodeCommitSourceAction({
      actionName: 'Source',
      repository: this.codeRepository,
      branch: context.branchName,
      codeBuildCloneOutput: true,
      runOrder: 1,
      output: sourceOutput,
      trigger: CodeCommitTrigger.EVENTS,
    })
  ]
});

核心原因分析 #

手动触发正常说明流水线执行逻辑无问题，故障点集中在EVENTS模式的触发器配置链——即CloudWatch Events捕获CodeCommit推送事件、触发CodePipeline的环节出现异常。

排查与解决步骤 #

• 检查CloudWatch Events规则
  确认是否存在CDK自动创建的事件规则：该规则需监听目标CodeCommit仓库的dev分支推送事件（事件类型为CodeCommit Repository State Change，事件细节匹配分支推送动作），并将目标设置为当前CodePipeline。若规则不存在，重新部署CDK栈确保资源生成；若规则存在，校验事件模式是否准确匹配dev分支。

• 验证IAM权限
  检查CloudWatch Events关联的执行角色是否具备codepipeline:StartPipelineExecution权限，且资源范围包含目标流水线的ARN。CDK通常会自动配置该权限，但如果存在自定义权限策略，需确认未遗漏该动作。

• 确认分支配置准确性
  校验context.branchName变量的实际值是否为dev，避免因变量配置错误导致触发器监听了错误分支。可通过CDK部署后的CodePipeline源动作配置页面，查看实际监听的分支是否正确。

• 检查事件捕获状态
  前往CloudWatch事件总线，查看是否有CodeCommit仓库的推送事件被捕获。若没有事件进入，说明事件源配置存在问题，需确认CodeCommit仓库的事件能正常流向CloudWatch Events。

相关配置说明 #

• CodeCommitTrigger.EVENTS
  该触发模式依赖CloudWatch Events捕获CodeCommit仓库的分支推送事件，当指定分支有代码推送操作时，自动触发CodePipeline执行。此模式要求CloudWatch Events具备对应的规则和权限来完成事件转发。

• CodeCommitSourceAction
  这是CodePipeline中用于从CodeCommit仓库拉取代码的源动作组件，支持三种触发模式：手动触发、定时轮询、事件触发（EVENTS）。配置时需指定目标仓库、监听分支、输出工件等参数，触发模式决定了流水线的启动时机。

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