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

Docker+Jenkins自动化部署SpringBoot项目【详解git，jdk，maven，ssh配置等各种配置，附有示例+代码】

news 2025/12/4 8:42:34

文章目录

Docker+Jenkins部署SpringBoot项目
一.准备工作
- 1.1安装jdk11
- 1.2安装Maven
二.Docker安装Jenkins
- 2.1安装Docker
- 2.2 安装Jenkins
- 2.3进入jenkins
三.Jenkins设置
- 3.1安装jenkins插件
- 3.2全局工具配置
- - 全局配置jdk
  - 全局配置maven
  - 全局配置git
- 3.3 系统配置
- - 安装 Publish Over SSH 插件
  - 配置 SSH 服务器
  - Gitee 配置
  - 添加 Gitee配置
四.构建项目
- 4.0 准备工作
- 4.1构建项目一
- - 4.1.1 新建项目
  - 4.1.2 配置源码管理
  - 4.1.3 构建触发器
- 4.2 构建项目二

Docker+Jenkins部署SpringBoot项目

在这里插入图片描述

Jenkins 是一个流行的开源自动化服务器，主要用于 持续集成（CI） 和 持续部署（CD），它可以帮助开发团队自动化构建、测试和部署过程，提高软件开发效率。

Jenkins 的作用

持续集成（CI，Continuous Integration）

每次代码提交后自动构建和测试，确保代码的正确性。
及时发现问题，提高团队协作效率。
减少“集成地狱”，即多人开发时的代码合并问题。

持续部署（CD，Continuous Deployment / Delivery）

持续交付（Continuous Delivery）：代码经过自动化测试和打包后，能够手动部署到生产环境。
持续部署（Continuous Deployment）：在持续交付的基础上，自动化发布到生产环境。

一.准备工作

1.1安装jdk11

安装jdk1.8会出兼容性问题，建议安装jdk11

首先在 /usr/local 下创建java文件夹，将openjdk-11+28_linux-x64_bin.tar压缩包在次文件下解压缩，

在这里插入图片描述

解压缩后查看Java文件夹中的东西，出现jdk-11,解压成功。

在这里插入图片描述

配置环境变量, 注意路径

vim /etc/profile

在这里插入图片描述

#刷新配置文件
source /etc/profile
#查看版本
java -version

在这里插入图片描述

1.2安装Maven

https://maven.apache.org/docs/history.html

这里安装的是maven3.8.6

使用root用户登录linux

#解压
tar -zxvf apache-maven-3.8.6-bin.tar.gz
#移动到/usr/local
mv apache-maven-3.8.6 /usr/local
#进入/usr/local
cd /usr/local
#重命名为maven
mv apache-maven-3.8.6/ maven
#配置环境变量
vim /etc/profile
{
export MAVEN_HOME=/usr/local/maven
export PATH=$PATH:$MAVEN_HOME/bin
}

在这里插入图片描述

查看maven版本是否安装成功：

在这里插入图片描述

在maven文件夹下创建maven仓库目录

mkdir mavenRepository

编辑配置文件,配置Maven加速镜像地址和本地仓库目录

#创建maven仓库目录
mkdir /usr/local/maven/ck
#编辑配置文件
vim /usr/local/maven/conf/settings.xml

<localRepository>/usr/local/maven/ck</localRepository><mirrors><mirror><id>alimaven</id><name>aliyun maven</name><url>http://maven.aliyun.com/nexus/content/groups/public/</url><mirrorOf>central</mirrorOf></mirror></mirrors>

在这里插入图片描述

二.Docker安装Jenkins

2.1安装Docker

略，请查看《Centos7安装Docker》

2.2 安装Jenkins

#创建jenkins_home数据挂载目录
mkdir /mnt/jenkins_home
#赋值权限，否则后慢慢挂载会失败，这里我们给最高权限
chmod -R 777 /mnt/jenkins_home
#拉取jenkins镜像
docker pull jenkins/jenkins:lts-jdk11#启动jenkins容器
docker run -d --name=jenkins -p 8081:8080 --privileged=true \
-v /mnt/jenkins_home:/var/jenkins_home \
-v /usr/local/java/jdk-11:/usr/local/java/jdk-11 \
-v /usr/local/maven:/usr/local/maven \
-v $(which docker):/usr/bin/docker \
-v /var/run/docker.sock:/var/run/docker.sock jenkins/jenkins:lts-jdk11
#授予docker的操作权限给jenkins等容器使用
chmod a+rw /var/run/docker.sock

