Spring Boot 项目接入 Jenkins 实现 CI/CD 的核心是自动化“提交→构建→打包→部署”,需确保项目结构规范(Maven+jar包)、Jenkins 配置 JDK/Maven/Git 及插件,并按需选择服务器直部署或 Docker 容器化部署,配合 Poll SCM 或 Webhook 触发自动构建。

在 Spring Boot 项目中接入 Jenkins 实现 CI/CD,核心是把“代码提交 → 自动构建 → 打包 → 部署”这一整套流程交给 Jenkins 管理,无需人工干预。关键不在 Spring Boot 本身写什么代码,而在于项目结构适配、Jenkins 任务配置合理、以及部署方式可自动化。
确保 Spring Boot 项目具备 CI 可构建性
Spring Boot 项目需满足基础工程规范,才能被 Jenkins 正确识别和构建:
- 使用 Maven 或 Gradle 构建(推荐 Maven),根目录含 pom.xml,且能本地执行
mvn clean package -DskipTests成功生成可运行 JAR - 入口类带
@SpringBootApplication,默认打包方式为jar(非 war);若需 Docker 部署,建议显式声明jar - 配置文件(如
application.yml)避免硬编码敏感信息,用 profiles 分离环境(dev/prod),部署时通过 JVM 参数或环境变量注入 - 项目推送到 Git 仓库(GitHub/GitLab/Gitee),确保 Jenkins 能拉取——推荐用 SSH 密钥认证,比账号密码更稳定安全
Jenkins 端必备环境与插件配置
Jenkins 主机必须预装并正确关联以下工具:
-
JDK:在「系统管理 → 全局工具配置」中添加 JDK,指向服务器上的 JDK 安装路径(如
/usr/lib/jvm/java-17-openjdk) -
Maven:同样在全局工具配置中添加 Maven,推荐使用阿里云镜像加速(修改
settings.xml中的) -
Git:安装 Git 插件,并在全局工具配置中指定
git命令路径(如/usr/bin/git) - 常用插件:Git、Maven Integration、Publish Over SSH(用于传统服务器部署)、Docker Pipeline(用于容器化)、Blue Ocean(可视化流水线)
两种主流部署方式及对应 Jenkins 配置要点
根据目标环境选择合适路径,二者均可实现全自动:
-
方式一:直接部署到 Linux 服务器(无 Docker)
在 Jenkins 任务的「构建步骤」中添加「执行 shell」,脚本逻辑为:
① 查找旧进程 PID 并 kill;② 将新生成的target/*.jar复制到固定目录;③nohup java -jar xxx.jar --spring.profiles.active=prod > app.log &启动 -
方式二:构建 Docker 镜像并运行容器(推荐)
项目根目录放Dockerfile(基于 openjdk:17-jre-slim);Jenkins 构建步骤中执行:
①mvn clean package -DskipTests;②docker build -t myapp:latest .;③docker stop myapp || true && docker rm myapp || true;④docker run -d --name myapp -p 8080:8080 -e SPRING_PROFILES_ACTIVE=prod myapp:latest
触发自动构建的关键设置
让 Jenkins 真正“感知”代码变化,避免手动点「立即构建」:
- 在任务配置的「源码管理 → Git」中填入仓库 URL 和凭据后,勾选「Poll SCM」并填写 Cron 表达式(如
H/5 * * * *表示每 5 分钟轮询一次) - 更高效的是启用 Webhook:在 Git 仓库 Settings → Webhooks 中添加 Jenkins 地址(如
http://your-jenkins-ip:8080/github-webhook/),Jenkins 安装 GitHub Plugin 或 Generic Webhook Trigger Plugin 后即可实时响应 push 事件 - 若用 Gitee/GitLab,对应配置其 Webhook URL 和 Secret Token,Jenkins 端做签名校验即可
整个链路跑通后,开发人员只需 git push,Jenkins 就会自动拉代码、编译、测试(可选)、打包、部署,服务几分钟内更新上线。不复杂但容易忽略细节,比如权限、路径、端口冲突、JDK 版本匹配等。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











