CI/CD / 系统课时

区分 Controller 与 Agent 职责

区分 Controller 与 Agent 职责

Jenkins 能把流水线调度与实际构建拆到不同机器上。理解 Controller 与 Agent 的边界后,就能避免编译、测试等高负载任务挤占 Controller 资源,并为不同项目准备隔离的构建环境。

学习目标

  • 区分 Controller 与 Agent 在流水线中的核心职责
  • 理解任务从调度到 Agent 执行的基本过程
  • 验证流水线实际运行在哪个节点上

Controller 负责管理而不是承担构建负载

Controller 是 Jenkins 的控制中心,主要负责保存系统与任务配置、解析和调度流水线、维护队列、管理 Agent,以及记录构建结果等控制工作。Agent 则提供真正执行构建步骤的工作环境,例如检出代码、运行 Maven、执行测试或构建镜像。

Controller 调度 Agent 执行构建任务的职责关系

如果把大量编译、测试和打包任务长期放在 Controller 上,构建进程可能与 Jenkins 自身争夺 CPU、内存和磁盘 I/O。严重时不仅当前任务变慢,页面响应、任务调度以及其他流水线也可能受到影响。因此实际环境通常让 Controller 专注管理,把工作负载交给 Agent。

流水线如何选择执行位置

Declarative Pipeline 可以在 agent 中指定运行节点。下面的流水线要求 Jenkins 把任务分配给带有 linux-build 标签的 Agent,并打印实际节点名称。

groovy
pipeline {
    agent { label 'linux-build' }

    stages {
        stage('Verify Agent') {
            steps {
                sh 'echo "NODE_NAME=$NODE_NAME"'
                sh 'uname -s'
            }
        }
    }
}

预期输出如下,其中节点名称取决于实际 Jenkins 环境,因此使用 <ID> 表示动态值。

text
NODE_NAME=<ID>
Linux

这里的 pipeline 仍由 Jenkins Controller 管理,但 sh 步骤会在匹配标签并成功分配到的 Agent 工作区中执行。如果没有可用的匹配节点,任务通常会留在队列中等待,而不是自动获得所需的工具链。

用执行位置验证职责边界

判断任务究竟运行在哪里,不应只看 Jenkins 页面上的任务名称。流水线中可以输出 NODE_NAME、工作目录以及操作系统信息,再与节点配置进行核对。

groovy
pipeline {
    agent { label 'linux-build' }

    stages {
        stage('Inspect') {
            steps {
                sh 'echo "node=$NODE_NAME"'
                sh 'echo "workspace=$WORKSPACE"'
            }
        }
    }
}

预期输出中的节点名和路径会随环境变化。

text
node=<ID>
workspace=<PATH>

看到任务位于预期 Agent 只是第一层验证,还应确认该 Agent 拥有构建所需的 JDK、Maven、Docker CLI 或其他工具,并具备正确的文件和网络权限。节点可调度不等于构建环境完整可用。

什么时候需要拆分 Agent

当不同任务需要不同操作系统、JDK 版本、CPU 或内存规格、安全权限以及专用工具链时,应使用不同 Agent 隔离环境。例如 Java 编译可以进入普通 Linux Agent,而需要特殊 SDK 的任务进入另一组节点。

这种分工的核心不是简单增加机器,而是让 Controller 保持稳定的控制职责,让构建负载在明确、可替换且可扩展的执行环境中运行。排查构建问题时,也应先分清问题发生在 Controller 的调度阶段,还是 Agent 的实际执行阶段。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分 Controller 与 Agent 职责

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通