参数说明：
-v /mnt/jenkins_home:/var/jenkins_home：是对容器内存储Jenkins的一些配置信息的文件夹
-v /usr/local/java/jdk-11:/usr/local/java/jdk-11：是把linux下的jdk和容器内的关联（配置Jenkins时使用）
-v /usr/local/maven:/usr/local/maven：是把linux下的maven和容器内的关联（配置Jenkins时使用）
-v $(which docker):/usr/bin/docker：是把linux下的docker和容器内的关联
-v /var/run/docker.sock:/var/run/docker.sock：是可以在Jenkins容器里使用我们Linux下的docker。

如果出现上图错误，尝试docker rm -f $(docker ps -a -q)

然后在执行上述的启动jenkins命令。

2.3进入jenkins

启动：service jenkins start
重启：service jenkins restart
停止：service jenkins stop

在这里插入图片描述

获取初始密码

#查看容器id
docker ps
#查看jenkins容器日志
docker logs (jenkins容器id)

在这里插入图片描述

6ea9894b9ab1408fb8f85ef7487e3678

三.Jenkins设置

3.1安装jenkins插件

此处本人先按照的csdn上的文档进行的<安装推荐的插件>方式，但是选择这个方式安装插件后续会出错，已经亲身尝试过三次，均出错。所以在后面选择了《选择插件来安装》的方式来安装插件。

在这里插入图片描述

进入Jenkins管理后台
在这里插入图片描述

在这里插入图片描述

依次搜索安装 Maven Integration 和 Publish Over SSH 以及 Gitee 三个插件安装即可

在Jenkins启动成功后，安装以下三个插件能够增强其功能，满足特定的项目需求：

Gitee
功能：Gitee插件允许Jenkins与Gitee代码仓库集成，支持从Gitee仓库中拉取代码、触发构建任务。这对于使用Gitee进行源代码管理的团队非常有用，能简化CI/CD流程。
安装：在“插件管理”界面，搜索“Gitee”插件并安装。安装后，可以在Jenkins的项目配置中添加Gitee仓库的访问信息，配置Webhook以便代码提交时自动触发构建。
Maven Integration
功能：Maven Integration插件允许Jenkins与Maven无缝集成，使得Jenkins可以直接调用Maven进行项目的构建、测试和打包。这对于Java项目尤其重要，因为Maven能够自动管理项目依赖、编译代码，并生成可部署的包（如JAR、WAR）。
安装：在Jenkins管理界面中，导航到“插件管理” -> “可选插件”，搜索“Maven Integration”并点击“安装”。
Publish Over SSH
功能：Publish Over SSH插件允许Jenkins通过SSH将构建生成的文件（如JAR、WAR包）安全地传输到远程服务器上。这对于部署过程至关重要，尤其是当需要将构建产物自动部署到生产或测试服务器时。
安装：同样在“插件管理”界面，搜索“Publish Over SSH”并安装。安装后，你可以在“系统管理”中配置SSH服务器的连接信息。
通过安装这些插件，Jenkins能够更好地支持项目构建、打包、部署和代码管理，大大提高自动化部署的效率和灵活性。

在这里插入图片描述

3.2全局工具配置

全局配置jdk 、maven、git

全局配置jdk

为什么需要：Jenkins本身是基于Java的应用，并且许多构建工具（如Maven、Gradle）也依赖JDK。因此，配置JDK是必不可少的。
配置方法：在Jenkins的“系统管理” -> “全局工具配置”中，找到JDK配置部分，点击“添加JDK”，指定JDK的安装路径，或者选择自动安装。

在这里插入图片描述

全局配置maven

为什么需要：Maven是Java项目构建的标准工具，用于依赖管理、代码编译、测试和打包。通过配置Maven，Jenkins可以调用Maven进行项目构建。
配置方法：在“全局工具配置”中找到Maven配置部分，点击“添加Maven”，指定Maven的安装路径，或者选择自动安装。

在这里插入图片描述

全局配置git

