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

avatar
作者
猴君
阅读量:0

一.背景

        在《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生命周期与插件关系。希望能帮助到初学者!

广告一刻

为您即时展示最新活动产品广告消息,让您随时掌握产品活动新动态!