当前位置: 首页 > news >正文

使用 Jenkins 的流水线方案实施 CI/CD

使用 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)→ 应用 → 保存
[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.0org.springframework.bootspring-boot-starter-parent2.7.12com.examplejava-demo0.0.1-SNAPSHOTjava-demoDemo project for Spring Boot1.8org.springframework.bootspring-boot-starter-weborg.springframework.bootspring-boot-starter-testtestorg.springframework.bootspring-boot-maven-plugin

http://www.hskmm.com/?act=detail&tid=21085

相关文章:

  • 加密的病例单
  • 详细介绍:视频融合平台EasyCVR构筑智慧交通可视化管理与智能决策中枢
  • docker 在x86上build arm 镜像
  • 9.29软工
  • 不一样的.NET烟火,基于Roslyn的开源代码生成器
  • 复刻江协旋钮控制模块
  • 告别硬编码!5个让Web自动化脚本更稳定的定位策略
  • 从零开始,使用Idea工具搭建一个springboot项目
  • 最优/极值问题的算法选择
  • 第三方控件库的添加和使用
  • C4NR PVP服务器1.2 天穹炮塔更新
  • 树形dp [JOI Open 2020] 发电站 / Power Plant
  • 深入解析:灵画-AI绘画小程序
  • AT_arc156_b [ARC156B] Mex on Blackboard
  • 产品排序
  • 环形链表II-leetcode
  • ubuntu20.04安装nvidia显卡
  • [线段树系列 #6] 标记永久化
  • 9.29
  • c语言switch和if语句
  • Qt(制作一个方便的文本编辑器)
  • Java EE初阶启程记05---线程安全 - 指南
  • DataGridView表格控件使用说明
  • 题解:P7126 [Ynoi2008] rdCcot
  • 个人微信机器人开发api接口
  • MyBatis技术详解:从入门到高效开发 - 详解
  • 解码数据结构队列
  • 解决升级 Windows 11 24H2 后 NAS 共享无法显示的问题
  • 【还未找到原题】宝石(GEM) - Harvey
  • 第八篇