为什么需要：大多数项目都使用Git进行源代码管理。通过配置Git，Jenkins可以从Git仓库中拉取代码并进行构建。
配置方法：在“全局工具配置”中找到Git配置部分，添加Git安装路径，或者选择自动安装。确保Jenkins可以访问正确版本的Git（由于 Jenkins 容器中已经存在 git 了，所以这里不需要额外安装 git，默认即可）。

在这里插入图片描述

3.3 系统配置

安装 Publish Over SSH 插件

在3.1中已经安装过，跳过即可

配置 SSH 服务器

插件安装完成后，返回“系统管理”页面，选择“系统配置”或“Configure System”。

向下滚动页面，找到 Publish Over SSH 部分。

点击“添加”按钮，配置一个新的SSH服务器：

Name: 为服务器配置一个易记的名称。
Hostname: 输入目标服务器的IP地址或主机名。
Username: 输入用于登录到目标服务器的用户名。
Remote Directory: 指定在远程服务器上的默认目录，Jenkins将把构建产物传输到此目录。

点击“测试配置”或“Test Configuration”按钮，验证Jenkins是否能够成功连接到目标服务器。

在这里插入图片描述

保存配置，配置完成后，点击页面底部的“保存”或“应用”按钮，以确保你的设置被保存。

Gitee 配置

通过配置Gitee，Jenkins能够与Gitee代码仓库集成，实现代码的自动拉取和构建。

同样在Jenkins的插件管理中，搜索Gitee并安装该插件（安装过可以忽略此步骤。）
获取 Gitee API Token

登录到Gitee账户，

在设置里面找到“私人令牌”部分，点击“生成新的令牌”。

根据需要选择令牌的权限，例如“repo”（代码仓库相关操作）和“user_info”（用户信息查看）。

生成令牌后，复制并保存。

007cfbfae48459bf61866aa9cf973d93

007cfbfae48459bf61866aa9cf973d93

添加 Gitee配置

在“系统配置”页面，找到Gitee 配置。
配置你的Gitee仓库信息：
- 链接名: 输入你的Gitee仓库的URL（HTTPS），即就是你自己创建的gitee仓库地址。
- Gitee域名URL: 输入Gitee域名完整URL地址。
- 证书令牌: 选择Gitee API令牌。

在这里插入图片描述

通过上述步骤，就已经在Jenkins中完成了 Publish Over SSH 和 Gitee 的配置。这些配置使得Jenkins能够安全地将构建产物部署到远程服务器，同时自动拉取和构建Gitee上的代码，为CI/CD流程提供了基础支持。

最后重启jenkins，如图：

在这里插入图片描述

四.构建项目

4.0 准备工作

首先在idea创建一个测试的工程项目：demo,

然后手动创建Dockerfile文件：如图

在这里插入图片描述

#使用OpenJDK 11 JRE精简版作为基础镜像。
FROM openjdk:11-jre-slim#设置环境变量PARAMS为空字符串
ENV PARAMS=""#将当前目录下的所有JAR文件添加到镜像中的/demo.jar。
ADD *.jar /demo.jar#设置容器启动时执行的命令为使用java -jar运行/demo.jar，并传递环境变量PARAMS。
ENTRYPOINT ["sh","-c","java -jar /demo.jar $PARAMS"]

在这里插入图片描述

修改pom文件，为了打包顺利

在这里插入图片描述

如果不将<skip>xxxx</skip>注释掉再加个打包后缀名，当执行打好的jar包时会出错，如图：

然后，进行打包

在这里插入图片描述

4.1构建项目一

在Jenkins中新建一个Maven项目的步骤如下：

4.1.1 新建项目

在Jenkins首页，点击左侧菜单中的“新建任务”或“New Item”。
在弹出的窗口中，为项目输入一个名称，然后选择“构建一个Maven项目”或“Maven Project”。
点击“确定”进入项目配置页面。

在这里插入图片描述

4.1.2 配置源码管理

在项目配置页面，找到“源码管理”部分。
选择你使用的版本控制系统（如Git），并输入项目的代码仓库URL。
如果仓库需要认证，配置相应的凭证（Credentials），如用户名和密码或SSH密钥。
设置仓库中触发构建的分支代码（*/release表示release分支有代码提交则自动触发构建）。

在这里插入图片描述

4.1.3 构建触发器

