maven项目容器化运行之3-优雅的利用Jenkins和maven使用docker插件调用远程docker构建服务并在1Panel中运行

一.背景

        在《maven项目容器化运行之1》中，我们开启了1Panel环境中docker构建服务给到了局域网。在《maven项目容器化运行之2》中，我们基本实现了maven工程创建、远程调用docker构建镜像、在1Panel选择镜像运行容器三大步骤。

       但是，存在一个问题，就是我们本地每次install的时候，都会去构建镜像。期望开发人员在本地开发打包构建时，用于本地测试或者联调，不去构建镜像。而专业测试人员一般是面对测试环境进行测试，这时就需要发布到测试环境，能够快速构建测试人员的测试环境就行。

      因为构建镜像、运行容器是部署阶段的事情，并不是开发阶段的事情。所以，我期望继续改进，实现更优雅的开发与部署（测试或正式部署）。

二.整体思路

     1.调整maven的docker插件设置

      期望通过设置dockerfile-maven-plugin插件，实现每次mvn install等，不要去构建镜像。但又要找到一个maven的命令，可以单独执行镜像构建的任务。我开始的思路是这样，行不行还得慢慢摸索学习。

     2.借助Jenkins创建自动构建镜像到1Panel

      这一步，我开始心里就有底。不外乎就是从git拉代码，执行一个命令，就实现了自动构建进行到1Panel。因为，在《maven项目容器化运行之2》中，我们本机执行maven工程的install就已经实现了远程调用docker的构建服务了。这里的“到1Panel”中，没有我们需要做的。应该是1Panel自己集成或者想了办法，可以识别到其本机docker的images。我们只要调用了1Panel所在服务器的docker构建服务并生成了image文件（默认就在docker所在的服务器上），它自己就能识别到。

三.尝试过程

    1.调整maven的docker插件设置     

	<build>
		<finalName>${project.artifactId}</finalName>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
				<version>2.6.6</version>
				<executions>
					<execution>
						<goals>
							<goal>repackage</goal>
						</goals>
					</execution>
				</executions>
			</plugin>
			<plugin>
				<groupId>com.spotify</groupId>
				<artifactId>dockerfile-maven-plugin</artifactId>
				<version>${version.dockerPlugin}</version>
				<executions>
					<execution>
						<id>default</id>
						<goals>
<!--							<goal>build</goal>-->
<!--							<goal>push</goal>-->
						</goals>
					</execution>
				</executions>
				<configuration>
					<repository>${project.groupId}/${project.artifactId}</repository>
					<tag>${project.version}</tag>
					<buildArgs>
						<JAR_FILE>${project.build.finalName}</JAR_FILE>
					</buildArgs>
					<dockerfile>Dockerfile</dockerfile>
				</configuration>
			</plugin>
		</plugins>
	</build>

       我就屏蔽了<goals>中的2个<goal>。这个<goal>是干什么的呢？我的理解是Maven生命周期（对应标准命令）执行哪个docker的动作（就是构建、推送等）。我一个都不设置呢，意思就是在maven构建时，不要去直接执行docker的动作。这样就实现了开发人员在本地执行maven的标准命令时，不会去执行docker相关的事情。

      那要想执行docker相关的动作呢？maven的命令又该怎么办？输入类似如下命令即可：

mvn clean install dockerfile:build

     最后一段命令“dockerfile:build”就是明确指定执行docker的动作。这个命令开发人员一般不会去执行，如果添加到Jenkins任务中。这样就实现了“开发不管、自动构建”的目标了。

     2.借助Jenkins创建自动构建镜像到1Panel

     前提：在这之前，已经安装了Jenkins和相关必要的插件，代码也已经提交到了代码库中（我们是局域网gitlab）。

     1）新建一个Jenkins任务

            

       在弹窗中输入任务名称，选择maven项目。

         2）进行Jenkins任务配置

           输入任务描述

    选择git的地址、git登录凭证、代码分支（默认是master，一定要注意这里）

     构建勾选一个，并设置构建周期。这里的H/2 * * * *是2分钟构建一次，准确说是2分钟执行一次任务，从gitlab获取代码，有更新才执行构建。没有更新就不会构建。这个刚刚是我们想要的。比如：开发人员在本地测试可能会有多次修改，没有问题后将代码提交到代码库。提交到代码库的一般都是实现了新功能或者完成了bug、功能修改，这个时候自动构建到1Panel环境，是符合我们优雅的期望。

