在 Debian 上稳定部署 Jenkins 的实操指南
一 环境与前置准备
- 更新系统并安装 OpenJDK 11（Jenkins 2.x 系列在 Debian 上以 Java 11 为主流稳定选择）：
- 执行：
sudo apt update && sudo apt install -y openjdk-11-jdk
- 验证：
java -version
- 资源建议（按规模规划，避免资源争用导致不稳定）：
- 测试环境：4 核 CPU / 8GB 内存 / 50GB SSD
- 生产环境：8 核 CPU / 16GB 内存 / 100GB SSD，并建议 Master 与 Agent 分离 部署
- 防火墙放行端口（如使用 UFW）：
- 执行：
sudo ufw allow 8080/tcp 与 sudo ufw allow 50000/tcp，随后 sudo ufw reload
- 说明：Jenkins 默认 Web 端口为 8080，Agent 通信端口为 50000；如使用云厂商安全组，也需同步放行。
二 安装与初始化
- 添加 Jenkins 官方仓库（推荐新版签名方式，兼容 Debian 12+ 的 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 > /devref
- 安装与启动：
- 安装：
sudo apt update && sudo apt install -y jenkins
- 开机自启与启动：
sudo systemctl enable jenkins && sudo systemctl start jenkins
- 状态检查：
sudo systemctl status jenkins
- 首次访问与解锁：
- 访问：
http://<服务器IP>:8080
- 解锁密码：
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- 初始化设置：
- 选择 Install suggested plugins 或按需安装核心插件：Pipeline、GitHub Integration、Docker、Kubernetes CLI、Credentials Binding
- 创建 管理员账户，并禁用 匿名访问 以提升安全性。
三 安全与网络加固
- 访问控制：
- 在 Manage Jenkins → Security 启用安全策略，禁用匿名访问，采用基于角色的访问控制（如仅管理员可执行管理操作）
- 插件与更新源：
- 在 Manage Jenkins → Plugin Manager → Advanced 将 Update Site 替换为国内镜像（如清华源）以加速插件下载：
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
- 系统与网络安全：
- 仅开放必要端口（8080/50000），避免使用默认端口对外暴露；必要时通过 Nginx/Apache 反向代理 + HTTPS 提供访问
- 定期更新 Jenkins 与插件，及时修补安全漏洞。
四 性能与稳定性优化
- JVM 与系统资源：
- 编辑
/etc/default/jenkins，设置 JAVA_ARGS="-Xms1024m -Xmx4096m"（按内存与负载调整，避免 OOM）
- 构建负载治理：
- 限制 并发构建数，将耗时/资源密集任务下沉到 Agent 节点
- 精简插件，移除 未使用/过时 插件，减少内存与启动时间开销
- 存储与 I/O：
- 使用 SSD，并定期清理 旧构建记录与工作空间 释放空间
- 监控与调优：
- 使用 Performance Plugin 等监控构建性能，结合 Java VisualVM/JConsole 观察堆与线程
- 架构扩展：
- 引入 分布式构建（Master–Agent），按团队/项目横向扩展构建能力。
五 备份与升级维护
- 备份策略：
- 定期备份 JENKINS_HOME（默认 /var/lib/jenkins），包含 jobs、config.xml、credentials、plugins 等关键数据；建议采用全量 + 增量策略并异地存放
- 升级与变更：
- 遵循“先备份、后升级”的流程，先在测试环境验证 Jenkins 与插件 兼容性，再滚动升级生产
- 日常维护：
- 监控 磁盘/内存/CPU 与构建队列长度；为关键任务配置 告警
- 规范 凭据管理（SSH 密钥、用户名/密码、Secret 文本），避免明文与硬编码。
