Docker 安装 Jenkins 并部署 Maven 项目

╰半夏微凉° 2024-03-16 13:32 124阅读 0赞

## 一、前言 ##

在开始之前，我们需要保证系统中已经安装了Docker、JDK、Maven。

--------------------

## 二、Docker 拉取镜像 ##

我这里使用的是 2.344 版本的 Jenkins，拉取命令如下：

docker pull jenkins/jenkins:2.344

需要稍微等一会，等待拉取完成。  
镜像下载完成后，我们可以通过如下命令查看我们 docker 中的所有镜像。

docker images

![在这里插入图片描述][2089774512db497cbb526ad30be2d566.png]  
这里可以看到我们刚才拉取的 2.344版本的 Jenkins 镜像。

--------------------

## 三、运行容器 ##

下载镜像成功后，我们需要用此镜像运行一个容器，命令如下：

docker run \
    -d \
    --name jenkins \
    -u 0 \
    -p 9999:8080 \
    -p 8888:8888 \
    -p 50000:50000 \
    -v /usr/local/java/jdk-11.0.18:/usr/local/java/jdk-11.0.18 \
    -v /usr/local/maven/apache-maven-3.6.1:/usr/local/maven/apache-maven-3.6.1 \
    -v /home/jenkins_home:/home/jenkins_home \
    jenkins/jenkins:2.344

**命令解释：**

*  \-d：在后台运行
 *  \--name：为我们当前运行的容器取一个名称
 *  \-u：以某个用户的身份启动（此处的 0 代表是 root 用户，而如果不加该命令，jenkins 启动会默认以 1000 的用户 jenkins 启动，这样会导致某些文件夹的读写权限不足问题，因此建议加上 -u 0 命令启动容器）
 *  p：指定映射的IP和端口，前者为本地系统的端口号，后者为容器内部的端口号。以 -p 9999:8888 举例，8888为容器内的端口号，而9999为容器内端口号映射到本地系统（容器外部）的端口，即我们访问本地系统的9999端口，实际会映射到容器内部的8888端口上。此处开放8888端口是因为后面构建项目时，项目的端口也为8888，避免重新给容器开放端口映射。
 *  \-v：绑定数据卷，拿 **-v /usr/local/java/jdk-11.0.18:/usr/local/java/jdk-11.0.18** 举例：表示将本地系统的 **/usr/local/java/jdk-11.0.18** 映射到 容器内部的 **/usr/local/java/jdk-11.0.18**。

最后的 jenkins/jenkins:2.344 表示当前启动的容器是基于哪个镜像的，语法 Repository:Tag，如果当前的镜像是唯一的，也可以不用加Tag。

此处我将本地系统的 jdk11 和 maven 都映射到了 当前启动的容器中，而路径我为了便于统一（容器内的路径可以随便自定义），容器内的路径设置为和容器外一样的路径。

**/usr/local/java/jdk-11.0.18** 路径为本地系统JAVA\_HOME 配置的路径，如果忘记了配置的路径，可以通过如下命令查看：

which java

![在这里插入图片描述][57a9f16419da44bc8a39027c72cb958a.png]  
我们复制路径到bin目录的上一级即可，如此处为：**/usr/local/java/jdk-11.0.18**

**/usr/local/maven/apache-maven-3.6.1** 路径为本地系统JAVA\_HOME 配置的路径，如果忘记了配置的路径，可以通过如下命令查看：

which mvn

![在这里插入图片描述][68e58ff5d2504cf78745526ef3fc9fb8.png]  
同理，复制到 bin 目录的上一层即可，此处为：**/usr/local/maven/apache-maven-3.6.1**

## 四、访问Jenkins ##

当我们输入上述的 docker run 命令后，会生成一个容器，我们可以通过命令查看当前启动的容器：

docker ps

![在这里插入图片描述][d596f20d4edf4560b98e21ccf7f3c6cc.png]  
如果某些同学输入命令后，没有看到该信息，那说明我们的容器运行失败了，可以通过如下命令查看所有容器的状态：

docker ps -a

![在这里插入图片描述][5f056c71fc2347e5bec41ae2d9c27c59.png]  
这里的 STATUS 大概率会显示 Exit… 表明你的容器启动失败。我们可以查看具体原因。

#### 解锁Jenkins ####

如果我们的容器启动成功，那么我们直接访问 本地的ip:9999 即可查看到当前页面。  
![在这里插入图片描述][2276814e41c044468108122969561a08.png]  
此时我们如果直接在本地输入命令 cat /var/jenkins\_home/secrets/initialAdminPassword 是查看不到的，因为该路径是容器内部的路径，我们需要先进入容器内部，再输入该命令，才能够成功看到密码。

进入容器命令：

docker exec -it 容器id/容器名称 bash

你可以输入的容器id或者容器名称，我一般习惯输入容器名称，如果你的 docker run 命令和我一样，那么可以直接复制如下命令进入容器内部：

docker exec -it jenkins bash

![在这里插入图片描述][95486dd6bc43405191d506bc1f8b1257.png]

成功进入容器后，我们在输入如下命令查看初始密码：

