如何限制Jenkins Pipeline Docker Agent运行在指定Slave节点？

我明白你的问题了——你已经给具备Docker环境的节点打上了dockerserver标签，想让所有使用Docker Agent的stage都跑在这个节点上，但当前的Jenkinsfile里，stage内的Docker Agent配置直接覆盖了全局指定的节点，导致限制失效。这是因为Jenkins Pipeline里，stage级别的agent配置会完全替换全局的agent设置，不会自动继承全局的标签限制。

下面给你两种可行的解决方案，你可以根据自己的场景选择：

方案一：在每个Docker Agent中显式指定节点标签 #

这种方式最直接，就是在每个stage的docker配置块里加上label 'dockerserver'，让Jenkins明确知道要在带有该标签的节点上启动Docker容器。你可以把全局的agent设置为none，这样每个stage的职责更清晰：

pipeline {
    agent none // 全局不指定默认节点，由各stage自行控制
    stages {
        stage('Back-end') {
            agent { 
                docker { 
                    image 'maven:3-alpine'
                    label 'dockerserver' // 强制在dockerserver节点启动容器
                } 
            }
            steps {
                sh 'mvn --version'
            }
        }
        stage('Front-end') {
            agent { 
                docker { 
                    image 'node:7-alpine'
                    label 'dockerserver'
                } 
            }
            steps {
                sh 'node --version'
            }
        }
    }
}

方案二：使用reuseNode参数重用全局节点 #

如果你的流水线需要先在dockerserver节点上执行一些主机层面的操作（比如拉取代码、准备本地资源），然后再在该节点的Docker容器里运行构建任务，那么可以用reuseNode true参数。这样Docker容器会直接在全局指定的dockerserver节点上启动，而不是重新选择其他节点：

pipeline {
    agent { label 'dockerserver' } // 全局锁定到dockerserver节点
    stages {
        stage('Pre-build Setup') {
            steps {
                sh 'echo "在dockerserver节点上执行主机层面的准备工作"'
            }
        }
        stage('Back-end') {
            agent { 
                docker { 
                    image 'maven:3-alpine'
                    reuseNode true // 重用全局指定的dockerserver节点启动容器
                } 
            }
            steps {
                sh 'mvn --version'
            }
        }
        stage('Front-end') {
            agent { 
                docker { 
                    image 'node:7-alpine'
                    reuseNode true
                } 
            }
            steps {
                sh 'node --version'
            }
        }
    }
}

两种方案的区别 #

• 方案一适合每个stage仅需在Docker容器内运行，且完全独立于主机环境的场景，每个容器都会严格在dockerserver节点启动。
• 方案二更适合需要共享主机工作空间的场景，容器和主机节点使用同一个工作目录，方便传递文件。

这样修改后，你的Docker Agent就只会在标记为dockerserver的节点上运行了。

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