使用 Jenkins 的流水线方案实施 CI/CD
一、Jenkins 环境准备(插件 + 工具配置)
1.安装必要插件
进入 Jenkins Web 界面 → 系统管理 → 插件管理 → 可选插件。
搜索并安装:
Maven Integration
(Maven 项目构建支持)。Publish Over SSH
(远程 SSH 部署)。GitLab Plugin
(若需 GitLab 触发流水线,可选)。
2.配置 Maven 工具
进入 Jenkins → 系统管理 → 全局工具配置。
找到 Maven 区域 → 点击 Maven 安装:
Name:自定义(如
maven-3.9.6
)。勾选 自动安装,版本 选择
3.9.6
→ 点击 保存。
3.配置 Publish Over SSH
(远程部署到 Docker 主机)
- 进入 Jenkins → 系统管理 → 系统配置。
- 找到 Publish over SSH 区域 → 点击 新增,配置 SSH 服务器:
- Name:自定义(如
DockerHost
)。 - Hostname:Docker 主机的 IP / 域名(如
192.168.197.9
)。 - Username:远程主机用户名(如
root
)。 - Remote Directory:远程部署目录(如
/opt/jenkins_deploy
,需提前创建)。 - 展开 高级 → 勾选
Use password authentication
→ 输入远程主机 密码 → 点击Test Configuration
(验证显示Success
)→ 应用 → 保存。
- Name:自定义(如
[root@host1 ~]# mkdir -p /opt/jenkins_deploy
[root@host1 ~]# ls -ld /opt/jenkins_deploy
drwxr-xr-x. 2 root root 6 9月 27 23:13 /opt/jenkins_deploy
[root@host1 ~]#
二、GitLab 与项目代码准备
1.GitLab 新建空白项目
登录 GitLab → New project → 选择 Create blank project。
项目名称:
java-demo
→ 点击 Create project。
2.克隆仓库到本地并准备代码
[root@host1 ch07]# cd ~/ch07
[root@host1 ch07]# git clone ssh://git@gitlab.abc.com:2222/root/java-demo.git
正克隆到 'java-demo'...
remote: Enumerating objects: 3, done.
remote: Counting objects: 100% (3/3), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
接收对象中: 100% (3/3), 完成.
[root@host1 ch07]# cd java-demo
[root@host1 java-demo]# cat > Dockerfile << EOF
FROM openjdk:18-jre
ARG app
ADD \$app app.jar
ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/app.jar"]
EOF
三、Jenkins 新建流水线项目
1.新建流水线任务
进入 Jenkins → 新建任务 → 任务名
java-demo
→ 选择 流水线 → 点击 确定。
2.配置源代码管理(关联 GitLab 仓库)
在项目配置页 → 源代码管理 → 选择 Git:
Repository URL:GitLab 项目的 SSH 地址(如
ssh://git@gitlab.abc.com:2222/root/java-demo.git
)。Credentials:选择之前配置的 GitLab SSH 凭据(若未配置,需先添加)。
Branches to build:改为
*/main
(GitLab 新仓库默认分支为main
)。
3.配置流水线(从 Git 拉取 Jenkinsfile
Pipeline 区域 → 选择 Pipeline script from SCM。
SCM 再次选择 Git → 重复仓库和凭据配置 → Script Path 填写
Jenkinsfile
→ 保存。
四、编写 Jenkinsfile(定义 CI/CD 流程)
在 java-demo
本地项目目录下,创建 Jenkinsfile
,内容如下(需根据实际项目调整变量):
[root@host1 ~]# cd ~/ch07
[root@host1 ch07]# cd java-demo
[root@host1 java-demo]# vi Jenkinsfile
[root@host1 java-demo]# cat Jenkinsfile
pipeline {agent anytools {// 关联全局工具配置的 Maven 名称maven 'maven-3.9.6'}stages {stage('Build') {steps {// Maven 编译打包(跳过测试)sh 'mvn -B -DskipTests clean package'}}stage('Test') {steps {// Maven 执行测试sh 'mvn test'}post {always {// 生成 JUnit 测试报告junit allowEmptyResults: true, testResults: 'target/surefire-reports/*.xml'}}}stage('Docker Build & Push') {steps {// 构建并推送 Docker 镜像到私有仓库sh '''APP_JAR=$(ls target/*.jar | head -1)docker build --build-arg app=$APP_JAR -t registry.abc.com:5000/spring-boot-demo .docker push registry.abc.com:5000/spring-boot-demodocker rmi registry.abc.com:5000/spring-boot-demo'''}}stage('Deploy to Docker Host') {steps {// 通过 Publish Over SSH 远程运行 Docker 容器sshPublisher(publishers: [sshPublisherDesc(configName: 'DockerHost', transfers: [sshTransfer(cleanRemote: false,execCommand: '''docker rm -f spring-boot-demo || truedocker run -d -p 8080:8080 --name spring-boot-demo \registry.abc.com:5000/spring-boot-demo''',execTimeout: 120000,sourceFiles: '')])])}}}environment {// 定义环境变量(根据项目实际情况修改)REGISTRY_URL = 'registry.abc.com:5000'CONTAINER_NAME = 'spring-boot-demo'IMAGE_NAME = 'spring-boot-demo'}
}
五、提交代码到 GitLab
# 添加所有文件到暂存区
[root@host1 java-demo]# git add .
# 提交代码
[root@host1 java-demo]# git commit -m "Init Java project with Jenkins CI/CD"
[main 4c6ffcc] Init Java project with Jenkins CI/CD2 files changed, 67 insertions(+)create mode 100644 Dockerfilecreate mode 100644 Jenkinsfile
# 推送代码到 GitLab(首次推送需关联分支)
[root@host1 java-demo]# git push --set-upstream origin main
枚举对象中: 5, 完成.
对象计数中: 100% (5/5), 完成.
使用 8 个线程进行压缩
压缩对象中: 100% (4/4), 完成.
写入对象中: 100% (4/4), 1.26 KiB | 430.00 KiB/s, 完成.
总共 4(差异 0),复用 0(差异 0),包复用 0(来自 0 个包)
To ssh://gitlab.abc.com:2222/root/java-demo.git9434c2c..4c6ffcc main -> main
分支 'main' 设置为跟踪 'origin/main'。
六、触发 Jenkins 流水线并验证
1.手动触发构建:
进入 Jenkins 的 java-demo
项目 → 点击 立即构建。
2.查看构建日志:
点击构建任务 → 控制台输出,查看各阶段(Build、Test、Docker Build & Push、Deploy)的执行日志。
3.验证部署结果:
在 Docker 主机执行以下命令,检查容器运行和应用访问:
[root@host1 java-demo]# curl http://192.168.197.9:8080
Hello from Spring Boot via Jenkins!
七、关键注意事项
确保
registry.abc.com:5000
私有镜像仓库已启动(参考前文 Docker Registry 部署步骤)。Publish Over SSH
的configName
需与系统配置中定义的 SSH 服务器名称一致。Maven 命令、Docker 镜像名、容器端口等需根据实际项目调整。
!!!部分纠错过程:
https://maven.aliyun.com/repository/public/org/apache/commons/commons-lang3/3.7/commons-lang3-3.7.jar
Downloaded from aliyunmaven: https://maven.aliyun.com/repository/public/com/google/guava/listenablefuture/9999.0-empty-to-avoid-conflict-with-guava/listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar (2.2 kB at 1.6 kB/s)
Downloaded from aliyunmaven: https://maven.aliyun.com/repository/public/org/checkerframework/checker-compat-qual/2.5.5/checker-compat-qual-2.5.5.jar (5.9 kB at 4.2 kB/s)
Downloaded from aliyunmaven: https://maven.aliyun.com/repository/public/com/google/j2objc/j2objc-annotations/1.3/j2objc-annotations-1.3.jar (8.8 kB at 5.5 kB/s)
Downloaded from aliyunmaven: https://maven.aliyun.com/repository/public/org/apache/commons/commons-lang3/3.7/commons-lang3-3.7.jar (500 kB at 310 kB/s)
Downloaded from aliyunmaven: https://maven.aliyun.com/repository/public/com/google/guava/guava/28.2-android/guava-28.2-android.jar (2.6 MB at 1.4 MB/s)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 52.768 s
[INFO] Finished at: 2025-09-28T01:31:32+08:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:2.7.12:repackage (repackage) on project java-demo: Execution repackage of goal org.springframework.boot:spring-boot-maven-plugin:2.7.12:repackage failed: Unable to find main class -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/PluginExecutionException
[root@host1 java-demo]# vi src/main/java/com/example/demo/DemoApplication.java
[root@host1 java-demo]# cat src/main/java/com/example/demo/DemoApplication.java
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}
}
[root@host1 java-demo]# git add src/main/java/com/example/demo/DemoApplication.java
[root@host1 java-demo]# git commit -m "Add Spring Boot main application class"
[main b7d9a73] Add Spring Boot main application class1 file changed, 13 insertions(+)create mode 100644 src/main/java/com/example/demo/DemoApplication.java
[root@host1 java-demo]# git push origin main
枚举对象中: 16, 完成.
对象计数中: 100% (16/16), 完成.
使用 8 个线程进行压缩
压缩对象中: 100% (4/4), 完成.
写入对象中: 100% (9/9), 732 字节 | 366.00 KiB/s, 完成.
总共 9(差异 1),复用 0(差异 0),包复用 0(来自 0 个包)
To ssh://gitlab.abc.com:2222/root/java-demo.git12fe51e..b7d9a73 main -> main
[root@host1 java-demo]# cat pom.xml4.0.0 org.springframework.boot spring-boot-starter-parent 2.7.12 com.example java-demo 0.0.1-SNAPSHOT java-demo Demo project for Spring Boot 1.8 org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-test test org.springframework.boot spring-boot-maven-plugin