cat /var/jenkins_home/secrets/initialAdminPassword

![在这里插入图片描述][02e6e32a5d1e4412b5f9d36c56000cb2.png]

我们复制打印出来的密码，粘贴到网页，点击“继续”，进行下一步操作。

#### 自定义Jenkins ####

![在这里插入图片描述][af0c06bac06f432eaced6615a5f234c6.png]  
此处我建议点击“安装推荐的插件”的选项。然后耐心等待，有可能部分插件会安装失败，因为此处的下载源在国外。部分插件安装失败，我们可以点击重试，如果多次重试仍然失败（就是我本人），我们直接点击下一步。

#### 创建第一个管理员用户 ####

![在这里插入图片描述][d736c7fe5726402185e3719dccfec995.png]

这里可以输入你想创建的账号，输入完毕后，点击保存并完成。

#### 配置实例 ####

![在这里插入图片描述][89405d2c4aeb4664aadaaa2c021fc40e.png]

这里默认即可，点击保存并完成。

#### Jenkins 已就绪 ####

![在这里插入图片描述][0f07724b60b74f1db8de6c3ddeaaf04b.png]  
点击 “开始使用Jenkins”，就可以进入到 Jenkins 的页面了。

--------------------

## 五、Jenkins 配置 ##

### 安装Maven插件 ###

Maven插件默认是不会给我们安装的，因此我们需要自己安装。  
首先点击左侧 “Manage Jenkins”，然后找到 “Manage Plugins”并点击，  
![在这里插入图片描述][c9e2f7c7e135434d8343333d4268b3e8.png]

然后点击“可选插件”并输入 maven，找到如下插件 Maven Integration plugin，点击下面的 Install without restart。

![在这里插入图片描述][338d8a1a28494991b4f6fd47f3a2891a.png]

### 全局配置 ###

![在这里插入图片描述][12474453a022465cb3b4e2942524c579.png]

首先点击左侧 “Manage Jenkins”，然后找到 “Global Tool Configuration”并点击，

![在这里插入图片描述][d246170c19da4477bd9bd2db8681421b.png]  
在这里我们需要配置JDK、Git、Maven。

#### JDK ####

点击 “JDK安装”  
![在这里插入图片描述][524591f70b8e4fd3aa8d9b0764889082.png]

输入别名及JAVA\_HOME，这里的JAVA\_HOME对应的是我们docker容器内部的JAVA\_HOME，而我们在第三步将运行容器，将 java 映射的地址为 **/usr/local/java/jdk-11.0.18**（根据你 docker run 时的配置填写），因此这里直接上即可，如图：

/usr/local/java/jdk-11.0.18

![在这里插入图片描述][1f7bd93603a84a9a8dddd3b548138004.png]

#### GIT ####

Git会在我们自定义Jenkins时安装插件的时候，自动帮我们安装，此处我们无需填写，默认即可。

![在这里插入图片描述][8417bb90a36b480d9f9074fb59153c47.png]

#### Maven ####

同理，此处需要填写maven的别名和MAVEN\_HOME.

![在这里插入图片描述][82e945f8db7a4c2f8baaab7bf64f3fcb.png]  
MAVEN\_HOME在我们运行容器映射的地址为：

/usr/local/maven/apache-maven-3.6.1

我们填上即可。

最后我们点击应用，然后点击保存即可。

--------------------

## 六、部署Maven项目 ##

首先，回到Jenkins首页，点击“+新建任务”，如图：

#### 新建Maven项目 ####

![在这里插入图片描述][270da4afc5ad4e68930a580ff4dfc997.png]

输入我们项目的名称，点击构建一个Maven项目，然后点击确定，如图：

![在这里插入图片描述][93d19e720a6944399841c4ce211eba1b.png]

#### 配置Git仓库 ####

首先配置我们的Git仓库地址，此处我用的是自己开源的项目，所以无需填写凭证，如果大家的项目需要凭证，可以自行添加：

![在这里插入图片描述][04f04faffaa74c20b13a0a3a1da404f6.png]  
添加凭证非常简单，我相信都会，填好需要的账号密码点击保存即可。

![在这里插入图片描述][afb68624d198404794f16bb15b854328.png]  
当我们添加完后，URL下方没有出现红色的错误提示表示能够正常连接到该仓库了，可以继续配置仓库分支，这里我选用的是一个 helloworld 的分支，大家根据实际情况自行填写：

![在这里插入图片描述][c57b93c06fff4c4c9c31908d9d5620d0.png]

#### 配置Maven构建参数 ####

接下来就是配置Maven，对项目进行打包，Root POM 不用修改，就用 pom.xml，而 Goals and options 我们填写：

clean install -Dmaven.test.skip=true

![在这里插入图片描述][b7d62adf39774ddb8a4c0fc2b9f7ae51.png]  
这时候Maven的最基本配置就完成了。大家可以点击应用，并保存，开始构建项目，看看能不能打包成功。

![在这里插入图片描述][0039cf11cf9e46b9a4913ea2f6562c79.png]

查看控制台输出：

![在这里插入图片描述][bd7a9f6c08b14182bb7d9f6fe2cbf3dc.png]

