Jenkins流水线因Git推送版本文件触发递归运行的解决方案咨询

针对版本文件推送触发流水线循环运行的问题，可按改造量从低到高选择以下方案：

最易落地：提交信息添加CI跳过标记 #

当前主流Git服务与对应的Jenkins webhook插件，都原生支持识别提交信息中的CI跳过关键词，只要提交携带这类标记，对应推送就不会触发后续流水线。
仅需要调整原有提交步骤的代码即可，将原提交命令：

sh 'git commit -am "update version"'

修改为：

sh 'git commit -am "update version [skip ci]"'

通用兼容的跳过标记包括[skip ci]、[ci skip]，绝大多数Git服务与Jenkins插件都可正常识别，无需额外调整服务配置。

无业务代码改动：Jenkins侧配置触发过滤 #

如果团队规范不允许在正式提交信息中添加特殊标记，可以直接在Jenkins的流水线触发规则层做拦截：

• 配置触发排除规则，过滤掉当前自动化流程使用的提交账号（也就是脚本中配置的GITHUB_APP用户），只要推送的提交来自这个账号，就不启动流水线
• 也可以配置提交信息匹配规则，只要触发来源的提交包含固定的update version关键词，就直接跳过流水线启动
  这个方案不需要修改流水线业务代码，仅在Jenkins的触发器配置页面调整规则即可生效。

根源解决：取消不必要的仓库推送 #

如果业务没有强制要求将version.json持久化存储到代码仓库，可以彻底移除推送提交的步骤：

• 流水线拉取代码完成后、启动正式构建前，在工作区动态生成version.json文件，写入计算好的next_tag版本号，后续构建步骤直接使用这个临时生成的文件，全程不向远程仓库推送提交，从根源上避免递归触发。
• 如果确实需要持久化版本号，可以调整执行逻辑：将版本文件更新、提交的动作和新标签推送流程绑定，仅当流水线收到新标签的触发事件时，才执行版本文件更新操作，不在master分支的常规触发流程中执行推送。

兜底防护：流水线入口添加前置拦截 #

就算推送的提交意外触发了新的流水线，也可以在流水线最开头增加判断逻辑：如果识别到当前触发的提交是自动化版本更新提交，就直接终止流水线运行，不会重复执行版本更新步骤，从逻辑上阻断死循环路径。

内容的提问来源于stack exchange，提问作者Abo-Mahmoud Al-Homsi