Jenkins如何在Linux上实现负载均衡

Jenkins在Linux上的负载均衡实现指南

一、总体架构与适用场景

推荐采用外部负载均衡器 + 多实例/主从的组合：用 Nginx/HAProxy 统一暴露 80/443，后端分发到多个 Jenkins Master 或 Master+Slave 节点，实现入口高可用与吞吐提升。
构建任务的实际并行与弹性由 Master-Slave（Agent） 承担；负载均衡器只负责 HTTP 接入与故障转移。
在 Kubernetes 环境中，可用 Service/Ingress 暴露 Master，配合 Kubernetes 插件动态创建 Pod 代理（Agent） 实现弹性伸缩与调度。

二、方案一外部负载均衡器 + 多个Jenkins实例（入门与高可用）

部署多个实例
- 在不同主机或同一主机不同端口部署多个 Jenkins。
- 修改实例端口：
  - Debian/Ubuntu：编辑 /etc/default/jenkins，设置 JENKINS_PORT=“8080/8081”。
  - CentOS/RHEL：编辑 /etc/sysconfig/jenkins，设置 JENKINS_PORT=“8080/8081”。
- 启动服务：sudo systemctl restart jenkins。

配置 Nginx 作为负载均衡器

安装：sudo apt-get install nginx（Debian/Ubuntu）或 yum install nginx（CentOS/RHEL）。

配置示例（/etc/nginx/sites-available/default 或 /etc/nginx/nginx.conf）：

upstream jenkins {
    server 192.168.1.11:8080;
    server 192.168.1.12:8081;
    # 可按需增加权重、max_fails、fail_timeout 等
}
server {
    listen 80;
    server_name yourdomain.com;
    location / {
        proxy_pass http://jenkins;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

启用：sudo systemctl restart nginx && sudo systemctl enable nginx。

配置 HAProxy 作为负载均衡器
- 安装：sudo apt-get install haproxy 或 yum install haproxy。
- 配置示例（/etc/haproxy/haproxy.cfg）：
```
frontend jenkins_front
    bind *:80
    default_backend jenkins_back

backend jenkins_back
    balance roundrobin
    server jenkins1 192.168.1.11:8080 check
    server jenkins2 192.168.1.12:8081 check
```
- 启用：sudo systemctl restart haproxy && sudo systemctl enable haproxy。
可选启用 HTTPS
- 使用 Certbot：sudo apt-get install certbot python3-certbot-nginx
- 获取并安装证书：sudo certbot --nginx -d yourdomain.com（自动修改 Nginx 配置启用 SSL/TLS）。

三、方案二 Master-Slave 分布式构建（提升构建并发）

在 Master 添加 Agent（Linux 节点）
- 准备：各节点安装 JDK，创建 Jenkins 工作目录（如 /data/jenkinsworkspace），确保 Master 可 SSH 登录到 Agent。
- Master 控制台：Manage Jenkins → Manage Nodes and Clouds → New Node，类型选 Permanent Agent，填写：
  - Name/Labels（如：linux、docker）
  - Remote root directory（如：/data/jenkinsworkspace）
  - Number of executors（建议与 CPU 线程数匹配）
  - Launch method：常用 Launch agent via SSH
    - 凭据：选择 SSH Username with private key，填入私钥；首次连接按提示 Trust SSH Host Key。
- 保存后启动 Agent，状态显示 Connected 即成功。
运行与调度
- 在 Job 配置中使用 Restrict where this project can be run 或 agent { label ‘linux’ } 将任务调度到指定标签的 Agent。
- 通过增加 Agent 数量 与合理设置 executors，提升并发构建能力。

四、方案三 Kubernetes 上的弹性负载均衡（进阶）

暴露 Master
- 创建 Service（示例）：
```
apiVersion: v1
kind: Service
metadata:
  name: jenkins
  namespace: jenkins
spec:
  selector:
    app: jenkins
  ports:
    - port: 8080
      targetPort: 8080
```
- 应用：kubectl apply -f jenkins-service.yaml
- 获取初始密码：kubectl exec -it $(kubectl get pod -n jenkins -l app=jenkins -o jsonpath='{.items[0].metadata.name}') -n jenkins cat /var/jenkins_home/secrets/initialAdminPassword
动态 Agent
- 在 Master 安装 Kubernetes 插件，配置 Kubernetes Cloud，定义 Pod 模板（容器镜像、JDK、Maven/Git 等工具）。
- 运行 Pipeline 时，按需自动创建 Agent Pod，任务结束自动回收，实现弹性伸缩与资源隔离。

五、关键注意事项与最佳实践

会话粘滞与 CSRF
- 建议开启 Sticky Session（如 Nginx ip_hash 或 HAProxy stick-table）以避免表单提交与 WebSockets 会话中断；同时启用 CSRF 保护 与 安全代理头（已在示例中包含 X-Real-IP/X-Forwarded-For/X-Forwarded-Proto）。
健康检查与故障转移
- 为后端配置 HTTP 健康检查 与 失败重试/超时，确保异常节点自动摘除；必要时为关键路径配置 主动/被动备机。
数据与一致性
- 多 Master 场景需统一 JENKINS_HOME 存储（如 NFS、块存储或对象存储）并谨慎处理 Jenkins 配置与插件 的一致性；更推荐 Active-Passive 高可用而非多 Master 写并发。
安全加固
- 仅暴露 80/443，禁用实例直连；使用 强认证、RBAC、代理白名单 与 审计日志；证书采用 Let’s Encrypt 或企业 CA 签发并自动续期。
监控与容量规划
- 监控 CPU/内存/磁盘 IO/网络、构建队列长度 与 Agent 利用率；按峰值与增长趋势规划 实例数 与 executors，避免资源争用。

最新问答

相关标签