配置构建触发器，这可以是轮询SCM（Poll SCM）、Webhook触发、定时构建等。
例如，如果你希望在每次代码提交时触发构建，可以选择“GitHub hook trigger for GITScm polling”或“Poll SCM”，并设置合适的时间间隔。

在这里插入图片描述

#!/bin/bash
# 服务名称
SERVER_NAME=demo
# 源jar名称，mvn打包之后，target目录下的jar包名称
JAR_NAME=demo-1.0.0-SNAPSHOT
# jenkins下的目录
JENKINS_HOME=/mnt/jenkins_home/workspace/demo
# 等待三秒
echo sleep 3s
sleep 1
echo sleep 2s
sleep 1
echo sleep 1s
sleep 1
echo "结束进程完成"
cd $JENKINS_HOME/target
cp $JENKINS_HOME/Dockerfile $JENKINS_HOME/target
# 修改文件权限
chmod 755 $JAR_NAME.jar
echo "看看docker能不能用"
docker -v
echo "停止容器"
# 停止容器
docker stop demo
echo "删除容器"
# 删除容器
docker rm demo
echo "删除镜像"
# 删除镜像
docker rmi demo
echo "打包镜像"
# 打包镜像
docker build -t demo 
echo "运行镜像"
# 运行镜像
docker run -d -p 9999:9999 --name demo demo

此时点击立即构建，会失败。

在这里插入图片描述

点开之后可以看见构建信息：

在这里插入图片描述

4.2 构建项目二

项目一失败了，再继续再创建新的项目，步骤和一类似

在这里插入图片描述

将以下内容复制在deploy.sh文件中

在这里插入图片描述

export JAVA_HOME=/opt/java
export PATH=$JAVA_HOME/bin:$PATHJAR_PATH=/root/dataJARFILE=demo-0.0.1-SNAPSHOT-kwh.jarps -ef | grep $JARFILE | grep -v grep | awk '{print $2}' | xargs kill -9java -jar $JAR_PATH/$JARFILE > out.log &
if [ $? = 0];thensleep 30tail -n 50 out.log
fils -lt|awk 'NR>${print $NF}'|xargs rm -rf

在这里插入图片描述

最后保存。

在这里插入图片描述

点开可以查看构建信息。

在这里插入图片描述

工作空间可以看到构建之后的项目结构

在这里插入图片描述

此时这个项目构建成功。

如何运行构建的项目呢？查看构建信息

在这里插入图片描述

然后进入这个文件夹下

在这里插入图片描述

运行demo-0.0.1-SNAPSHOT-kwh.jar，此时idea是没有任何运行程序的。

在这里插入图片描述

然后测试：

在这里插入图片描述

此时jenkins自动化部署项目已经实现。

可能有人会问自动二字体现在何处？莫急莫急，

此时假如你在idea中修改了代码，提交推送到远程仓库，此时由于已经配置jenkins自动化部署，当你将代码推送到远程后，在jenkines中会自动触发构建项目的过程，你只需刷新浏览器即可，就能看到修改的内容，如图：

在这里插入图片描述
推送到远程仓库：

在这里插入图片描述

推送到远程成功，会立即触发jenkins自动构建项目

在这里插入图片描述

此时刷新浏览器即可看到更新内容：（注：由于这里本人没有配置好webhooks自动触发器设置，在这里先手动模拟Jenkins自动构建）

根据上述构建信息找到jar包位置

在这里插入图片描述

手动运行jar包

在这里插入图片描述

刷新浏览器：构建成功。

在这里插入图片描述

学习参考文档：https://blog.csdn.net/qq_51447436/article/details/141194535https://blog.csdn.net/weixin_43755251/article/details/127566967阿里云社区
https://developer.aliyun.com/article/1288762

文章目录

Docker+Jenkins部署SpringBoot项目

一.准备工作

1.1安装jdk11

1.2安装Maven

二.Docker安装Jenkins

2.1安装Docker

2.2 安装Jenkins

2.3进入jenkins

三.Jenkins设置

3.1安装jenkins插件

3.2全局工具配置

全局配置jdk

全局配置maven

全局配置git

3.3 系统配置

安装 Publish Over SSH 插件

配置 SSH 服务器

Gitee 配置

添加 Gitee配置

四.构建项目

4.0 准备工作

4.1构建项目一

4.1.1 新建项目

4.1.2 配置源码管理

4.1.3 构建触发器

4.2 构建项目二

相关文章：