在 Debian 上搭建 Java 项目的持续集成
一 环境准备与安装
- 安装 Java JDK 11（推荐 LTS）：sudo apt update && sudo apt install openjdk-11-jdk；验证：java -version。
- 安装 Maven：sudo apt install maven。
- 安装 Jenkins（官方仓库方式）：
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
echo deb https://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list
sudo apt update && sudo apt install jenkins
- 启动与开机自启：sudo systemctl start jenkins && sudo systemctl enable jenkins
- 访问控制台：打开浏览器进入 http://<服务器IP>:8080；首次解锁密码位于 /var/lib/jenkins/secrets/initialAdminPassword。
- 防火墙放行：sudo ufw allow 8080/tcp（如使用 UFW）。
二 配置 Jenkins 与插件
- 推荐插件：Git Plugin、Maven Integration Plugin、Pipeline Plugin、Email Extension Plugin。
- 全局工具配置：在 Manage Jenkins → Global Tool Configuration 指定 JDK 11 与 Maven 安装路径（或使用自动安装）。
- 创建任务：
- Freestyle 项目：源码管理选 Git，构建步骤执行 mvn clean package，构建后可归档产物、发送通知。
- Pipeline 项目：在项目中加入 Jenkinsfile，从 SCM 读取脚本，便于版本化管理与复用。
三 定义构建流程与触发方式
- 示例 Jenkinsfile（位于项目根目录）：
pipeline {
agent any
stages {
stage(‘Build’) { steps { sh ‘mvn clean package’ } }
stage(‘Test’) { steps { sh ‘mvn test’ } }
stage(‘Deploy’) {
when { branch ‘main’ }
steps {
withCredentials([sshUserPrivateKey(credentialsId: ‘deploy-key’, keyFileVariable: ‘KEY’)]) {
sh ‘scp -i $KEY target/*.jar user@target:/opt/app/’
}
}
}
}
}
- 触发方式：
- 轮询 SCM：在 Poll SCM 中配置日程（如 H/5 * * * * 每 5 分钟检查一次）。
- Webhook：在 GitHub/GitLab 配置 Push/MR 事件回调 Jenkins，实现提交即构建。
四 运行监控与优化
- 监控与报告：在 Post-build Actions 归档 JAR/WAR、发布 测试结果、配置 邮件/Slack 通知，便于快速定位失败。
- 性能与扩展：启用 构建缓存（如本地 Maven 仓库缓存）、并行测试；规模扩大时引入 Jenkins Agent 分布式构建。
- 安全与维护：使用 SSH 密钥 管理凭证，按 最小权限 分配用户；定期更新 Jenkins 与插件并备份配置与任务。
五 可选方案与进阶
- 轻量替代：使用 GitHub Actions 或 GitLab CI/CD，在仓库根目录配置 .github/workflows/ci.yml 或 .gitlab-ci.yml 定义构建与测试流程，适合托管在公有平台的项目。
- Debian 打包发布：结合 JDeb 将 Java 应用构建为 .deb 包，便于在 Debian 系环境标准化部署与升级。