如何在单个文件定义Jenkins Agent标签，简化多Jenkinsfile维护

方法1：使用Jenkins共享库（推荐） #

这是Jenkins官方推荐的批量复用配置的方式，适合长期维护大量Pipeline场景。

• 步骤1：创建一个Git仓库作为共享库（比如命名jenkins-shared-lib），在仓库内新建vars/agentLabels.groovy文件，写入标签变量：

// 统一管理所有Agent标签
def buildAgent() {
    return "new-build-agent-v1" // 这里放最新的构建Agent标签
}

def testAgent() {
    return "test-agent-v2" // 测试Agent标签
}

• 步骤2：在Jenkins系统配置里添加这个共享库（路径：Manage Jenkins → Configure System → Global Pipeline Libraries），设置库名（比如jenkins-shared），关联你的Git仓库，默认分支选main或常用分支。
• 步骤3：在每个Jenkinsfile里引入共享库并调用变量：

@Library('jenkins-shared') _ // 引入共享库

pipeline {
    agent {
        label agentLabels.buildAgent() // 引用共享库中的标签
    }
    stages {
        stage('Build') {
            steps {
                echo "使用Agent: ${agentLabels.buildAgent()}"
            }
        }
    }
}

后续更新Agent标签时，只需要修改agentLabels.groovy里的返回值，提交到Git仓库，所有Jenkinsfile会自动拉取最新配置。

方法2：使用全局配置文件（快速实现） #

如果不想依赖Git仓库，可直接用Jenkins内置的全局文件管理功能：

• 步骤1：进入Jenkins的「Manage Jenkins → Managed files」，点击「Add a new Config」，选择「Custom file」，命名比如agent-labels.properties，写入键值对：

BUILD_AGENT=new-build-agent-v1
TEST_AGENT=test-agent-v2

保存后记住文件的ID（在文件列表中可查看）。

• 步骤2：在Jenkinsfile中加载并读取这个文件：

pipeline {
    agent any
    stages {
        stage('加载Agent标签') {
            steps {
                script {
                    def labelProps = readProperties file: 'agent-labels.properties'
                    env.BUILD_AGENT = labelProps['BUILD_AGENT']
                }
            }
        }
        stage('构建') {
            agent {
                label env.BUILD_AGENT
            }
            steps {
                echo "使用Agent: ${env.BUILD_AGENT}"
            }
        }
    }
}

后续更新时，直接在Jenkins的Managed Files里修改agent-labels.properties即可，无需改动任何Jenkinsfile。

方法3：使用全局环境变量（适合少量标签） #

如果标签数量不多，直接用Jenkins全局变量最省事：

• 步骤1：进入「Manage Jenkins → Configure System → Global properties」，勾选「Environment variables」，添加键值对：
  • 键：BUILD_AGENT，值：new-build-agent-v1
  • 键：TEST_AGENT，值：test-agent-v2
• 步骤2：在Jenkinsfile中直接引用环境变量：

pipeline {
    agent {
        label env.BUILD_AGENT
    }
    stages {
        stage('Build') {
            steps {
                echo "使用Agent: ${env.BUILD_AGENT}"
            }
        }
    }
}

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