如何通过Shell脚本使Jenkins Freestyle构建成功终止

核心问题原因 #

在Freestyle任务中，exit 0只会结束当前的Shell步骤，不会终止整个构建流程；exit 1会终止构建但标记为失败，不符合需求。

方案一：使用Conditional BuildStep插件（推荐） #

这是最直观的可视化配置方案，无需复杂脚本：

1. 安装Conditional BuildStep插件（Jenkins插件中心直接搜索安装）
2. 构建步骤中先添加「Execute shell」，写入你的变更判断逻辑，将结果存入环境变量或标记文件：

   # 替换为你的实际变更判断逻辑
   CLIENT_CHANGED=$(git diff --name-only HEAD~1 HEAD | grep -E '^client/' | wc -l)
   CLIENT_CHANGED=$([ $CLIENT_CHANGED -eq 0 ] && echo false || echo true)
   # 将结果写入环境变量（需勾选Shell步骤的「Inject environment variables」选项）
   echo "CLIENT_CHANGED=$CLIENT_CHANGED" > $WORKSPACE/env.properties
   

3. 添加「Conditional step (single)」构建步骤：
   • 条件选择「Environment Variable」，变量名填CLIENT_CHANGED，匹配值填false
   • 条件满足时，选择「Stop the build」，并勾选「Mark build as successful」

方案二：Groovy脚本强制终止并标记成功 #

如果不想用插件，可通过Groovy脚本直接操作Jenkins构建状态：

1. 添加「Execute shell」步骤，判断变更并创建标记文件：

   # 替换为你的实际变更判断逻辑
   CLIENT_CHANGED=false
   if [[ $CLIENT_CHANGED == false ]]; then
       touch $WORKSPACE/NO_CLIENT_CHANGES
       exit 0
   fi
   

2. 添加「Execute system Groovy script」步骤，写入以下脚本：

   def workspace = build.getWorkspace()
   def flagFile = workspace.child("NO_CLIENT_CHANGES")
   if (flagFile.exists()) {
       // 标记构建为成功
       build.setResult(hudson.model.Result.SUCCESS)
       // 终止构建执行
       build.getExecutor().interrupt(hudson.model.Result.SUCCESS)
       // 删除临时标记文件
       flagFile.delete()
   }
   

方案三：调整Shell步骤为构建前置条件 #

利用Jenkins的「Execute shell」作为构建的前置条件：

1. 在「Build Environment」区域勾选「Execute shell」
2. 写入判断逻辑，若无需构建则直接终止并标记成功：

   # 替换为你的实际变更判断逻辑
   CLIENT_CHANGED=false
   if [[ $CLIENT_CHANGED == false ]]; then
       echo "No changes in client directory, aborting build as successful"
       # Build Environment中的Shell步骤exit 0会直接终止整个构建并标记成功
       exit 0
   fi
   

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