如何配置GitHub webhook减少触发CircleCI任务的频次？

方案1：基于提交信息关键词触发（最适配1/50触发的需求） #

CircleCI原生支持通过配置文件的规则判断是否触发任务，无需修改webhook配置即可实现关键词触发：

• 打开项目根目录下的.circleci/config.yml，在workflow的触发规则中添加提交信息匹配规则
• 参考配置示例：

workflows:
  version: 2
  run-tests-only-with-keyword:
    jobs:
      - test:
          filters:
            branches:
              only: /.*/
            commit:
              only: /.*\[run-cci\].*/

配置完成后，只有当最新提交信息中包含自定义关键词[run-cci]时，才会触发测试任务，其余推送会直接跳过，不会产生计费次数。
如果需要结合代码变更范围进一步过滤，还可以添加路径过滤规则，示例：

workflows:
  version: 2
  run-tests:
    jobs:
      - test:
          filters:
            commit:
              only: /.*\[run-cci\].*/
            paths:
              only:
                - src/**
                - package.json

只有同时满足提交信息带关键词、且修改了指定路径文件时才会触发任务。

方案2：关闭默认推送触发，仅保留手动触发 #

如果你不需要自动触发，完全可以只保留手动触发能力：

• 进入CircleCI对应项目的Project Settings -> Triggers，关闭默认绑定的GitHub推送触发规则
• 手动触发支持两种方式：
  • 控制台触发：进入CircleCI项目的对应分支页面，点击Trigger Pipeline按钮即可手动发起任务
  • 也可以在GitHub侧配置手动入口：在GitHub仓库的Actions工作流中添加手动触发规则，通过调用CircleCI API发起任务，无需跳转CircleCI平台操作

方案3：调整GitHub webhook触发规则 #

如果不想修改CircleCI配置，也可以直接调整webhook的触发条件：

• 进入GitHub对应仓库的Settings -> Webhooks，找到CircleCI对应的webhook配置
• 修改触发事件，默认配置为Just the push event，你可以根据需求调整为仅在发布Release、打新Tag、或者仅特定分支推送时才触发webhook，比如仅保留main分支的推送触发能力，其余开发分支推送全部不触发。

注意：配置完成后建议先在非主分支测试规则有效性，避免漏触发或误触发影响正常迭代。

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