Jenkins中自动化部署Spring Boot项目的全过程

更新时间：2025年01月06日 10:03:43 作者：编程洪同学

这篇文章主要介绍了如何使用Jenkins从Git仓库拉取SpringBoot项目并进行自动化部署,通过配置Jenkins任务,实现项目的构建、镜像构建和容器运行,确保项目在更新时自动部署,需要的朋友可以参考下

准备工作

本文将介绍如何使用 Jenkins 从仓库中拉取项目，经过打包、构建镜像、运行容器等步骤，最终将 Spring Boot 项目部署到服务器上供用户访问。并且当项目有更新时，自动触发 Jenkins 任务，实现自动化部署。

在开始之前，需要先创建一个 Spring Boot 项目，提供一些测试的接口。在确保项目正常运行的情况下，将项目推送到 Git 远程仓库。

Spring Boot 项目文件目录结构：

Dockerfile 文件内容：

FROM bellsoft/liberica-openjdk-debian:17.0.11-cds

LABEL maintainer="hayden"

RUN mkdir -p /demo/server/logs \
    /demo/server/temp

WORKDIR /demo/server

ENV SERVER_PORT=8080 LANG=C.UTF-8 LC_ALL=C.UTF-8 JAVA_OPTS="-Xms512m -Xmx512m"

EXPOSE ${SERVER_PORT}

ADD ./target/demo.jar ./app.jar

ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -Dserver.port=${SERVER_PORT} \
           -XX:+HeapDumpOnOutOfMemoryError -XX:+UseZGC ${JAVA_OPTS} \
           -jar app.jar

启动 Jenkins

使用 docker-compose 构建 Jenkins 容器。

文件树结构：

.
├── docker-compose.yml
└── jenkins
    ├── jenkins_config
    └── jenkins_home

docker-compose.yml 文件内容：

version : '3.0.01'
services:
  jenkins:
  container_name: jenkins
  image: jenkins/jenkins:lts-jdk17
  restart: unless-stopped
  ports:
    - "10000:8080"
  volumes:
    # 数据卷挂载路径设置,将本机目录映射到容器目录 (下面映射可在容器中执行宿主机docker命令)
    - "/usr/bin/docker:/usr/bin/docker"
    - "/var/run/docker.sock:/var/run/docker.sock"
    - "/usr/lib64/libltdl.so.7:/usr/lib/x86_64-linux-gnu/libltdl.so.7"
    #      - "/usr/local/bin/docker-compose:/usr/local/bin/docker-compose"  # 无效
    - "./jenkins/jenkins_home:/var/jenkins_home"
    # ThinBackup插件备份jenkins配置存储目录
    - "./jenkins/jenkins_config:/var/jenkins_config"
    # 解决jenkins安装插件报错： An error occurred during installation: No such plugin: cloudbees-folder
    # 下载地址  http://ftp.icm.edu.pl/packages/jenkins/plugins/cloudbees-folder/
    #      - "./jenkins/jenkins_home/war/META-INF/detached-plugins/cloudbees-folder.hpi:/var/jenkins_home/war/META-INF/detached-plugins/cloudbees-folder.hpi"
  environment:
    TZ: Asia/Shanghai
    LANG: en_US.UTF-8
    JAVA_OPTS: -Xmx512M -Xms512M -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -XX:MaxNewSize=128m -Djava.util.logging.config.file=/var/jenkins_home/log.properties -Duser.timezone=Asia/Shanghai
  user: root # 使用root权限运行容器（docker中通过`-u root`命令）

启动 Jenkins 容器：

docker-compose up -d jenkins

开放 10000 端口，允许外部访问：

firewall-cmd --zone=public --add-port=10000/tcp --permanent
firewall-cmd --reload

配置 Jenkins

在浏览器中输入 http://[ip]:10000 访问 Jenkins。经过一系列设置，完成 Jenkins 的初始化。

在系统管理->全局工具配置中配置 JDK，以 JDK 17 为例：

安装 URL：https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.tar.gz

在系统管理->全局工具配置中配置 Maven，以 Maven 3.9 为例：

下载完 Maven 后还需要修改镜像地址，避免出现下载速度过慢的问题：

# 进入 Maven 配置文件目录
cd jenkins/jenkins_home/tools/hudson.tasks.Maven_MavenInstallation/
# 编辑配置文件
vim maven-3.9.9/conf/settings.xml

# 替换原镜像地址
<mirror>
  <id>alimaven</id>
  <name>aliyun maven</name>
  <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>