如果不知道怎么写日程表，可以点击右边的问号，看看下面的解释就明白了。如果还看不懂，自己单独去学习Cron表达式。

构建环境，就选择第一个，在构建前删除构建空间。

    

build节点设置执行命令为  clean install dockfile:build。这里不需要输入mvn 开头哈，要注意

      3）遇到的错误

  报错如下：     Caused by: com.spotify.docker.client.shaded.org.apache.http.conn.HttpHostConnectException: Connect to localhost:2375 [localhost/127.0.0.1, localhost/0:0:0:0:0:0:0:1] failed: Connection refused: no further information     

a.连接不到docker的构建服务，在Jenkins构建任务PreSteps中设置不生效

     我是这样是设置的，但是并不生效。

    怎么理解呢？主要是这里的windows命令与后续maven构建执行并不在一个进程之中，所以设置无效。就像开了2个bat窗口，第一个设置的变量，第二个bat窗口并不能获取到。是隔离的。我之前在Jenkins中测试过执行2个windows command等类似的情况。

      b.连接不到docker的构建服务，在操作系统中环境变量设置也不生效

     我头大，怎么去连接本地的docker构建了呢？哦！我忘记设置了DOCKER_HOST。我连接到服务器设置了系统的变量回来，还是同样的错误。怎么理解呢？Jenkins启动在先，操作系统变量设置在后，Jenkins估计不具备实时读取操作系统环境变量的功能，所以这种情况下还是失败了。估计重启是好使的。但是我不行重启呢！

     c.连接不到docker的构建服务，在Jenkins中环境变量生效了

     按照下面3个图片，实现了设置。

    执行就不报错了。关键内容如下：    

[INFO] Step 1/6 : FROM docker.io/majiajue/jdk1.8
[INFO] 
[INFO] Pulling from majiajue/jdk1.8
[INFO] Digest: sha256:fc684fe12c95aac86ef506f5a2bc2ec8fa411cdf7f34165f51a0275076dedcb4
[INFO] Status: Image is up to date for majiajue/jdk1.8:latest
[INFO]  ---> 2be3cc30c33f
[INFO] Step 2/6 : ENV ENV LC_ALL zh_CN.UTF-8
[INFO] 
[INFO]  ---> Using cache
[INFO]  ---> 30161b4581a1
[INFO] Step 3/6 : ENV BASE_PATH=/usr/local/app/
[INFO] 
[INFO]  ---> Using cache
[INFO]  ---> be747d0679df
[INFO] Step 4/6 : RUN mkdir -p ${BASE_PATH}
[INFO] 
[INFO]  ---> Using cache
[INFO]  ---> 7b513e464747
[INFO] Step 5/6 : COPY target/elegant-docker.jar ${BASE_PATH}/hello-docker.jar
[INFO] 
[INFO]  ---> 3e45fa23fd89
[INFO] Step 6/6 : ENTRYPOINT java -Dfile.encoding=UTF8 -Dsun.jnu.encoding=UTF8 -jar ${BASE_PATH}/hello-docker.jar
[INFO] 
[INFO]  ---> Running in 466a556c8aeb
[INFO]  ---> Removed intermediate container 466a556c8aeb
[INFO]  ---> 4fca4234ccf2
[INFO] [Warning] One or more build-args [JAR_FILE] were not consumed
[INFO] Successfully built 4fca4234ccf2
[INFO] Successfully tagged cn.scantt/elegant-docker:0.0.1-SNAPSHOT
[INFO] 
[INFO] Detected build of image with id 4fca4234ccf2
[INFO] Building jar: C:\Users\Administrator\.jenkins\workspace\elegant-docker\target\elegant-docker-docker-info.jar
[INFO] Successfully built cn.scantt/elegant-docker:0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS

四.总结

    思路清晰，实现了我们的目标。过程虽然遇到了问题，但都轻松的解决了。展开学习的就太多了，大家努力吧。比如Jenkins的安装及插件安装、gitlab环境搭建、git与开发工具的结合使用、maven生命周期与插件关系。希望能帮助到初学者！