# Jenkins Pipeline 指定节点执行的三种方式详解 在 Jenkins Pipeline 中，指定节点执行是确保构建任务在特定环境上运行的关键。下面我将详细介绍三种主要的节点指定方式，并通过实际示例进行说明。 ## 1. 声明式 Pipeline 使用 agent 标签 ### 基本语法 声明式 Pipeline 通过在 `agent` 指令中指定标签来选择执行节点，这是最常用且推荐的方式 [ref_1]。 ```groovy pipeline { agent { label "master" } stages { stage('Build') { steps { echo "在 master 节点上执行构建" sh 'mvn clean compile' } } } } ``` ### 高级用法 声明式 Pipeline 支持更复杂的节点配置： ```groovy pipeline { agent { node { label 'linux-slave' customWorkspace '/opt/jenkins/workspace' } } stages { stage('Test') { steps { echo "在指定的 Linux 节点上执行测试" sh 'mvn test' } } } } ``` ## 2. 脚本式 Pipeline 使用 node 语法 ### 基本用法 脚本式 Pipeline 通过 `node` 闭包来指定执行节点，语法更加灵活 [ref_1]。 ```groovy node("master") { stage('Build') { echo "在 master 节点上构建" sh 'make build' } stage('Test') { echo "在 master 节点上测试" sh 'make test' } } ``` ### 多节点并行执行 脚本式 Pipeline 可以轻松实现多节点并行任务： ```groovy stage('Parallel Build') { parallel ( 'windows-build': { node("windows-slave") { echo "在 Windows 节点上构建" bat 'msbuild solution.sln' } }, 'linux-build': { node("linux-slave") { echo "在 Linux 节点上构建" sh 'make all' } } ) } ``` ## 3. 动态节点选择 ### 基于条件的节点选择 可以根据构建参数或环境变量动态选择节点： ```groovy pipeline { agent { node { label "${params.BUILD_NODE}" } } parameters { choice( name: 'BUILD_NODE', choices: ['master', 'linux-slave', 'windows-slave'], description: '选择构建节点' ) } stages { stage('Dynamic Build') { steps { echo "在 ${params.BUILD_NODE} 节点上执行构建" } } } } ``` ### 基于文件存在的节点选择 使用脚本根据特定条件选择节点： ```groovy pipeline { agent any stages { stage('Conditional Node Selection') { steps { script { def availableNodes = ['master', 'node1', 'node2'] def selectedNode = availableNodes.find { nodeName -> node(nodeName) { return fileExists('required-tool.txt') } } node(selectedNode ?: 'master') { echo "在 ${selectedNode ?: 'master'} 节点上执行" sh './build-script.sh' } } } } } } ``` ## 三种方式对比 | 方式 | 适用场景 | 优点 | 缺点 | 语法类型 | |------|----------|------|------|----------| | agent 标签 | 声明式 Pipeline | 语法简洁，易于维护 | 灵活性相对较低 | 声明式 | | node 语法 | 脚本式 Pipeline | 高度灵活，支持复杂逻辑 | 语法相对复杂 | 脚本式 | | 动态选择 | 需要运行时决策 | 适应性强，智能调度 | 实现复杂度高 | 混合式 | ## 实际应用示例 ### 多环境部署 Pipeline 下面是一个结合三种方式的实际应用示例： ```groovy pipeline { agent any parameters { choice( name: 'DEPLOY_ENV', choices: ['dev', 'test', 'prod'], description: '选择部署环境' ) } stages { stage('Build') { agent { label "build-node" } steps { echo "在专用构建节点上编译" sh 'mvn clean package -DskipTests' stash name: 'artifacts', includes: 'target/*.jar' } } stage('Test') { parallel { stage('Unit Test') { agent { label "test-node-1" } steps { unstash 'artifacts' sh 'mvn test' } } stage('Integration Test') { agent { label "test-node-2" } steps { unstash 'artifacts' sh 'mvn verify -Pintegration' } } } } stage('Deploy') { steps { script { def deployNode = params.DEPLOY_ENV == 'prod' ? 'prod-node' : 'dev-node' node(deployNode) { unstash 'artifacts' echo "在 ${deployNode} 上部署到 ${params.DEPLOY_ENV} 环境" sh "./deploy.sh ${params.DEPLOY_ENV}" } } } } } } ``` ## 节点管理配置 要使用这些节点指定方式，首先需要在 Jenkins 中配置节点。通过 **Manage Jenkins → Manage Nodes and Clouds** 可以查看和管理所有可用节点 [ref_1]。每个节点都有唯一的标签，可以在 Pipeline 中通过这些标签进行引用。 ### 节点标签最佳实践 - 使用描述性标签：`linux-amd64`, `windows-build`, `docker-enabled` - 按功能分类：`build`, `test`, `deploy` - 按环境分类：`dev`, `staging`, `prod` 通过合理使用这三种节点指定方式，可以构建出高效、灵活且易于维护的 Jenkins Pipeline，满足不同场景下的构建和部署需求。