</mirror>

::: tip 注意

使用 Jenkins 的安装方式中，会将软件安装到对应目录的下一层目录，例如 JDK 安装

到 jenkins/jenkins_home/tools/hudson.model.JDK/jdk-17/jdk-17.0.12，导致出现找不到 JDK 的问题。

解决方法：来到对应的目录中，将 JDK 的目录移动到上一层目录即可。

cd jenkins/jenkins_home/tools/hudson.model.JDK/jdk-17
mv jdk-17.0.12/* .
rm -rf jdk-17.0.12

:::

创建及配置任务

在 Jenkins 主页点击新建任务，选择构建一个 maven 项目，点击确定：

源码管理

在源码管理中选择 Git，填写仓库地址、凭证、分支等信息：

构建触发器

在构建触发器中选择 Generic Webhook Trigger，填写 Token，点击应用：

这时来到 Git 远程仓库的 Webhook 配置页面，填写 Jenkins URL 和 Token，点击添加：

URL 格式：http://[ip]:10000/generic-webhook-trigger/invoke?token=Token

构建

由于 pom.xml 在项目根目录下，所以这边默认使用 pom.xml 进行构建：

构建后操作

勾选 Run only if build succeeds，填写 Shell 脚本：

# 删除旧容器
docker rm -f my-spring-boot
# 删除旧镜像
docker rmi -f my-spring-boot:latest
# 构建新镜像
docker build -t my-spring-boot .
# 运行容器
docker run --name my-spring-boot -p 8080:8080 -d my-spring-boot:latest

点击保存，任务配置完成。

构建任务

在 Jenkins 主页点击任务名称，点击立即构建，可以看到正在构建的历史过程。点击构建历史中的任务，可以查看详细的构建日志：

多尝试几次，确保构建成功。

测试

在浏览器中输入指定 URL，可以看到项目已经部署成功。并且当 Git 仓库中的项目有更新时，Jenkins 会自动触发任务，实现自动化部署：

总结

到此这篇关于Jenkins中自动化部署Spring Boot项目的文章就介绍到这了,更多相关Jenkins自动化部署SpringBoot项目内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java中final、static关键字与方法的重写和继承易错点整理
这篇文章主要给大家介绍了关于Java中final、static关键字与方法的重写和继承易错点的相关资料,在Java编程中final关键字用于限制方法或类的进一步修改,final方法不能被子类重写,而static方法不可被重写,只能被遮蔽,需要的朋友可以参考下
2024-10-10
LocalDateTime日期时间格式中间多了一个T的问题及解决
这篇文章主要介绍了LocalDateTime日期时间格式中间多了一个T的问题及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
SpringBoot 使用 Sa-Token 完成注解鉴权功能(权限校验)
Sa-Token 是一个轻量级 java 权限认证框架，主要解决登录认证、权限认证、单点登录、OAuth2、微服务网关鉴权等一系列权限相关问题，这篇文章主要介绍了SpringBoot使用Sa-Token完成注解鉴权功能,需要的朋友可以参考下
2023-05-05
详解springboot中的jar包部署步骤
这篇文章主要介绍了springboot中的jar包部署步骤及linux中部署项目常用指令，需要的朋友可以参考下
2018-07-07
SpringBoot逻辑异常统一处理方法
这篇文章主要介绍了SpringBoot逻辑异常统一处理方法,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-10-10
Spring中存对象和取对象的方式详解
这篇文章主要介绍了Spring中存对象和取对象的方式,Spring中更简单的存对象与取对象的方式是注解,注解实现有两种方式：一在编译的时候,把注解替换成相关代码,并添加到我们原来的代码中,二拦截方法,文中有详细的代码示例供大家参考,需要的朋友可以参考下
2024-08-08
Spring Boot Jar 包部署脚本的实例讲解
在本篇文章里小编给大家整理的是一篇关于Spring Boot Jar 包部署脚本的实例讲解内容，对此有兴趣的朋友们可以跟着学习下。
2021-12-12
linux用java -jar启动jar包缓慢的问题
这篇文章主要介绍了linux用java -jar启动jar包缓慢的问题,具有很好的参考价值,希望对大家有所帮助,
2023-09-09
Springboot单元测试无法读取配置文件的解决方案
这篇文章主要介绍了Springboot单元测试无法读取配置文件的解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-01-01
eclipse连接不到genymotion问题的解决方案
今天小编就为大家分享一篇关于eclipse连接不到genymotion问题的解决方案，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2019-03-03