CentOS 上部署 Jenkins 的关键注意事项
一 系统与 Java 环境
- 保持系统基线安全与稳定：部署前执行系统更新（如 yum update），并选择合适版本的 CentOS（如 CentOS Stream 9） 以获得较新的安全补丁与驱动支持。
- Java 版本与路径：Jenkins 2.x 建议使用 OpenJDK 11 或更高版本；安装后确认 java -version 输出，并为 Jenkins 指定正确的 JAVA_HOME（可在 systemd 服务或 jenkins 配置中设置），避免因找不到 Java 导致启动失败。
- 目录与权限基线：确认 /var/lib/jenkins 与 /var/log/jenkins 归属 jenkins:jenkins，并设置合理权限，防止因权限不足导致启动或升级异常。
二 安装与网络端口
- 官方 RPM 源安装：导入 Jenkins 官方 GPG 并添加 jenkins.repo，使用 yum/dnf 安装，便于版本管理与升级。
- 端口规划与防火墙：默认监听 8080；如启用 JNLP 代理需开放 50000/TCP；使用 firewalld 持久化放行端口（firewall-cmd --permanent --add-port=8080/tcp 与 50000/tcp，然后 reload）。
- 反向代理与域名：生产环境建议使用 Nginx/Apache 做反向代理与静态资源缓存，并配置合适的 Server/反向代理头；如需 WebSocket 代理，确保代理支持升级连接。
- 服务自启与验证：启用并启动 Jenkins 服务（systemctl enable --now jenkins），通过 systemctl status 与日志检查运行状态。
三 安全加固
- 启用认证与授权：在“全局安全配置”中启用登录认证，采用 基于矩阵或基于角色的访问控制（RBAC），禁用匿名访问，细化到任务/视图/凭据的权限粒度。
- 传输加密：优先启用 HTTPS（可使用反向代理或内置 Jetty 配置证书），避免凭据与构建产物在公网明文传输。
- 凭据与密钥管理：使用 Jenkins 的 Credentials 体系集中管理 SSH 私钥、用户名/密码、令牌与证书，避免在代码或 Job 配置中明文存放。
- 最小权限运行：不建议直接以 root 运行 Jenkins；如确需提升权限，应通过 sudo 精细授权 或代理/包装脚本实现，降低被攻破后的影响面。
- 安全插件：安装并启用 CSRF 保护、安全审计、权限策略等插件，定期审计与安全基线检查。
四 性能与高可用
- 资源与 JVM：根据节点角色与并发量调整 JVM 堆大小（-Xms/-Xmx），避免频繁 Full GC；限制 并发构建数 与队列长度，防止资源争用。
- 存储与清理：定期清理 旧的构建历史与工作空间，设置构建保留策略；监控 磁盘 I/O 与空间，避免因日志/归档占满磁盘导致节点失联。
- 架构扩展：对大规模任务采用 分布式构建（Agent/节点），将构建负载分摊到多台机器；Master 专注调度与安全管控，Agent 承载编译/测试/部署。
- 监控与告警：启用 系统/构建监控（如监控插件或外部监控系统），对节点离线、构建失败率、队列积压等设定阈值告警。
五 维护与备份
- 升级策略：保持 Jenkins 与插件 的及时更新，先备份再升级，先在测试环境验证插件兼容性，避免生产中断。
- 日志与审计：定期查看 /var/log/jenkins/jenkins.log，并结合系统日志审计关键操作与异常堆栈。
- 备份与恢复：制定 定期备份（如每日全量/增量），覆盖 JENKINS_HOME（/var/lib/jenkins） 与关键配置；验证备份可恢复性，保留多份与异地副本。
- 常见排障要点：端口冲突（检查 8080/50000 是否被占用）、Java 路径错误（显式设置 JAVA_HOME）、权限问题（/var/lib/jenkins 与 /var/log/jenkins 属主）、SELinux/防火墙策略阻断（必要时调整策略或临时置 permissive 验证）。