怎样在centos上快速部署jenkins

在 CentOS 上快速部署 Jenkins

一 准备环境

• 更新系统并安装常用工具：
  • sudo yum update -y
  • sudo yum install -y wget fontconfig
• 安装受支持的 Java（推荐 JDK 11 或 JDK 17）：
  • OpenJDK 11：sudo yum install -y java-11-openjdk-devel
  • OpenJDK 17：sudo yum install -y java-17-openjdk-devel
• 验证：java -version（应显示 11 或 17 的版本号）。

二 安装与启动

• 添加 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
• 启动并设置开机自启：
  • sudo systemctl daemon-reload
  • sudo systemctl enable --now jenkins
• 查看状态：
  • sudo systemctl status jenkins（应为 active (running)）。

三 防火墙与访问

• 开放 8080 端口（Jenkins 默认端口）：
  • sudo firewall-cmd --permanent --add-port=8080/tcp
  • sudo firewall-cmd --reload
• 浏览器访问：http://服务器IP:8080
• 获取初始管理员密码：
  • sudo cat /var/lib/jenkins/secrets/initialAdminPassword
• 在向导中选择 Install suggested plugins，随后创建管理员账户并完成初始化。

四 常用配置与优化

• 修改端口或运行用户（可选）：编辑 /etc/sysconfig/jenkins
  • 修改端口：JENKINS_PORT=“9999”
  • 修改用户：JENKINS_USER=“root”（生产环境建议使用专用用户并配置权限）
  • 修改后执行：sudo systemctl restart jenkins
• 指定 Java（可选）：编辑 /usr/lib/systemd/system/jenkins.service
  • 设置：Environment=“JAVA_HOME=/usr/lib/jvm/java-17-openjdk-…”
  • 执行：sudo systemctl daemon-reload && sudo systemctl restart jenkins
• 插件与字体（可选加速与消除告警）：
  • 插件镜像：将更新站点替换为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 无头环境缺少字体导致 AWT 告警时：sudo yum install -y fontconfig。

五 常见问题快速排查

• 启动失败且提示 “Failed to start … (code=exited, status=1/FAILURE)”：
  • 确认已安装受支持的 JDK 11/17，并优先使用系统 java 命令（ alternatives 或软链 /usr/bin/java 指向有效 JDK）
  • 查看日志：sudo journalctl -xeu jenkins
  • 必要时在 /usr/lib/systemd/system/jenkins.service 中显式设置 Environment=“JAVA_HOME=…”，再执行 systemctl daemon-reload 与重启
• 访问被防火墙拦截：确认已执行 firewall-cmd 开放 8080/tcp 并 reload
• 插件下载慢：更换为国内镜像更新站点（见上一节）。