【最全最详细】Jenkins+Docker 一键自动化部署 SpringBoot 项目

不念不忘少年蓝@ 2024-04-06 09:38 9阅读 0赞

本文章实现最简单全面的`Jenkins+docker+springboot` 一键自动部署项目，步骤齐全，少走坑路。

> 环境：centos7+git(gitee)

简述实现步骤：在docker安装jenkins，配置jenkins基本信息，利用Dockerfile和shell脚本实现项目自动拉取打包并运行。

### 一、安装docker ###

docker安装社区版本CE

1.确保 yum 包更新到最新。

yum update

2.卸载旧版本(如果安装过旧版本的话)

yum remove docker  docker-common docker-selinux docker-engine

3.安装需要的软件包

yum install -y yum-utils device-mapper-persistent-data lvm2

4.设置yum源

yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

5.安装docker

yum install docker-ce  #由于repo中默认只开启stable仓库，故这里安装的是最新稳定版17.12.0
    yum install <自己的版本>  # 例如：sudo yum install docker-ce-17.12.0.ce

6.启动和开机启动

systemctl start docker
    systemctl enable docker

7.验证安装是否成功

docker version

### 二、安装Jenkins ###

Jenkins中文官网：

> https://www.jenkins.io/zh/

1.安装Jenkins

docker 安装一切都是那么简单，注意检查8080是否已经占用！如果占用修改端口

docker run --name jenkins -u root --rm -d -p 8080:8080 -p 50000:50000 -v /var/jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock jenkinsci/blueocean

如果没改端口号的话

安装完成后访问地址-> `http://{部署Jenkins所在服务IP}:8080`

此处会有几分钟的等待时间。

2.初始化Jenkins

2.1 解锁Jenkins

*  进入Jenkins容器：`docker exec -it {Jenkins容器名} bash`
 *  例如 `docker exec -it jenkins bash`
 *  查看密码：`cat /var/lib/jenkins/secrets/initialAdminPassword`
 *  复制密码到输入框里面

![4c25411d134b4fbf98baf82c025abf7e.png][]

2.2 安装插件

选择第一个：安装推荐的插件

![8e9a16cefc5448ed9ccfc37f0928bd5f.png][]

2.3 创建管理员用户

此账户一定要记住

### 三、系统配置 ###

1. 安装需要插件

进入【首页】–【系统管理】–【插件管理】–【可选插件】

搜索以下需要安装的插件，点击安装即可。

![d02d32828c8f443d97aa087dbf74485b.png][]

*  安装`Maven Integration`
 *  安装`Publish Over SSH`(如果不需要远程推送，不用安装)
 *  如果使用Gitee 码云，安装插件Gitee（Git自带不用安装）

2. 配置Maven

进入【首页】–【系统管理】–【全局配置】，拉到最下面maven–maven安装

![3ed67f53d42740afb4fa3f1b323cd397.png][]

### 四、创建任务 ###

1. 新建任务

点击【新建任务】，输入任务名称，点击构建一个自由风格的软件项目

![5836923d2e814e929e6fcb71dc50ee8e.png][]

2. 源码管理

点击【源码管理】–【Git】，输入仓库地址，添加凭证，选择好凭证即可。

![5c00b642276345bdba77a71c72189b50.png][]

![5a601c14f02743d6bb7f014d0c311753.png][]

3.构建触发器

点击【构建触发器】–【构建】–【增加构建步骤】–【调用顶层Maven目标】–【填写配置】–【保存】

![20b31b41b8bd480e89823d22e707af55.png][]

此处命令只是install，看是否能生成jar包

clean install -Dmaven.test.skip=true

![50c6474e11f244c381ba6242aa326f21.png][]

4. 保存

点击【保存】按钮即可

### 五、测试 ###

该功能测试是否能正常打包

1. 构建

点击构建按钮

![774221ce8f11452993ef978d4789df29.png][]

2.查看日志

点击正在构建的任务，或者点击任务名称，进入详情页面，查看控制台输出，看是否能成功打成jar包。

该处日志第一次可能下载依赖jar包失败，再次点击构建即可成功。

![77a12072dcd34751926baa5ff066f67e.png][]

![a5e962a191794a30b0dd11b6ccaa002c.png][]

3. 查看项目位置

`cd /var/jenkins_home/workspace`

`ll` 即可查看是否存在

### 六、运行项目 ###

因为我们项目和jenkins在同一台服务器，所以我们用shell脚本运行项目，原理既是通过dockerfile 打包镜像，然后docker运行即可。

1. Dockerfile

在springboot项目根目录新建一个名为Dockerfile的文件，注意没有后缀名，其内容如下:（大致就是使用jdk8，把jar包添加到docker然后运行prd配置文件。详细可以查看其他教程）

FROM jdk:8
    VOLUME /tmp
    ADD target/zx-order-0.0.1-SNAPSHOT.jar app.jar
    EXPOSE 8888
    ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar","--spring.profiles.active=prd"]

2. 修改jenkins任务配置

![b1454fc2938f4a0281a7c52db7062984.png][]

配置如下：

![3393a49aae7944a2924e561e46e05eaa.png][]

`-t`：指定新镜像名

`.`：表示Dockfile在当前路径

我上图用了`docker logs -f` 是为了方便看日志，真实不要用，因为会一直等待日志，构建任务会失败

加`|| true` 是如果命令执行失败也会继续实行，为了防止第一次没有该镜像报错

5. 验证

1.  `docker ps` 查看是否有自己的容器
2.  `docker logs` 自己的容器名 查看日志是否正确
3.  浏览器访问项目试一试

[4c25411d134b4fbf98baf82c025abf7e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/cc30487cfb074b148f4716ccd45b620e.png
[8e9a16cefc5448ed9ccfc37f0928bd5f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/ce45fea977af409c8a0c45c018b5c11d.png
[d02d32828c8f443d97aa087dbf74485b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/af9f4aa819564544b01e9f1486e14752.png
[3ed67f53d42740afb4fa3f1b323cd397.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/93bbaba83ac8455b8f43a43350ea4e4c.png
[5836923d2e814e929e6fcb71dc50ee8e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/e5c56c92af204f5595487567d7372519.png
[5c00b642276345bdba77a71c72189b50.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/430295a7fb8740b29d836cac0340ada3.png
[5a601c14f02743d6bb7f014d0c311753.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/d62ae0c2c9ae4564936655ff7fb66827.png
[20b31b41b8bd480e89823d22e707af55.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/f9f75906d58d405281c40151fc115919.png
[50c6474e11f244c381ba6242aa326f21.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/b913b0eb936a48119ae9f1e1516fb751.png
[774221ce8f11452993ef978d4789df29.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/28cac340fb9b4208be75fdc27b7dda73.png
[77a12072dcd34751926baa5ff066f67e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/3220995322bf45059861eba29b922617.png
[a5e962a191794a30b0dd11b6ccaa002c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/47e79b3b59234c93ab1658a0c9fde712.png
[b1454fc2938f4a0281a7c52db7062984.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/0f73eeed488043ce8e80440d92cde58d.png
[3393a49aae7944a2924e561e46e05eaa.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/06/505c97a77ec54983b1669fcb836455f6.png