单Agent环境下Jenkins Pipeline执行挂起问题咨询

核心问题分析 #

你当前的配置每个阶段都单独指定agent {label 'agent1'}，这会让Jenkins为每个阶段重新申请agent1的执行器，再加上主节点（Jenkins Server）的执行器被Pipeline的控制逻辑占用，就容易出现调度阻塞。而且这种方式哪怕用同一个label，也无法保证三个阶段在同一个agent实例的同一工作空间执行（虽然你只有一个agent，但Jenkins的逻辑是每个stage独立分配）。

正确配置方案 #

直接在根级pipeline块指定agent，让整个Pipeline的所有阶段都绑定到同一个agent1执行，这样三个阶段会自动按顺序在同一个agent的同一工作空间运行，不需要每个stage重复指定agent：

pipeline {
    agent {label 'agent1'} // 根级指定，整个Pipeline都在agent1上执行
    options {
        copyArtifactPermission(...)
    }
    
    stages {
        stage('BuildStage') {
            steps {
                build([...]) // 注意：如果这里是触发其他Job的build，需确保参数正确；如果是当前Pipeline的构建步骤，直接写具体命令即可
            }
        }
        stage('Copy artifacts') {
            steps {
                copyArtifacts ... // 若复制的是当前Pipeline BuildStage的产物，因共享同一工作空间，可直接用文件路径访问，无需copyArtifacts
            }
        }
        stage('Integration Test') {
            steps {
                build([...]) // 执行集成测试相关步骤
            }
        }
    }
}

关键疑问解答 #

• 无需强制主节点执行Pipeline：根级指定agent后，Pipeline的控制逻辑和所有阶段步骤都会在agent1上运行，主节点仅负责调度，不会被过度占用。
• 禁止使用wait:false：该参数会让build步骤异步执行，直接打破三个阶段的顺序性，完全不符合你的需求。
• 执行器数量的作用：你将agent1的执行器设为2，是允许该agent同时运行两个独立任务，但你的场景是同一任务的三个阶段顺序执行，单执行器即可满足，设置2仅为不影响其他任务调度。

Jenkins与TeamCity的逻辑差异 #

TeamCity默认会将整个构建流程绑定到单个agent实例，而Jenkins Pipeline的stage级agent配置会让每个阶段独立分配节点（哪怕是同label的agent）。若要实现类似TeamCity的“全流程绑定同一agent”，必须在根级指定agent，而非每个stage单独设置。

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