如何在CentOS上配置Jenkins的持续集成流程

在 CentOS 上配置 Jenkins 持续集成流程

一环境准备与安装

安装 Java（Jenkins 依赖 Java，建议 JDK 17）：
- 安装命令：sudo yum install -y java-17-openjdk
- 验证版本：java -version

添加 Jenkins 官方仓库并安装：

添加源与密钥：

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 systemctl start jenkins
- sudo systemctl enable jenkins
防火墙放行端口（默认 8080）：
- sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload
首次访问与解锁：
- 访问：http://<服务器IP>:8080
- 初始密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- 按向导完成初始化（可选择安装推荐插件并创建管理员）。

二基础配置与常用插件

全局工具配置（Manage Jenkins → Global Tool Configuration）：
- 配置 JDK（若系统已装，可直接指定 JAVA_HOME）
- 配置 Git（确保系统已安装：sudo yum install -y git）
- 配置 Maven（建议使用 Maven 3.x，可自动安装或指定本地路径）
推荐插件（Manage Jenkins → Manage Plugins）：
- 必装：Git、Maven Integration、Pipeline、Docker Pipeline（如需容器化构建）
- 可选：Blue Ocean（可视化流水线）、Publish Over SSH（远程部署）
可选优化（国内环境）：
- 更新站点镜像（提高插件下载速度）：修改文件 /var/lib/jenkins/hudson.model.UpdateCenter.xml，将更新地址替换为镜像源（如 https://mirror.xmission.com/jenkins/updates/update-center.json），保存后重启 Jenkins。

三创建 CI 流水线

方式一 Freestyle 项目（适合快速接入）
- 新建任务 → 选择 Freestyle project
- 源码管理：选择 Git，填写仓库 URL 与分支（如 */main）
- 构建触发器：选择 轮询 SCM（如 H/5 * * * * 每 5 分钟检查一次）或与 Git 平台配置 Webhook 实现提交即触发
- 构建环境：选择已配置的 JDK 与 Maven
- 构建步骤：执行 mvn clean package 或 mvn clean install
- 构建后操作：可归档产物（如 **/target/*.jar）、发布到 SSH、发送通知等

方式二 Pipeline 项目（推荐，可版本化管理流程）

新建任务 → 选择 Pipeline
在 Pipeline 部分选择 Pipeline script 或 Pipeline script from SCM（从仓库加载 Jenkinsfile）

示例 Jenkinsfile（Maven 项目）：

pipeline {
  agent any
  tools {
    maven 'Maven 3.x'   // 与全局工具配置中的名称一致
    jdk   'JDK 17'     // 与全局工具配置中的名称一致
  }
  stages {
    stage('Checkout') {
      steps { git branch: 'main', url: 'https://github.com/your-org/your-repo.git' }
    }
    stage('Build') {
      steps { sh 'mvn -B -DskipTests clean package' }
    }
    stage('Test') {
      steps { sh 'mvn test' }
      post {
        always { junit '**/target/surefire-reports/*.xml' } // 收集测试报告
      }
    }
    stage('Archive') {
      steps { archiveArtifacts artifacts: '**/target/*.jar', fingerprint: true }
    }
  }
}

触发方式：
- 轮询 SCM：在“Scan Repository Now”或按设定频率触发
- Webhook：在 Git 平台（如 GitLab/GitHub）配置 Webhook URL：http://<JENKINS_URL>/github-webhook/（或 gitlab-webhook），并选择触发事件（push、merge request 等）。

四部署与通知

远程部署（使用 Publish Over SSH）
- 安装并配置插件：Manage Jenkins → System → Publish over SSH
- 新增 SSH Server（填写目标主机、端口、认证方式）
- 在构建后操作中添加 “Send build artifacts over SSH”：
  - Source files：**/target/*.jar
  - Remove prefix：target
  - Remote directory：/opt/app
  - Exec command（示例）：
```
cd /opt/app
nohup java -jar your-app.jar > app.log 2>&1 &
```
邮件通知（Extended E-mail Notification）
- 配置 SMTP（如 QQ 邮箱：SMTP 服务器 smtp.qq.com，端口 465，开启 SSL，使用授权码作为密码）
- 在构建后操作添加 “Editable Email Notification”，设置收件人、主题、内容模板（可使用内置变量如 $BUILD_STATUS、$BUILD_URL）。

五常见问题与排障

端口被占用（Address already in use）
- 检查占用：sudo ss -tulnp | grep 8080
- 结束进程：sudo kill -9 <PID>
- 或更改端口：编辑 /usr/lib/systemd/system/jenkins.service 中的 Environment="JENKINS_PORT=8087"，然后 sudo systemctl daemon-reload && sudo systemctl restart jenkins
启动超时
- 编辑 /usr/lib/systemd/system/jenkins.service，将 TimeoutStartSec=0，再重启服务
权限问题（执行 Docker 命令）
- 将 Jenkins 用户加入 docker 组：sudo usermod -aG docker jenkins
- 重启：sudo systemctl restart jenkins
- 验证：sudo -u jenkins bash -lc 'docker ps'
插件更新慢或失败
- 使用镜像源替换 /var/lib/jenkins/hudson.model.UpdateCenter.xml 中的更新地址，重启服务。

最新问答

相关标签