centos上jenkins部署指南

CentOS 上部署 Jenkins 指南

一 环境准备与安装 Java

• 更新系统并安装常用工具：
  • sudo yum update -y
  • sudo yum install -y wget vim fontconfig
• 安装受支持的 Java（二选一或并存，Jenkins 2.361+ 建议使用 Java 11 或 17）：
  • OpenJDK 11：sudo yum install -y java-11-openjdk-devel
  • OpenJDK 17：sudo yum install -y java-17-openjdk-devel
  • 如需 Oracle JDK 17：
    • wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.rpm
    • sudo yum install -y ./jdk-17_linux-x64_bin.rpm
• 验证版本：java -version（确保输出为 1.8/11/17 之一）。

二 通过 RPM 仓库安装并启动 Jenkins

• 添加 Jenkins 官方 YUM 仓库并导入 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
• 可选：开放防火墙端口（默认 8080）
  • sudo firewall-cmd --permanent --add-port=8080/tcp
  • sudo firewall-cmd --reload
• 启动并设置开机自启：
  • sudo systemctl daemon-reload
  • sudo systemctl start jenkins
  • sudo systemctl enable jenkins
  • sudo systemctl status jenkins（确认状态为 active (running)）。

三 初始化配置与插件安装

• 获取解锁密码并访问 Web 界面：
  • 查看初始管理员密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 浏览器访问：http://<服务器IP>:8080，输入上述密码进入向导
• 安装插件与创建管理员：
  • 选择 Install suggested plugins 或使用国内镜像源加速（Manage Jenkins -> Plugin Manager -> Advanced，将 Update Site 替换为：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json）
  • 创建第一个管理员账户，完成初始化
• 常用后续配置：
  • 全局工具：配置 JDK、Maven/Gradle、Git
  • 安全：禁用匿名访问，启用基于角色的访问控制（RBAC）
  • 凭据：添加 SSH 私钥、用户名/密码、Secret text 等。

四 常用配置与优化

• 修改端口与运行用户（不建议直接改为 root，生产环境请使用最小权限原则）
  • 编辑 /etc/sysconfig/jenkins：JENKINS_PORT=“8081”（示例）
  • 如需变更运行用户，同步调整 /usr/lib/systemd/system/jenkins.service 中的 User= 并确保目录权限正确
  • 变更后执行：sudo systemctl daemon-reload && sudo systemctl restart jenkins
• JVM 堆内存（示例为 2GB，请按服务器资源调整）
  • 编辑 /usr/lib/systemd/system/jenkins.service，在 [Service] 增加：Environment=“JAVA_OPTS=-Xms2g -Xmx2g”
  • 重载并重启：sudo systemctl daemon-reload && sudo systemctl restart jenkins
• 防火墙与代理端口
  • 代理端口（JNLP/CLI）：sudo firewall-cmd --permanent --add-port=50000/tcp && sudo firewall-cmd --reload
• 性能与稳定性
  • 定期更新 Jenkins 与插件，清理旧构建与工作空间
  • 使用 分布式构建（Agent/节点）分担负载
  • 监控与日志：结合系统监控（如 Prometheus/Grafana）与日志轮转（logrotate）。

五 可选部署方式 Docker 快速启动

• 安装 Docker（如未安装）：sudo yum install -y docker && sudo systemctl start docker && sudo systemctl enable docker
• 拉取并运行 LTS 镜像（持久化数据卷 /var/jenkins_home，映射 8080 与 50000）：
  • docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -v /var/jenkins_home:/var/jenkins_home jenkins/jenkins:lts
• 首次解锁密码路径（容器内）：/var/jenkins_home/secrets/initialAdminPassword（可通过 docker exec 查看）。