怎样在Debian上搭建多节点Jenkins集群 - 问答

在 Debian 上搭建多节点 Jenkins 集群

一架构与准备

架构说明：采用 Master–Agent（主从） 模式，Master 负责调度与界面，Agent 负责执行构建任务。为提高吞吐，建议为不同用途的 Agent 打上 Labels（标签），并在任务中通过标签选择执行节点。
节点规划：至少准备 1 台 Master 与 1 台以上 Agent；生产建议 4–8 GB 内存/节点、≥10 GB 磁盘，并安装 OpenJDK 11（或 JDK 8）。
网络与端口：开放 8080/TCP（Web 访问），并在 Master 上开启 JNLP 代理端口（建议固定端口，便于防火墙放行与 Agent 连接）。

二安装与初始化 Master

安装 Java：

sudo apt update
sudo apt install -y openjdk-11-jdk
java -version

添加 Jenkins 官方 APT 源并安装：

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key \
  | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" \
  | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt-get update
sudo apt-get install -y jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins

获取初始管理员密码：

sudo cat /var/lib/jenkins/secrets/initialadminpassword

防火墙放行（如使用 UFW）：
```
sudo ufw allow 8080/tcp
```
首次访问：打开浏览器进入 http://:8080，完成插件安装与初始管理员设置。

三配置 Master 节点

全局安全：进入 Manage Jenkins → Configure Global Security，勾选 Enable security TCP port for JNLP agents，端口选择 固定端口（如 50000） 或 Random，并在防火墙放行对应端口。
节点管理入口：进入 Manage Jenkins → Manage Nodes and Clouds → New Node，创建 Permanent Agent，填写 Name、Remote root directory（如：/var/lib/jenkins）、Labels（如：linux、docker、build）、Executors（并发数） 等；保存后记录 Agent 连接信息（JNLP URL 与 Secret），供后续在 Agent 上启动使用。

四添加多个 Agent 节点

准备环境：在每个 Agent 上安装 OpenJDK 8/11，创建运行用户与目录（如 jenkins:jenkins 与 /var/lib/jenkins），并确保与 Master 网络互通及 JNLP 端口可达。

方式一 Launch agent via Java Web Start（JNLP）

在 Master 上创建节点后，使用页面提供的 jnlpUrl 与 Secret 在 Agent 上启动：

# 方式 A：使用官方 jenkins-agent.jar（推荐）
curl -O http://<master-ip>:8080/jnlpJars/agent.jar
java -jar agent.jar -jnlpUrl http://<master-ip>:8080/computer/<agent-name>/slave-agent.jnlp -secret <secret> -workDir "/var/lib/jenkins"

# 方式 B：使用 jenkins-cli 安装并启动（可选）
wget http://<master-ip>:8080/jnlpJars/jenkins-cli.jar
java -jar jenkins-cli.jar -s http://<master-ip>:8080/ -auth <user>:<token> \
  agent install <agent-name>

方式二 SSH 启动 Agent（需免密）
- 在 Master 生成密钥并分发至各 Agent：
```
ssh-keygen -t ed25519 -b 256
ssh-copy-id jenkins@<agent-ip>
```
- 在 Master 节点配置 SSH Slaves 插件，新增节点时选择 Launch agents via SSH，填写 Host、Credentials 等，保存后自动连接。
验证：回到 Manage Nodes，确认 Agent 在线、Labels 生效，并可在任务中通过 Restrict where this project can be run 指定节点或标签执行。

五高可用与扩展

入口高可用（可选）：使用 HAProxy/Nginx 对 8080/TCP 做负载均衡，将流量分发到多个 Master（适用于多 Master 场景，需配合共享存储/外部化构建状态等方案）。示例 HAProxy 片段：
```
frontend jenkins
  bind *:8080
  default_backend jenkins_servers

backend jenkins_servers
  balance roundrobin
  server master1 192.0.2.11:8080 check
  server master2 192.0.2.12:8080 check
```
进程与故障切换（可选）：在 Master 上使用 systemd 管理 Jenkins，并结合 Keepalived/VRRP 实现 VIP 漂移，提升入口可用性。

容器化扩展（可选）：使用 Docker 快速扩展 Agent，运行示例：

docker run -d --name agent1 \
  -e JENKINS_URL=http://<master-ip>:8080 \
  -e JENKINS_SECRET=<secret> \
  -e JENKINS_AGENT_NAME=agent1 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  jenkins/agent:latest

安全与运维建议：
- 禁用匿名访问，采用 Matrix-based 或 Role-Based 授权；凭据使用 Credentials 插件集中管理。
- 为不同用途的 Agent 设置 Labels，在 Job 中通过标签调度；合理设置 Executors 避免资源争用。

0 赞

0 踩