Jenkins在CentOS上的配置步骤是什么

在 CentOS 上配置 Jenkins 的完整步骤

一 环境准备与 Java 安装

• 更新系统并安装常用工具：
  • 命令：sudo yum update -y && sudo yum install -y wget
• 安装受支持的 Java（二选一或并存）：
  • OpenJDK 11：sudo yum install -y java-11-openjdk-devel
  • OpenJDK 8：sudo yum install -y java-1.8.0-openjdk-devel
• 验证版本：java -version。

二 安装 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
• 说明：仓库与密钥为官方稳定版渠道，后续可通过 yum 正常升级。

三 启动服务与防火墙配置

• 启动并设置开机自启：
  • 命令：sudo systemctl start jenkins
  • 命令：sudo systemctl enable jenkins
• 防火墙放行（推荐仅放行 8080/tcp）：
  • 精确放行端口：sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp && sudo firewall-cmd --reload
  • 或放行 http 服务：sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload
• 查看状态：sudo systemctl status jenkins（确保为 active (running)）。

四 初始化与基础安全配置

• 获取并输入解锁密码：
  • 命令：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 访问：http://<服务器IP或域名>:8080，粘贴密码继续
• 安装插件与创建管理员：
  • 选择 Install suggested plugins，完成后设置 管理员账户 与 密码
• 常用后续配置：
  • 全局工具：配置 JDK、Git、Maven 路径（Manage Jenkins → Global Tool Configuration）
  • 安全：启用 CSRF 保护、使用强密码策略、限制代理/节点通信
  • 通知：配置 邮件/企业微信/钉钉 等构建结果通知。

五 构建任务与自动化示例

• 新建任务：选择 Freestyle project
• 源码管理：选择 Git，填写仓库 URL 与分支（如 */main）
• 构建触发器：
  • 轮询 SCM：H/5 * * * *（每 5 分钟检查一次变更）
  • 或配置 Webhook（在代码托管平台设置，指向 http://<JENKINS_URL>/github-webhook/ 等）
• 构建步骤：
  • Maven 项目示例：mvn clean package -DskipTests
  • 其他：执行 Shell、调用脚本、Docker 构建等
• 构建后操作：
  • 归档产物（如 **/target/*.jar）、发布到 Nexus/Artifactory、部署到测试/生产环境（SSH、Ansible、K8s 等）
• 分布式构建（可选）：在 Manage Nodes and Clouds 添加 Agent 节点，实现多机并行构建。

六 常见问题与排错要点

• 端口冲突：检查占用 sudo netstat -tulpen | grep 8080，或在 /etc/sysconfig/jenkins 中修改 JENKINS_PORT 后重启
• 启动失败：查看日志 sudo journalctl -u jenkins -xe，关注权限、JDK 路径、端口占用等
• Java 不匹配：确保使用 Java 8 或 11（或更高受支持版本），java -version 与 Jenkins 要求一致
• 插件安装慢/失败：在插件管理配置 国内镜像源，或分批安装核心插件
• 权限问题：确保 /var/lib/jenkins 等目录属主为 jenkins:jenkins，必要时 sudo chown -R jenkins:jenkins /var/lib/jenkins
• 时区显示：在 /etc/sysconfig/jenkins 增加 JENKINS_JAVA_OPTIONS="-Duser.timezone=Asia/Shanghai" 并重启