Jenkins 架构：Master/Agent 详解

Jenkins 采用经典的 Master/Agent（主节点/工作节点）分布式架构。这种设计将控制平面与执行平面分离，使得 Jenkins 能够横向扩展，承载大规模、异构的 CI/CD 任务。理解 Master 与 Agent 的职责划分及通信机制，是高效运维 Jenkins 集群的基础。

1. Master 与 Agent 的职责边界

Master 节点是 Jenkins 的控制中枢，负责管理整个系统的状态、调度任务、存储配置与构建产物。Agent 节点是实际执行构建任务的“工人”，接收 Master 下发的指令并运行 Pipeline 或 Job。

2. Master/Agent 通信机制

Master 与 Agent 之间通过 TCP/IP 协议进行双向通信。Jenkins 使用自定义的 Remoting 协议（基于 Java RMI 和 NIO）来传输命令、文件和控制流。通信链路始终由 Agent 主动发起，Master 监听并响应。

2.1 连接建立方式

• JNLP（Java Web Start）方式： Agent 通过一个 JNLP 文件获取 Master 的地址和端口，然后建立 TCP 连接。适用于动态 Agent（如 Kubernetes Pod、Docker 容器）。
• SSH 方式： Master 通过 SSH 协议连接到 Agent 节点，并在远程启动 Agent 进程。适用于固定 IP 的虚拟机或物理机。
• Windows 服务方式： Agent 以 Windows 服务形式运行，通过 JNLP 或自定义端口与 Master 通信。

2.2 通信协议栈

Remoting 协议栈分为三层：

1. 传输层： 基于 TCP Socket，默认端口 50000（可配置）。
2. 协议层： 使用 Command / Response 模式，序列化 Java 对象进行交互。
3. 应用层： 传递 Pipeline 步骤、文件传输、日志流、环境变量等业务数据。

3. Master/Agent 架构示意图

下图展示了 Jenkins 分布式架构的核心组件与通信流向：

4. Agent 的启动与注册流程

一个 Agent 从启动到就绪，经历以下关键步骤：

1. 获取连接信息： Agent 通过 JNLP 文件或 SSH 配置获取 Master 的 IP 和端口。
2. 建立 TCP 连接： Agent 向 Master 的 50000 端口发起 Socket 连接。
3. 握手与认证： 交换 Secret（密钥），验证 Agent 身份是否在 Master 的白名单中。
4. 资源协商： Agent 上报自身标签（Label）、执行器数量、系统属性（OS、工具路径）。
5. 进入空闲状态： Master 将 Agent 标记为“在线”，等待 Job 调度。

5. 执行器与任务分配

每个 Agent 可以配置多个 执行器（Executor），即并行执行构建任务的“槽位”。Master 根据以下策略将 Job 分配给 Agent：

• 标签匹配： Job 通过 label 指令指定目标 Agent（如 agent { label 'linux && docker' }）。
• 负载均衡： 当多个 Agent 满足标签条件时，Master 优先选择空闲执行器最多的 Agent。
• 任务队列： 如果所有匹配 Agent 的执行器都被占用，Job 进入等待队列，直到有执行器释放。

6. 高可用与扩展建议

基于 Master/Agent 架构，Jenkins 集群的扩展策略如下：

• 水平扩展 Agent： 使用 Kubernetes 插件或 Docker 插件动态创建 Agent，按需伸缩，节省资源。
• Master 高可用： 通过外部数据库（如 MySQL/PostgreSQL）和共享存储（如 NFS）实现 Master 冷备或主从切换。
• 网络隔离： 将 Agent 部署在不同网络区域（如开发网、测试网、生产网），通过 Master 统一调度，避免跨网段直接暴露。