win11下jenkins+docker+maven自动部署springboot项目

一、前置软件安装

1. docker安装

• 需要开启wsl，以管理员身份运行docker desktop

2. jenkins安装

• Jenkins需要Java运行环境，建议安装JDK 11或更高版本
• Jenkins的主目录默认会在C盘，可以修改到D盘

先停止jenkins服务，打开cmd执行

net stop jenkins

修改jenkins安装目录下的jenkins.xml文件

修改保存完之后，手动将C盘中的文件（.jenkins、jenkins.pid等）复制到新目录中
最后重启jenkins服务

net stop jenkins

3. git
4. maven

二、jenkins配置

1. 安装插件

• Maven Integration plugin： Maven 集成管理插件。
• Docker plugin： Docker集成插件。
• GitLab Plugin： GitLab集成插件。
• Publish Over SSH：远程文件发布插件。
• SSH: 远程脚本执行插件。
  

2. 配置工具

• maven
  
• jdk
  
• git
  
• maven安装
  
• docker
  

3. 配置git sh.exe的位置，后面会需要执行sh命令，没配置会报错
   
4. 提前创建凭据，主要用于后面拉取代码和远程连接
   
   其中从github中拉取代码时可以使用https和ssh两种方式，验证方式也分两种

• https方式需要配置token
  因为 GitHub 禁用了密码认证（自 2021 年 8 月 13 日起），需要使用 Token进行认证

生成 GitHub Token
1、 访问 GitHub → Settings → Developer Settings → Personal Access Tokens (Tokens Classic)
2 、点击 Generate new token (Classic)
3 、填写 Note（如 Git CLI Access）
4 、勾选 repo（至少需要 repo 权限）
5 、点击 Generate token，并复制 Token（只会显示一次，请保存好！

• ssh方式
  需要生成公钥添加到github中，配置的时候填私钥

步骤 1：生成 SSH Key
bash
ssh-keygen -t ed25519 -C “[e-mail]”
（按 Enter 默认选项，生成的密钥在 ~/.ssh/ 目录）
步骤 2：添加 SSH Key 到 GitHub
查看公钥：
bash
cat ~/.ssh/id_ed25519.pub
复制公钥内容，进入 GitHub → Settings → SSH and GPG keys → New SSH Key，粘贴并保存。

配置私钥后如果还是验证失败，在 Jenkins 全局配置中禁用严格主机检查（不推荐生产环境）
进入 Manage Jenkins > Security 找到 Git Host Key Verification Configuration，选择 Accept first connection（仅临时测试用）。

三、springboot项目准备

项目结构

pom文件使用dockerfile插件

	<properties><java.version>8</java.version><docker.image>docker_repo</docker.image></properties><build><finalName>demo</finalName><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><executions><execution><goals><goal>repackage</goal></goals></execution></executions></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.7.0</version><configuration><source>${java.version}</source><target>${java.version}</target></configuration></plugin><plugin><groupId>com.spotify</groupId><artifactId>dockerfile-maven-plugin</artifactId><version>1.4.13</version><configuration><!-- 指定docker镜像仓库名称 --><repository>${docker.image}/${project.artifactId}</repository><buildArgs><!-- Dockerfile中使用 ARG AR_FILE 指令引用变量 --><JAR_FILE>target/${project.build.finalName}.jar</JAR_FILE></buildArgs></configuration></plugin></plugins></build>

多环境配置

Dockerfile放在根目录下

# 需要依赖的基础镜像
FROM openjdk:8-jdk# 指定存储卷, 任何向/tmp写入的信息都不会记录到容器存储层
VOLUME /tmp# 拷贝运行JAR包
ARG JAR_FILE
COPY ${JAR_FILE} app.jar# 设置JVM运行参数， 这里限定下内存大小，减少开销
ENV JAVA_OPTS="\
-server \
-Xms256m \
-Xmx512m \
-XX:MetaspaceSize=256m \
-XX:MaxMetaspaceSize=512m"#空参数，方便创建容器时传参
ENV PARAMS=""# 入口点， 执行JAVA运行命令
ENTRYPOINT ["sh","-c","java -jar $JAVA_OPTS /app.jar $PARAMS"]# 指定维护者的名字
MAINTAINER chen

将项目代码提交到github中

四、jenkins打包部署项目到本地docker中

1. 构建任务
   
2. 添加描述，可以勾选创建string类型的变量
   
   
3. 配置git仓库地址，验证方式前面步骤已创建好，这里使用ssh方式拉取代码
   
4. 增加构建步骤，maven打包
   
   

clean install -Dmaven.test.skip=true  dockerfile:build -f pom.xml

-Dmaven.test.skip=true 跳过测试
dockerfile:build 启动dockerfile插件构建容器
-f pom.xml 指定需要构建的文件（必须是pom）

5. 增加构建步骤，执行shell脚本
   
   

