在 CentOS 上部署 Jenkins 并实现持续集成
一 环境准备与安装
- 准备一台运行 CentOS 7/8/9 的服务器，建议至少 2 核 CPU、4GB 内存、20GB 磁盘，并确保网络稳定。
- 安装 Java（Jenkins 为 Java 应用）：
- OpenJDK 11（通用稳定）：sudo yum install -y java-11-openjdk-devel
- 或 OpenJDK 8（部分老项目兼容）：sudo yum install -y java-1.8.0-openjdk-devel
- 添加 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
- 访问与初始化：浏览器打开 http://服务器IP:8080，首次解锁密码在 /var/lib/jenkins/secrets/initialAdminPassword；随后可选择安装推荐插件并创建管理员账户。
二 基础配置与网络
- 防火墙放行端口（默认 8080）：
- sudo firewall-cmd --permanent --add-port=8080/tcp
- sudo firewall-cmd --reload
- 修改 Jenkins 端口与运行用户（可选）：编辑 /etc/sysconfig/jenkins
- JENKINS_PORT=“8080”（改为需要端口）
- JENKINS_USER=“jenkins”（确保该用户对 Jenkins 目录有合适权限）
- 重启使配置生效：sudo systemctl restart jenkins
- 插件与更新源优化：在 系统管理 → 插件管理 安装常用插件（如 Git、Maven、Docker 等）；如需加速，可在 hudson.model.UpdateCenter.xml 配置国内镜像源。
三 创建 CI 任务与触发器
- Freestyle 任务（通用）
- 新建任务 → 选择 Freestyle 项目 → 源码管理选择 Git，填写仓库 URL 与分支（如 */main）。
- 构建触发器：
- 轮询 SCM：如 **H/5 * * * ***（每 5 分钟检查一次变更）
- Webhook：在代码托管平台（如 GitLab/GitHub）配置事件推送，指向 Jenkins 的 /github-webhook/ 或 /gitlab-webhook/（需安装对应插件并启用 CSRF 保护例外）。
- 构建环境：确保节点已安装 Git、Maven 等工具。
- 构建步骤：执行构建命令，如 mvn clean package 或自定义脚本。
- 构建后操作：归档产物（如 target/*.jar）、发布测试报告、发送通知等。
- Pipeline 任务（推荐，代码即配置）
- 在项目根目录创建 Jenkinsfile，示例：
pipeline {
agent any
stages {
stage(‘Checkout’) { steps { git url: ‘https://your-repo-url.git’, branch: ‘main’ } }
stage(‘Build’) { steps { sh ‘mvn -B -DskipTests clean package’ } }
stage(‘Test’) { steps { sh ‘mvn test’ } }
stage(‘Archive’) { steps { archiveArtifacts artifacts: ‘target/*.jar’, fingerprint: true } }
}
}
- 新建任务选择 Pipeline，在 Pipeline 配置中选择 Pipeline script from SCM，指向上述仓库与 Jenkinsfile。
四 与 Docker 集成与分布式构建
- Docker 集成（在 Jenkins 内构建与运行容器）
- 在 Jenkins 节点安装 Docker，并将 jenkins 用户加入 docker 组：sudo usermod -aG docker jenkins
- 在 系统管理 → 插件管理 安装 Docker 插件，在 系统设置 → Docker 添加 Docker 服务器 URL（如 unix:///var/run/docker.sock），测试连接成功后保存。
- 在任务中使用 Docker Pipeline 或直接在构建步骤执行 docker 命令，实现镜像构建、运行与清理。
- 分布式构建（多机并行）
- 在 系统管理 → 节点管理 新增 Agent 节点，在目标机器安装 Jenkins Agent 并启动连接；
- 在任务配置中指定 Agent 或使用 标签表达式 实现按标签调度，提高构建吞吐与资源隔离。
五 常见问题与优化建议
- Java 版本选择：新版本 Jenkins 建议使用 Java 11/17；若项目强依赖 Java 8，可继续使用 OpenJDK 8。
- 权限与目录：若修改了 JENKINS_USER，需同步调整 /var/lib/jenkins、/var/cache/jenkins、/var/log/jenkins 等目录属主与权限，避免启动失败或权限错误。
- 插件与更新：优先使用官方仓库与推荐插件集；国内环境可配置镜像源提升下载速度。
- 安全加固：启用 CSRF 保护、为 Jenkins URL 配置反向代理与 HTTPS、最小权限原则分配凭据与权限；Webhook 需正确配置 Secret 或 CSRF 豁免。