![在这里插入图片描述][e1435237beb7404088abdeb4494ff682.png]

#### 启动项目 ####

这样就代表成功了，接下来就开始启动项目了，点击项目，打开左侧的配置，依次选择 Post Steps -> Add post build steps -> 执行shell

![在这里插入图片描述][891dc3166b8f4445aa91da62e17569b1.png]  
填上我们的启动脚本，这里只是最简单的脚本，大家可以根据实际情况填写：

cd /var/jenkins_home/workspace/flowable_study/target
    nohup java -jar flowable_study-1.0-SNAPSHOT.jar >flowable_study.log &2>1 &

注意：我这里是在docker容器内部运行的java项目，大部分实际情况是需要通过jenkins连接到其他服务器去部署项目。大致的流程为：

*  将容器内的jar包拷贝到目标服务器
 *  切换目录，杀掉当前正在运行的项目
 *  启动项目

我这里只做最基本的部署演示，因此就不弄那么麻烦。同时我这里项目的端口号为8888，我在创建容器，使用 docker run 时，已经将容器内的8888端口映射到宿主机的8888端口了。

写好之后直接应用、保存。然后重新构建项目，这里就能够直接访问8888端口了。  
![在这里插入图片描述][3727dc888a894070ab49fa11611fdec4.png]  
由此，整个Maven项目构建完成。

[2089774512db497cbb526ad30be2d566.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/78a9b0c6295046afb5693035cf2ba715.png
[57a9f16419da44bc8a39027c72cb958a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/9383af35f61d4490bb326aa006ed7b7b.png
[68e58ff5d2504cf78745526ef3fc9fb8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/7bbd0c39b8484bdba5f536a02e518be5.png
[d596f20d4edf4560b98e21ccf7f3c6cc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/d9e60e44f32e41c48a87fbe2c847913c.png
[5f056c71fc2347e5bec41ae2d9c27c59.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/dde4fbefee0b453aa7d356740ee983cf.png
[2276814e41c044468108122969561a08.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/1edcf2fc1ee045ae8868cb01c203f2fe.png
[95486dd6bc43405191d506bc1f8b1257.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/b7a02ce00f8b44ca80e6ed653530b9a3.png
[02e6e32a5d1e4412b5f9d36c56000cb2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/d82d50bf75b147deb012b332961c321e.png
[af0c06bac06f432eaced6615a5f234c6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/2d291a44f19c4a76b299032a5cdb505a.png
[d736c7fe5726402185e3719dccfec995.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/812acb93f472412f83db94771326221b.png
[89405d2c4aeb4664aadaaa2c021fc40e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/83569ef25af44130a6c86735cb2cd398.png
[0f07724b60b74f1db8de6c3ddeaaf04b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/3115f33f814345738314975944666d95.png
[c9e2f7c7e135434d8343333d4268b3e8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/7150958545bd4513a5c54f976b0fe893.png
[338d8a1a28494991b4f6fd47f3a2891a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/69a41d9ddf9842ac95a512fd968a0a99.png
[12474453a022465cb3b4e2942524c579.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/0e0f846c19774f4f8fe21c65281fba53.png
[d246170c19da4477bd9bd2db8681421b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/63eba7381b93490c95e91040e07f8bd8.png
[524591f70b8e4fd3aa8d9b0764889082.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/e6823cba441946d5a6e87512637a6cc1.png
[1f7bd93603a84a9a8dddd3b548138004.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/03a574e1d17d4d4dbbd286d6dd7e7ffc.png
[8417bb90a36b480d9f9074fb59153c47.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/2f03ca5e207b44778deab67f518aa936.png
[82e945f8db7a4c2f8baaab7bf64f3fcb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/429e696897b44492a6f15ccd935c40c0.png
[270da4afc5ad4e68930a580ff4dfc997.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/d1a349e0c7fa4f549fb9fb2cdbf079ac.png
[93d19e720a6944399841c4ce211eba1b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/f85494912dae4bb096ff86094fbfe2ff.png
[04f04faffaa74c20b13a0a3a1da404f6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/a164641307af4134af7e33ca035fa980.png
[afb68624d198404794f16bb15b854328.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/50d108702958486bbeee352bca00db06.png
[c57b93c06fff4c4c9c31908d9d5620d0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/cb1bcc36047e426dbc533bdfb5f476f9.png
[b7d62adf39774ddb8a4c0fc2b9f7ae51.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/c20f13e6e7e144ed927b11e48a0db817.png
[0039cf11cf9e46b9a4913ea2f6562c79.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/79452bf036f74ea58c656dcf8f120e82.png
[bd7a9f6c08b14182bb7d9f6fe2cbf3dc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/1feb3bbd52e343978d26523c05053c27.png
[e1435237beb7404088abdeb4494ff682.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/c8017856546f41108b9cc46565e5d8f8.png
[891dc3166b8f4445aa91da62e17569b1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/31f5ce43f18d4dda84f186fdc1674286.png
[3727dc888a894070ab49fa11611fdec4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/84ae5cd8020f4a7dbe7e3664d6373906.png