CI/CD / 系统课时
区分 Controller 与 Agent 职责
区分 Controller 与 Agent 职责
Jenkins 能把流水线调度与实际构建拆到不同机器上。理解 Controller 与 Agent 的边界后,就能避免编译、测试等高负载任务挤占 Controller 资源,并为不同项目准备隔离的构建环境。
学习目标
- 区分 Controller 与 Agent 在流水线中的核心职责
- 理解任务从调度到 Agent 执行的基本过程
- 验证流水线实际运行在哪个节点上
Controller 负责管理而不是承担构建负载
Controller 是 Jenkins 的控制中心,主要负责保存系统与任务配置、解析和调度流水线、维护队列、管理 Agent,以及记录构建结果等控制工作。Agent 则提供真正执行构建步骤的工作环境,例如检出代码、运行 Maven、执行测试或构建镜像。

如果把大量编译、测试和打包任务长期放在 Controller 上,构建进程可能与 Jenkins 自身争夺 CPU、内存和磁盘 I/O。严重时不仅当前任务变慢,页面响应、任务调度以及其他流水线也可能受到影响。因此实际环境通常让 Controller 专注管理,把工作负载交给 Agent。
流水线如何选择执行位置
Declarative Pipeline 可以在 agent 中指定运行节点。下面的流水线要求 Jenkins 把任务分配给带有 linux-build 标签的 Agent,并打印实际节点名称。
pipeline {
agent { label 'linux-build' }
stages {
stage('Verify Agent') {
steps {
sh 'echo "NODE_NAME=$NODE_NAME"'
sh 'uname -s'
}
}
}
}预期输出如下,其中节点名称取决于实际 Jenkins 环境,因此使用 <ID> 表示动态值。
NODE_NAME=<ID>
Linux这里的 pipeline 仍由 Jenkins Controller 管理,但 sh 步骤会在匹配标签并成功分配到的 Agent 工作区中执行。如果没有可用的匹配节点,任务通常会留在队列中等待,而不是自动获得所需的工具链。
用执行位置验证职责边界
判断任务究竟运行在哪里,不应只看 Jenkins 页面上的任务名称。流水线中可以输出 NODE_NAME、工作目录以及操作系统信息,再与节点配置进行核对。
pipeline {
agent { label 'linux-build' }
stages {
stage('Inspect') {
steps {
sh 'echo "node=$NODE_NAME"'
sh 'echo "workspace=$WORKSPACE"'
}
}
}
}预期输出中的节点名和路径会随环境变化。
node=<ID>
workspace=<PATH>看到任务位于预期 Agent 只是第一层验证,还应确认该 Agent 拥有构建所需的 JDK、Maven、Docker CLI 或其他工具,并具备正确的文件和网络权限。节点可调度不等于构建环境完整可用。
什么时候需要拆分 Agent
当不同任务需要不同操作系统、JDK 版本、CPU 或内存规格、安全权限以及专用工具链时,应使用不同 Agent 隔离环境。例如 Java 编译可以进入普通 Linux Agent,而需要特殊 SDK 的任务进入另一组节点。
这种分工的核心不是简单增加机器,而是让 Controller 保持稳定的控制职责,让构建负载在明确、可替换且可扩展的执行环境中运行。排查构建问题时,也应先分清问题发生在 Controller 的调度阶段,还是 Agent 的实际执行阶段。