CentOS中Jenkins配置方法

CentOS 中 Jenkins 配置方法

一 环境准备与安装

• 更新系统并安装 Java（推荐 OpenJDK 11 或 JDK 1.8）：
  • sudo yum update -y
  • sudo yum install -y java-11-openjdk-devel 或 sudo yum install -y java-1.8.0-openjdk-devel
• 添加 Jenkins 官方仓库并导入 GPG 密钥：
  • sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
  • sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
• 安装 Jenkins：
  • sudo yum install -y jenkins
• 说明：Jenkins 为 Java 应用，需先完成 Java 环境准备；上述仓库与密钥为当前稳定版推荐方式。

二 核心配置与启动

• 编辑主配置文件 /etc/sysconfig/jenkins（按需修改以下常用项）：
  • 监听端口：JENKINS_PORT=“8080”（或改为如 9999）
  • 运行用户：JENKINS_USER=“jenkins”（生产建议创建专用系统用户，避免直接用 root）
  • JVM 参数：JENKINS_JAVA_OPTIONS=“-Djava.awt.headless=true”
  • 主目录：JENKINS_HOME=“/var/lib/jenkins”
  • 日志文件：/var/log/jenkins/jenkins.log
• 目录与权限要点：
  • 安装目录：/usr/lib/jenkins
  • 工作目录：/var/lib/jenkins（含配置、构建产物等）
  • 日志目录：/var/log/jenkins
  • 如变更运行用户，请同步目录属主，例如：
    • sudo chown -R jenkins:jenkins /var/lib/jenkins /var/cache/jenkins /var/log/jenkins
• 启动与开机自启：
  • sudo systemctl daemon-reload
  • sudo systemctl enable --now jenkins
• 防火墙放行（如启用 firewalld）：
  • sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload
• 访问与初始化：
  • 浏览器访问：http://<服务器IP>:8080
  • 解锁密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 按向导完成插件安装与管理员创建。

三 安全与优化建议

• 运行用户与权限：
  • 不建议使用 root 运行 Jenkins；创建专用用户（如 jenkins），并以最小权限运行，目录属主与权限保持一致。
• 升级与更新：
  • 定期执行：sudo yum update jenkins -y，保持版本与插件为最新稳定版，及时获取安全修复。
• 插件与工具：
  • 常用插件：Git、Maven Integration、Docker 等；可在“插件管理”安装，也可通过 jenkins-cli 安装（需先解锁并获取 CLI）。
• 邮件与通知（可选）：
  • 在“系统管理 → 系统设置”配置 SMTP 与系统管理员邮箱，用于构建通知与告警。
• 高可用与扩展：
  • 对于复杂场景，可使用 Jenkins 共享库 与多节点（Agent）进行扩展与标准化交付流程。

四 备份与迁移

• 备份策略：
  • 由于所有数据均在 $JENKINS_HOME（默认 /var/lib/jenkins）下，直接打包该目录即可：
    • tar czf jenkins_home_$(date +%F).tar.gz -C /var/lib/jenkins .
  • 可使用插件 ThinBackup 做定时全量/增量备份与保留策略管理。
• 迁移步骤：
  • 在新机器安装同版本 Jenkins → 停止服务 → 将备份解压至目标 $JENKINS_HOME → 启动服务完成迁移。

五 常见问题排查

• 端口被占用：
  • 检查端口占用：ss -tlnp | grep 8080；在 /etc/sysconfig/jenkins 中修改 JENKINS_PORT 后重启服务。
• Java 未找到或版本不兼容：
  • 确认已安装 OpenJDK 11/1.8；如需指定 Java，设置 JENKINS_JAVA_CMD 或在 /etc/init.d/jenkins 的 candidates 中调整 Java 路径。
• 权限错误：
  • 若修改了 JENKINS_USER，请同步相关目录属主（/var/lib/jenkins、/var/cache/jenkins、/var/log/jenkins）。
• 插件安装慢或失败：
  • 可更换 Update Center 为国内镜像源（编辑 /var/lib/jenkins/hudson.model.UpdateCenter.xml 中的 URL）后重启。