Jenkinsfile条件执行优化：跳过不符合条件时的Agent启动

我完全懂你的痛点——当Agent不是一直在线时，哪怕步骤最终会被跳过，还要等它启动、拉完代码才跳过，既耗资源又浪费时间。其实只要调整一下agent和when的层级关系就能解决这个问题。

问题根源 #

你之前的写法应该是在步骤（step）级别同时指定agent和when，比如这样：

pipeline {
  agent none
  stages {
    stage('Build') {
      steps {
        script {
          // 其他通用步骤...
        }
        // 这个步骤单独指定Agent和when条件
        node('specific-agent') {
          when {
            branch 'master'
          }
          sh 'echo "Only run on master"'
        }
      }
    }
  }
}

这种情况下，Jenkins会先执行node('specific-agent')启动对应的Agent、完成代码检出，之后才会检查when条件，这就导致了你遇到的资源浪费和等待问题。

解决方案：把agent和when移到Stage级别 #

正确的做法是把需要特定Agent的步骤单独放到一个Stage里，然后在Stage级别同时设置agent和when条件。这样当when条件不满足时，整个Stage都不会被触发，自然也就不会去启动对应的Agent了。

示例代码如下：

pipeline {
  agent none
  stages {
    stage('Regular Universal Steps') {
      agent any
      steps {
        sh 'echo "Run on any agent, execute every time"'
      }
    }
    // 单独封装需要特定Agent的逻辑到这个Stage
    stage('Master-Only Specific Agent Task') {
      // 这里指定目标Agent
      agent { label 'specific-agent' }
      // 这里设置触发条件：仅master分支执行
      when {
        branch 'master'
      }
      steps {
        sh 'echo "Only run on master branch with specific agent"'
        // 其他需要在该Agent上执行的步骤...
      }
    }
  }
}

为什么这样有效？ #

Jenkins Pipeline的执行逻辑是：先检查Stage的when条件，如果条件不满足，整个Stage的所有内容（包括Agent分配、代码检出、步骤执行）都会被直接跳过，不会产生任何资源消耗。这样就完美避免了不必要的Agent启动和等待。

如果你的特定Agent步骤不止一个，只要它们的when条件和Agent要求一致，都可以放到同一个Stage里统一管理。

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