Jenkins主从架构

Jenkins主从架构

Jenkins主从架构（Master-Agent Architecture）是Jenkins实现分布式构建的核心机制，通过将任务分配到多个节点执行，显著提升资源利用率和构建效率。本指南将系统讲解其原理、配置方法及实际应用场景。

核心概念

Jenkins主从架构由两类节点组成：

• 主节点（Master）：负责管理任务调度、用户界面、插件和全局配置。
• 从节点（Agent/Slave）：执行具体的构建任务，可以是物理机、虚拟机或容器。

graph LR A[Master] -->|分配任务| B[Agent 1] A -->|分配任务| C[Agent 2] A -->|分配任务| D[Agent 3]

优势

• 横向扩展：通过添加从节点应对高负载场景。
• 环境隔离：不同从节点可配置不同操作系统或工具链（如Windows/Linux/macOS）。
• 资源优化：将计算密集型任务分散到多台机器。

配置主从架构

1. 从节点连接方式

Jenkins支持多种Agent连接协议：

• SSH（推荐）：通过SSH密钥认证。
• JNLP：适用于动态环境（如Kubernetes）。
• Windows服务：Windows专用。

SSH配置示例

  
# 在从节点生成SSH密钥  
ssh-keygen -t rsa -b 4096  
# 将公钥添加到主节点的 ~/.ssh/authorized_keys  
cat ~/.ssh/id_rsa.pub | ssh jenkins@master "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

2. 添加从节点

1. 进入 Manage Jenkins → Manage Nodes and Clouds 2. 点击 New Node，输入节点名称并选择 Permanent Agent 3. 配置关键参数：

  * Remote root directory：从节点的工作目录（如 /home/jenkins/agent）  
  * Launch method：选择连接方式（如SSH）  
  * Labels：定义节点标签（如 linux,docker）  

3. 任务绑定从节点

在Pipeline或Freestyle项目中，通过标签指定运行节点：

  
pipeline {  
    agent { label 'docker' }  // 仅在含'docker'标签的节点运行  
    stages {  
        stage('Build') {  
            steps {  
                sh 'docker build -t myapp .'  
            }  
        }  
    }  
}

实际案例

场景：多平台构建

• 需求：需在Linux编译C++程序，同时在Windows打包安装包。
• 解决方案：

 1. 配置两个从节点，分别标记为 linux-gcc 和 windows-msbuild。  
 2. 使用并行Pipeline分发任务：  

  
pipeline {  
    stages {  
        stage('Build') {  
            parallel {  
                stage('Linux Build') {  
                    agent { label 'linux-gcc' }  
                    steps { sh 'make all' }  
                }  
                stage('Windows Package') {  
                    agent { label 'windows-msbuild' }  
                    steps { bat 'msbuild /p:Configuration=Release' }  
                }  
            }  
        }  
    }  
}

性能调优

从节点数量与任务吞吐量的关系可通过以下公式估算： $T=\frac{N\times t}{k}$ 其中：

• $T$：总构建时间
• $N$：任务数量
• $t$：单任务平均耗时
• $k$：并行从节点数

常见问题

• 连接失败：检查SSH/JNLP端口是否开放，防火墙规则是否正确。
• 资源争用：通过 lock 步骤限制并发任务数：

  
lock(resource: 'database', inversePrecedence: true) {  
    // 仅允许一个任务访问数据库  
}

总结

Jenkins主从架构是应对大规模CI/CD需求的基石。通过合理规划节点角色和标签策略，可实现高效的分布式构建，适应异构环境下的复杂自动化流程。