在 Debian 上实现 Jenkins 高可用的推荐做法
一、架构选型与前置准备
- 架构选型
- 推荐采用“Active/Passive 控制器 + 多个 Agent”模式：控制器不承载构建，只负责任务调度与界面访问；构建任务在多个 Agent 上执行，提升吞吐与容错。
- 在控制器前放置 HAProxy/Nginx 作为入口，实现健康检查与故障切换；如需横向扩展控制器，可结合 Kubernetes 或 Docker Swarm 做编排与自动恢复。
- 基础环境
- 安装 OpenJDK 11（Jenkins 官方长期支持版本）：sudo apt update && sudo apt install -y openjdk-11-jdk
- 安装 Jenkins LTS（Debian 官方仓库或官方 APT 源均可），并启用开机自启：sudo systemctl enable --now jenkins
- 建议硬件：4 核 CPU + 8GB 内存起步，推荐 8 核 + 16GB；使用 SSD 降低 I/O 瓶颈；所有节点启用 NTP 时间同步。
二、部署步骤
- 安装与初始化
- 安装 Java 与 Jenkins，首次访问 http://:8080，解锁管理员账号，初始密码位于：/var/lib/jenkins/secrets/initialAdminPassword
- 插件建议：安装 Pipeline、GitHub Integration、Blue Ocean 等常用插件，便于流水线开发与可视化。
- 配置控制器高可用
- 准备 2 台控制器（controller-1、controller-2），保持 JENKINS_HOME 一致（如 NFS 共享或块存储快照/克隆），避免切换后作业与配置不一致。
- 在控制器上仅保留“调度与界面”职责，避免运行重型构建；构建任务统一在 Agent 上执行。
- 配置 Agent 与分布式构建
- 进入 Manage Jenkins → Manage Nodes and Clouds → New Node，添加多个 Agent；可通过 SSH 或 JNLP 方式接入，建议使用 SSH 免密或凭据绑定，便于自动化。
- 在 Manage Jenkins → Manage Plugins 安装 SSH Agent、Docker Pipeline 等插件，便于拉取代码与构建镜像。
- 入口负载均衡与健康检查
- 使用 HAProxy 示例（/etc/haproxy/haproxy.cfg）：
- frontend jenkins bind *:8080
default_backend jenkins_servers
- backend jenkins_servers
balance roundrobin
option httpchk GET /login
server controller-1 10.0.0.11:8080 check
server controller-2 10.0.0.12:8080 check
- 使用 Nginx 示例（/etc/nginx/sites-available/default）：
- upstream jenkins { server 10.0.0.11:8080; server 10.0.0.12:8080; }
- server { listen 80; 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; } }
- 健康检查建议：对 /login 或 /whoAmI 做 HTTP 检查，确保仅将流量转发给健康控制器。
三、故障切换与运维要点
- 控制器故障切换
- 采用 Active/Passive 时，通常仅允许 1 台控制器处于 Active 状态；另一台待命。发生故障时，手动或脚本将 HAProxy/Nginx 健康检查指向健康节点，并恢复共享存储的一致性（如 rsync 或快照回滚）。
- 若使用 Kubernetes，可借助 StatefulSet + Readiness/Liveness 探针与 持久卷（PV） 实现自动故障转移与数据持久化。
- 监控与日志
- 部署 Prometheus + Grafana 监控 JVM、HTTP 请求、队列长度、执行器利用率 等关键指标；结合 日志收集（如 ELK）统一分析构建与系统日志。
- 备份与恢复
- 定期备份 JENKINS_HOME（含 jobs/、config.xml、credentials.xml、plugins/ 等），建议每日增量、每周全量；验证备份可恢复性，并记录恢复步骤。
- 性能与稳定性优化
- 调整 JVM 堆大小（如 -Xms/-Xmx），避免 OOM；合理设置 并发构建数 与 执行器数量；清理陈旧工作空间与构建历史；按需启用 缓存（如依赖镜像/本地仓库）。
四、快速验证清单
- 访问入口 http://:8080 可正常登录，页面加载与任务执行无异常。
- 在 Manage Nodes 中查看 Agent 在线，且可调度构建。
- 停止 Active 控制器 后，HAProxy/Nginx 自动将流量切换到 Standby，界面与构建不受影响。
- 恢复故障控制器，确认 JENKINS_HOME 数据一致，切换回 Active 后无作业与配置丢失。