if [ -n  "$(docker ps -a -f  name=$JOB_NAME  --format '{{.ID}}' )" ]then#删除之前的容器docker rm -f $(docker ps -a -f  name=$JOB_NAME  --format '{{.ID}}' )
fi# 清理镜像
docker image prune -f # 启动docker服务
docker run -d -p 6688:6688 -e PARAMS="--spring.profiles.active=prod" --name $JOB_NAME $docker_image/$JOB_NAME

-p 端口映射
$JOB_NAME jenkins的内置变量，任务名
$docker_image 自定义的参数

保存任务

6. 执行任务
   任务执行前先启动docker，以管理员身份运行docker desktop
   
   执行构建时可以查看日志
   
   构建完成，在docker验证容器是否启动
   
   测试接口，成功！
   

五、jenkins打包部署项目到远程服务器docker中

本地docker将镜像推送到私有仓库中，虚拟机中的docker从私有仓库中拉取镜像并启动容器

1. 配置本地docker

Docker 默认要求私有仓库使用 HTTPS，但本地测试通常用 HTTP。需要修改 Docker 配置：

右键 Docker 托盘图标 → Settings (设置)
进入 Docker Engine 配置 添加：
{
“insecure-registries”: [“192.168.xxx.xxx:5000”]
}
点击 Apply & Restart 重启 Docker。

2. 下载最新Registry镜像

docker pull registry:latest

3. 启动Registry镜像服务

docker run -d -p 5000:5000 --name registry -v /usr/local/docker/registry:/var/lib/registry registry:latest

映射5000端口； -v是将Registry内的镜像数据卷与本地文件关联， 便于管理和维护Registry内的数据。

4. 查看仓库资源
   访问地址：http://localhost:5000/v2/_catalog 启动正常， 可以看到返回：

   {"repositories":[]}

目前并没有上传镜像， 显示空数据。如果上传成功， 可以看到数据:

5. 远程服务器开启ssh

• 安装OpenSSH服务器

sudo apt update
sudo apt install openssh-server

• 检查SSH服务状态

sudo systemctl status ssh

• 配置防火墙

sudo ufw allow ssh
# 或者直接指定端口
sudo ufw allow 22/tcp

• 开启root密码认证
  修改/etc/ssh/sshd_config中的配置

Port 22                   # 确保端口正确（默认22）
PermitRootLogin yes      # 启用root密码登录
StrictModes no               # 关闭严格模式
PasswordAuthentication yes        # 必须设为yes（允许密码登录）
PubkeyAuthentication yes          # 公钥认证（可选）

修改完重启ssh服务

sudo systemctl restart ssh

6. 远程服务器docker配置

• 修改docker配置，添加 “insecure-registries”: [“192.168.xxx.xxx:5000”]

vim /etc/docker/daemon.json

• 重启docker服务

systemctl restart docker

7. jenkins中配置远程服务器（确保安装了Publish Over SSH和SSH插件）
   
8. 开始构建任务

• 新建item
  
• 添加描述，配置参数

描述

参数docker_registry

参数docker_image

• 源码管理git
  
• 增加构建步骤 1.maven

clean install -Dmaven.test.skip=true dockerfile:build -f pom.xml

• 增加构建步骤 2.执行shell脚本

image_tag=$docker_registry/$docker_image/$JOB_NAME
echo '================docker镜像清理================'
if [ -n  "$(docker ps -a -f  name=$JOB_NAME  --format '{{.ID}}' )" ]then#删除之前的容器docker rm -f $(docker ps -a -f  name=$JOB_NAME  --format '{{.ID}}' )
fi# 清理镜像
docker image prune -f # 创建TAG
docker tag $docker_image/$JOB_NAME $image_tag
echo '================docker镜像推送================'
# 推送镜像
docker push $image_tag
# 删除TAG
docker rmi $image_tag
echo '================docker tag 清理 ================'

• 增加构建步骤 3. 在远程服务器上执行脚本

echo '================拉取最新镜像================'
docker pull $docker_registry/$docker_image/$JOB_NAMEecho '================删除清理容器镜像================'
if [ -n  "$(docker ps -a -f  name=$JOB_NAME  --format '{{.ID}}' )" ]then#删除之前的容器docker rm -f $(docker ps -a -f  name=$JOB_NAME  --format '{{.ID}}' )
fi# 清理镜像
docker image prune -f echo '===============启动容器================'
docker run -d -p 6688:6688 -e PARAMS="--spring.profiles.active=prod" --name $JOB_NAME $docker_registry/$docker_image/$JOB_NAME

保存任务

9. 执行任务
   执行任务前先启动docker，并且启动registry容器，确保registry容器正常运行
   
   启动jenkins任务

任务执行时可以查看日志

10. 登录远程服务器，验证容器是否启动

测试接口，成功！