Debian 上 Jenkins 多节点管理实操指南
一 架构与准备
- 架构模式：采用 Master–Agent（主从） 模式，Master 负责任务调度与界面管理，Agent 负责实际构建；并非每个节点都要安装完整的 Jenkins，只有 Master 安装 Jenkins 服务，Agent 运行 Jenkins Agent 即可。为提升吞吐，可在 Agent 上预装 Maven/Git/Docker 等构建工具。所有节点安装 Java 11（推荐）并保持一致版本。示例：
sudo apt update && sudo apt install -y openjdk-11-jdk && java -version。
- 基础环境：在 Master 添加 Jenkins APT 源并安装（Debian 12 推荐将密钥导入 /usr/share/keyrings/ 并使用 signed-by），启动服务：
sudo systemctl enable --now jenkins。首次访问解锁密码位于 /var/lib/jenkins/secrets/initialAdminPassword。
- 网络与端口：开放 TCP 8080（Web 访问）与 TCP 50000（Agent 入站通信，如使用内置 JNLP 代理）。在 Agent 节点确保该端口可达（云上需安全组放行）。
二 添加与管理节点
- 在 Master 创建节点：进入 Manage Jenkins → Manage Nodes and Clouds → New Node，类型选 Permanent Agent，设置 Name/Labels/Number of executors/Remote root directory（如 /var/jenkins）。
- 启动方式一（SSH）：在节点配置中选择 Launch agents via SSH，填写 Host、Credentials（建议使用 SSH 用户名 + 私钥），保存后自动连接。
- 启动方式二（JNLP/命令行）：在节点页面点击 Launch agent 获取命令或下载 agent.jar，在 Agent 上执行：
java -jar agent.jar -jnlpUrl http://master:8080/computer/<AGENT>/slave-agent.jnlp -secret <SECRET> -workDir "/var/jenkins"；也可使用 jenkins-cli 辅助安装：sudo jenkins-cli agent install http://master:8080 /jnlpJars/jenkins-cli.jar。
- 标签与用法：为节点设置 Labels（如 linux docker maven），在 Job 的 Restrict where this project can be run 使用标签表达式（如 linux && maven）精准调度；勾选 Execute concurrent builds if necessary 启用并发构建。
三 任务分发与并发控制
- 节点选择策略：通过 Labels 将 CPU/内存/工具链 相似的 Agent 归类，Job 使用标签表达式选择目标节点或节点集合，避免错配。
- 并发与隔离：在 Job 配置中启用 并发构建，并结合 Node and Label parameter 让触发者选择目标节点；对资源密集型任务设置 单个节点并发上限（Executors） 与 工作目录隔离，减少干扰。
- 工具链一致性：在各 Agent 预装并统一 JDK/Maven/Git/Docker 版本与路径，避免因环境差异导致构建不一致。
四 高可用与扩展
- 多 Master 与负载均衡：部署 HAProxy/Nginx 对外暴露 8080，后端指向多个 Master 节点，实现入口高可用与简单负载均衡。示例 HAProxy 片段：
frontend jenkins bind *:8080
default_backend jenkins_servers
backend jenkins_servers balance roundrobin
server jenkins1 192.168.1.11:8080 check
server jenkins2 192.168.1.12:8080 check
提示：多 Master 场景需配合 共享存储（如 NFS） 或外部 Artifact 仓库 来共享 JENKINS_HOME 与构建产物，避免状态分裂。
- 容器化扩展：使用 Docker 快速扩展 Agent（便于弹性伸缩与隔离），或采用 Kubernetes 动态代理（需安装相关插件与 K8s 集群）。示例 Docker 运行 Agent：
docker run -d --name agent -e JENKINS_URL=http://master:8080 -e JENKINS_SECRET=<SECRET> -e JENKINS_AGENT_NAME=<AGENT> -v /var/jenkins:/var/jenkins jenkins/agent:latest。
五 安全与运维要点
- 安全加固：在 Manage Jenkins → Configure Global Security 中启用 安全矩阵/登录认证，禁用匿名访问；SSH 凭据 使用 Jenkins 凭据存储 管理，避免明文；限制 Agent 节点 的最小权限与可写目录。
- 监控与备份：安装 监控插件 观察 Master/Agent 资源与队列；定期备份 JENKINS_HOME（含 jobs/plugins/config.xml/secrets）；按周期升级 Jenkins 与插件获取安全修复。
- 常见问题排查：
- 无法连接 Agent：检查 8080/50000 端口、防火墙/安全组、SSH 密钥与用户权限、Agent 工作目录可写。
- 构建环境不一致：统一 JDK/Maven/Git 版本与 PATH，在 Job 中显式设置 Tool Locations。
- 权限问题：确保 Jenkins 用户对 远程工作目录 具备读写执行权限。