Spring Boot CI/CD 集成：Jenkins 与 GitLab CI 的轻松之旅
引言
大家好，欢迎来到今天的讲座！今天我们要聊一聊如何利用 Spring Boot 进行 CI/CD（持续集成/持续交付）的集成，特别是通过 Jenkins 和 GitLab CI 来实现。如果你是第一次接触这些工具，别担心，我会尽量用轻松诙谐的语言，让你在愉快的氛围中掌握这些强大的技术。
什么是 CI/CD？
首先，我们来简单了解一下 CI/CD 是什么。CI/CD 是 DevOps 文化中的两个重要概念：
- CI（Continuous Integration，持续集成）：每次代码提交后，自动构建和测试代码，确保新代码不会破坏现有功能。
- CD（Continuous Delivery/Deployment，持续交付/部署）：在 CI 的基础上，进一步自动化将代码部署到生产环境或测试环境。
简单来说，CI/CD 的目标是让开发人员能够更频繁、更可靠地发布代码，减少人为错误，提升开发效率。
为什么选择 Jenkins 和 GitLab CI？
Jenkins
Jenkins 是一个非常流行的开源 CI/CD 工具，支持多种编程语言和技术栈。它的优点在于：
- 插件丰富：Jenkins 有数以千计的插件，几乎可以满足你所有的需求。
- 灵活性高：你可以根据项目的需求自定义构建流程。
- 社区活跃：Jenkins 有一个庞大的社区，遇到问题时很容易找到解决方案。
GitLab CI
GitLab CI 是 GitLab 自带的 CI/CD 工具，它与 GitLab 仓库紧密集成，使用起来非常方便。它的优点在于：
- 无缝集成：GitLab CI 直接嵌入到 GitLab 项目中，不需要额外配置。
- 简洁易用：通过
.gitlab-ci.yml文件配置管道，语法简单易懂。 - 内置 Docker 支持：GitLab CI 原生支持 Docker，非常适合容器化应用的构建和部署。
Spring Boot 项目简介
Spring Boot 是一个用于快速开发微服务的框架，它简化了 Spring 应用的配置和启动过程。我们假设你已经有一个 Spring Boot 项目，并且想要为它设置 CI/CD 流程。接下来，我们将分别介绍如何使用 Jenkins 和 GitLab CI 来实现这一点。
项目结构
假设我们的 Spring Boot 项目结构如下：
my-spring-boot-app/
├── src/
│ ├── main/
│ │ ├── java/
│ │ └── resources/
│ └── test/
│ └── java/
├── pom.xml
└── .gitlab-ci.yml (或 Jenkinsfile)使用 Jenkins 实现 CI/CD
1. 安装 Jenkins
首先，你需要安装 Jenkins。可以通过 Docker 或者直接在服务器上安装。这里我们使用 Docker 来安装 Jenkins：
docker run -d -p 8080:8080 -p 50000:50000 --name jenkins jenkins/jenkins:lts安装完成后，访问 http://localhost:8080，按照提示完成初始配置。
2. 创建 Jenkins Pipeline
Jenkins 支持两种类型的 Pipeline：Declarative Pipeline 和 Scripted Pipeline。我们推荐使用 Declarative Pipeline，因为它更加直观易读。
在项目的根目录下创建一个 Jenkinsfile，内容如下：
pipeline {
agent any
stages {
stage('Checkout') {
steps {
git 'https://github.com/your-repo/my-spring-boot-app.git'
}
}
stage('Build') {
steps {
sh 'mvn clean install'
}
}
stage('Test') {
steps {
sh 'mvn test'
}
}
stage('Deploy') {
when {
branch 'main'
}
steps {
sh 'scp target/*.jar user@server:/opt/app/'
sh 'ssh user@server "sudo systemctl restart app"'
}
}
}
post {
always {
junit 'target/surefire-reports/**/*.xml'
archiveArtifacts artifacts: 'target/*.jar', onlyIfSuccessful: true
}
}
}这个 Pipeline 的工作流程如下：
- Checkout：从 Git 仓库拉取最新代码。
- Build：使用 Maven 构建项目。
- Test：运行单元测试。
- Deploy：如果当前分支是
main，则将构建好的 JAR 文件上传到服务器并重启应用。 - Post：无论构建是否成功，都会保存测试报告和构建产物。
3. 配置 Jenkins 与 GitLab 集成
为了让 Jenkins 能够自动触发构建，我们需要将其与 GitLab 集成。具体步骤如下：
- 在 Jenkins 中安装
GitLab Plugin。 - 在 GitLab 项目中创建一个 Webhook，指向 Jenkins 的 URL（例如
http://jenkins-server:8080/gitlab/notify_commit）。 - 在 Jenkins 中配置 GitLab 项目的凭证和 URL。
完成这些配置后，每次你推送代码到 GitLab，Jenkins 都会自动触发构建。
使用 GitLab CI 实现 CI/CD
1. 创建 .gitlab-ci.yml
GitLab CI 的配置文件是 .gitlab-ci.yml，它定义了 CI/CD 管道的各个阶段。我们可以在项目的根目录下创建这个文件，内容如下：
stages:
- build
- test
- deploy
variables:
MAVEN_CLI_OPTS: "-Dmaven.test.failure.ignore=true"
before_script:
- apt-get update -y
- apt-get install maven -y
build:
stage: build
script:
- mvn $MAVEN_CLI_OPTS clean package
artifacts:
paths:
- target/*.jar
test:
stage: test
script:
- mvn $MAVEN_CLI_OPTS test
dependencies:
- build
deploy:
stage: deploy
script:
- scp target/*.jar user@server:/opt/app/
- ssh user@server "sudo systemctl restart app"
only:
- main这个配置文件定义了三个阶段：build、test 和 deploy。每个阶段都有对应的脚本，执行不同的任务。
- build：使用 Maven 构建项目，并将生成的 JAR 文件作为构建产物保存。
- test：运行单元测试。
- deploy：如果当前分支是
main，则将 JAR 文件上传到服务器并重启应用。
2. 配置 GitLab Runner
为了执行 CI/CD 管道，你需要安装并注册一个 GitLab Runner。Runner 是 GitLab CI 的执行器，负责在你的服务器上运行构建任务。
你可以使用以下命令安装并注册 GitLab Runner：
# 安装 GitLab Runner
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
sudo apt-get install gitlab-runner
# 注册 Runner
sudo gitlab-runner register在注册过程中，你需要提供 GitLab 实例的 URL 和注册令牌，这些信息可以在 GitLab 项目的“Settings > CI / CD”页面中找到。
3. 触发构建
一旦你完成了 .gitlab-ci.yml 和 GitLab Runner 的配置，每次你推送代码到 GitLab，CI/CD 管道就会自动触发。你可以在 GitLab 项目的“CI / CD > Pipelines”页面中查看构建状态和日志。
总结
通过今天的讲座，我们了解了如何使用 Jenkins 和 GitLab CI 为 Spring Boot 项目设置 CI/CD 流程。无论是 Jenkins 的灵活性还是 GitLab CI 的简洁性，都能帮助你提高开发效率，减少手动操作的错误。
当然，CI/CD 的世界远不止这些，还有很多高级功能等待你去探索。希望今天的分享对你有所帮助，祝你在 CI/CD 的道路上越走越顺！
如果你有任何问题或想法，欢迎在评论区留言，我们一起交流讨论！