CI/CD / 系统课时
给构建节点设置标签规则
给构建节点设置标签规则
同一套 Jenkins 往往同时连接 Linux、Windows 或安装不同工具链的 Agent。节点标签的作用是描述构建能力,让流水线按需求选择执行环境,而不是依赖某台机器的名称进行硬编码。
学习目标
- 理解 Jenkins 节点 label 与节点名称的区别
- 为操作系统、工具链和特殊能力设计可维护的标签
- 在 Pipeline 中使用标签表达式并验证调度结果
标签应该描述节点能力
假设有三类 Agent:普通 Linux 构建节点、带 JDK 21 的 Linux 节点,以及 Windows 节点。与其让流水线直接绑定 agent-01,更适合给节点设置 linux、jdk21、windows 等标签,再由任务声明自己需要什么能力。

标签可以组合。一个节点可以同时拥有 linux、jdk21、docker 等多个标签,因此同一 Agent 能被不同条件的任务匹配。设计标签时应优先表达稳定能力,而不是把临时机器编号当成业务规则。
在节点上配置标签
节点标签通常在 Jenkins 的节点配置中填写。若需要通过界面操作,应在实际 Jenkins 实例中进入目标节点的配置页面确认 Labels 字段;不同 Jenkins 版本和权限配置下导航文字可能存在差异,因此不伪造固定界面位置。

例如某个 Agent 安装了 Linux、JDK 21 和 Docker,可以为它设置三个独立标签:linux、jdk21、docker。任务随后按真正需要的能力组合条件,而不必知道节点名称。
在 Pipeline 中匹配标签
只需要 JDK 21 Linux 环境时,可以使用标签表达式同时约束两项能力。
pipeline {
agent { label 'linux && jdk21' }
stages {
stage('Verify Environment') {
steps {
sh 'echo "NODE_NAME=$NODE_NAME"'
sh 'java -version'
}
}
}
}预期输出会包含实际 Agent 名称和该节点安装的 Java 版本。具体补丁版本可能不同,因此以下只保留需要验证的关键信息。
NODE_NAME=<ID>
openjdk version "21..."linux && jdk21 表示节点必须同时具备两个标签。如果没有符合条件且在线、可执行任务的 Agent,流水线会等待可用执行器。此时首先检查标签拼写、节点在线状态和执行器占用情况,而不是修改构建脚本绕过调度规则。
避免把标签写成机器清单
标签规则应尽量稳定。例如 linux、jdk21、docker 描述的是能力,即使底层 Agent 被替换,流水线仍可继续匹配新的节点。类似 server-a、vm-03 的名称更接近机器身份,会让流水线与基础设施实例产生不必要的耦合。
当多个项目共享 Agent 时,可以先用少量正交标签描述操作系统、运行时和特殊能力,再在 Pipeline 中组合表达需求。这样新增或替换 Agent 时主要调整节点标签,而不需要逐条修改依赖具体机器名称的流水线。