求助：GitHub V1源下配置AWS CodePipeline标签创建触发Webhook

1. 修正Webhook的事件过滤规则 #

GitHub V1的Webhook仅勾选Branch or tag creation还不够，必须添加精准的标签过滤条件，否则会因匹配范围不符导致流水线不启动：

• 进入CodePipeline的Webhook配置页，找到「Filter criteria」区域
• 添加两条过滤规则：
  • 第一条：Event type选Tag Create，Filter pattern填入{"ref": ["refs/tags/*"]}
  • 第二条：Event type选Tag Create，Filter pattern填入{"ref_type": ["tag"]}
• 移除所有分支相关的过滤规则，只保留标签类规则

2. 调整CodePipeline源阶段配置 #

确保源阶段明确监听标签而非固定分支：

• 编辑流水线的源阶段，选择GitHub V1源
• 「Branch name」字段不要填固定分支，改为输入refs/tags/*（部分区域控制台支持直接选择标签选项）
• 保存配置，确认源的检测范围覆盖标签

3. 核对GitHub仓库的Webhook事件设置 #

登录GitHub仓库的「Settings → Webhooks」，找到CodePipeline创建的Webhook：

• 「Events」仅勾选Create事件，取消其他所有事件勾选
• 在Create事件的子选项里，只勾选Tag，取消Branch的勾选
• 点击「Update webhook」保存变更

4. 测试触发并排查日志 #

• 本地创建并推送标签：git tag v1.0.0 && git push origin v1.0.0
• 回到CodePipeline的Webhook页，查看「Recent Deliveries」的具体记录，确认Request body里的ref值为refs/tags/v1.0.0、ref_type为tag
• 查看CloudWatch Logs中CodePipeline的日志（路径：/aws/codepipeline/<你的流水线名称>），搜索是否存在源配置不匹配的错误提示

5. CLI创建Webhook的正确命令（控制台配置无效时用） #

用AWS CLI直接创建带精准过滤的Webhook，替换占位符为实际值：

aws codepipeline create-webhook \
  --name TagTriggerWebhook \
  --target-pipeline <你的流水线名称> \
  --target-action <源阶段的动作名称> \
  --filters '[
    {
      "jsonPath": "$.ref",
      "matchEquals": "refs/tags/*"
    },
    {
      "jsonPath": "$.ref_type",
      "matchEquals": "tag"
    }
  ]' \
  --authentication GITHUB_HMAC \
  --authentication-configuration SecretToken=<你的GitHub webhook密钥> \
  --register-with-third-party

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