centos下jenkins部署指南

CentOS 下 Jenkins 部署指南

一 环境准备与安装

• 更新系统并安装 Java（推荐 OpenJDK 11 或 OpenJDK 17；Jenkins 2.361+ 建议使用 Java 11+）：
  • 安装 OpenJDK 11：sudo yum install -y java-11-openjdk-devel
  • 或安装 OpenJDK 17：sudo dnf install -y java-17-openjdk-devel
  • 验证：java -version
• 添加 Jenkins 官方 YUM 仓库并安装：
  • 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
  • sudo yum install -y jenkins（或 sudo dnf install -y jenkins）
• 说明：Jenkins 是基于 Java 的应用，需先完成 Java 环境准备；仓库地址与导入 GPG 密钥为官方稳定源。

二 服务配置与启动

• 配置监听端口与运行用户（两种方式二选一，推荐修改配置文件）：
  • 方式 A（推荐）：编辑 /etc/sysconfig/jenkins
    • JENKINS_PORT=“8080”
    • JENKINS_USER=“jenkins”
  • 方式 B：编辑 systemd 服务文件 /usr/lib/systemd/system/jenkins.service
    • 确认 User=jenkins、WorkingDirectory=/var/lib/jenkins、ExecStart=/usr/bin/jenkins
• 重新加载 systemd 并启动服务：
  • sudo systemctl daemon-reload
  • sudo systemctl start jenkins
  • sudo systemctl enable jenkins
  • 检查状态：sudo systemctl status jenkins
• 目录权限建议：
  • sudo chown -R jenkins:jenkins /var/lib/jenkins /var/cache/jenkins /var/log/jenkins
• 说明：/etc/sysconfig/jenkins 用于设置端口与用户；systemd 单元用于进程管理；权限设置可避免运行期写入失败。

三 防火墙与端口开放

• 开放 8080（Web 访问）与 50000（JNLP 代理通信，如使用代理节点请务必开放）：
  • sudo firewall-cmd --permanent --add-port=8080/tcp
  • sudo firewall-cmd --permanent --add-port=50000/tcp
  • 或仅放行 HTTP：sudo firewall-cmd --permanent --add-service=http
  • 重载：sudo firewall-cmd --reload
• 云服务器请在安全组放行对应端口。

四 初始化与基础安全配置

• 访问并解锁：打开浏览器访问 http://<服务器IP>:8080，使用初始管理员密码解锁
  • 查看初始密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
• 安装插件与创建管理员：选择 Install suggested plugins，完成后创建管理员账户
• 安全加固建议：
  • 禁用匿名访问，启用基于角色的访问控制（RBAC）
  • 配置 HTTPS（反向代理或 Nginx Ingress）
  • 插件更新与备份策略常态化
• 说明：首次解锁密码路径固定；插件与账户创建在向导中完成；生产环境务必开启认证与 HTTPS。

五 构建环境示例与常见问题

• 构建环境示例（Java + Maven + Git）：
  • 安装工具：sudo yum install -y git maven
  • 在 Jenkins 全局工具配置中指定 JAVA_HOME、MAVEN_HOME 或使用自动安装
  • 示例声明式流水线（Jenkinsfile）： pipeline { agent any stages { stage(‘Build’) { steps { sh ‘mvn clean package’ } } stage(‘Test’) { steps { sh ‘mvn test’ } } stage(‘Deploy’) { when { branch ‘main’ } steps { sh ‘mvn deploy’ } } } }
• 常见问题与排查：
  • 端口被占用：ss -tulpen | grep 8080；修改 JENKINS_PORT 后重启服务
  • 权限错误：确认 /var/lib/jenkins 等目录属主为 jenkins:jenkins
  • 无法切换 jenkins 用户：检查 /etc/passwd 中 shell 是否为 /bin/bash
  • 插件下载慢：在插件管理的高级中更换更新站点为国内镜像（如清华 TUNA）
• 说明：示例流水线展示 Java 项目标准三段式；权限与用户问题为常见故障点，按提示修正目录属主与登录 Shell 即可。