如何在centos成功部署jenkins

在 CentOS 上部署 Jenkins 的可执行步骤

一 环境准备与 Java 安装

• 更新系统并安装 Java（推荐 OpenJDK 11 或 17，新版本 Jenkins 对 Java 11/17 支持更好）：
  • CentOS 7/8：
    • sudo yum update -y
    • sudo yum install -y java-11-openjdk-devel # 或 java-17-openjdk-devel
  • CentOS Stream 9/DNF 系：
    • sudo dnf install -y java-17-openjdk-devel
• 验证版本：java -version（应显示 11 或 17）。

二 安装与启动 Jenkins（RPM 方式）

• 添加 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 与依赖（部分环境需要 fontconfig）：
  • sudo yum install -y jenkins fontconfig # 或 dnf install -y jenkins
• 启动并设置开机自启：
  • sudo systemctl daemon-reload
  • sudo systemctl enable --now jenkins
• 检查状态：
  • sudo systemctl status jenkins（应为 active (running)）。

三 防火墙与端口开放

• 开放 8080（Web 访问）与 50000（Agent 通信，如使用 Jenkins Agent 建议开放）：
  • sudo firewall-cmd --permanent --add-port=8080/tcp
  • sudo firewall-cmd --permanent --add-port=50000/tcp
  • sudo firewall-cmd --reload
• 如使用云服务器，还需在云厂商安全组放行对应端口。

四 首次访问与初始化

• 浏览器访问：http://<服务器IP>:8080
• 解锁 Jenkins：查看初始管理员密码
  • sudo cat /var/lib/jenkins/secrets/initialAdminPassword
• 安装插件与创建管理员：选择 Install suggested plugins，完成后设置管理员账户与站点 URL。

五 常见问题与优化

• Java 版本不兼容导致启动失败
  • 现象：systemctl status jenkins 报 “Java not found” 或版本不支持。
  • 处理：
    • 确认 java -version 为 11/17；
    • 在 /etc/sysconfig/jenkins 中显式设置 JAVA_HOME（如：JAVA_HOME=/usr/lib/jvm/java-11-openjdk），或创建软链：ln -sfn /usr/lib/jvm/java-11-openjdk/bin/java /usr/bin/java；
    • 重启：sudo systemctl restart jenkins。
• 端口被占用
  • 修改 /etc/sysconfig/jenkins 中的 JENKINS_PORT（如改为 9999），并同步放行防火墙端口，重启服务。
• 插件下载慢
  • 在 “Manage Jenkins → Plugin Manager → Advanced” 将 Update Site 改为国内镜像：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json。
• 安全加固建议
  • 禁用匿名访问，启用登录安全与基于角色的访问控制（RBAC）；
  • 配置 HTTPS（反向代理或 Nginx Ingress）；
  • 定期更新 Jenkins 核心与插件，清理旧构建与工作空间，限制并发构建数，必要时分离 Master/Agent。