关于kubernetes环境的jenkins集群
- 在kubernetes环境部署的jenkins集群,执行任务时会新建pod,任务完成后pod被销毁,架构如下所示:
- 在kubernetes搭建jenkins集群的细节,请参考《Helm部署和体验jenkins》
关于jenkins构建maven
- 作为java开发者,常用jenkins构建maven工程,当jenkins部署到kubernetes之上后,要做一些设置才能顺利编译构建
环境信息
- 本次实战涉及到的环境信息如下:
- kubernetes:1.15
- jenkins:2.190.2
- maven:3.6.3
设置maven
- 如果您已经参考《Helm部署和体验jenkins》在kubernetes部署了jenkins,接下来要做的是设置maven插件:
- 在设置页面进入Global Tool Configuration,如下图:
- 新建一个Maven配置,如下图,名为mvn-3.6.3,版本选择3.6.3:
- 点击底部的 Save 保存,今后在pipeline任务中就能通过名称mvn-3.6.3使用此maven工具了;
关于maven的settings.xml
- 局域网内的nexus私有仓库是经常用到的,作用如下:
- 缓存中央仓库的jar,这样局域网内的开发者在运行maven工程时,所需jar是从nexus下载的,而不必去中央仓库下载,可节省下载时间;
- 自己做的二方库发布到nexus私有仓库,给局域网内的其他人使用;
-
通常是通过配置maven的 settings.xml 来访问nexus私有仓库,因此,jenkins在构建maven项目时也要用到配置好的settings.xml文件,才能访问nexus私有仓库;
-
PS:如果您想了解更多nexus的细节,请参考文章《Ubuntu部署和体验Nexus3》
设置maven的settings.xml
这是本文的重点 ,思路如下:
- 把settings.xml做成configmap;
- 挂载到执行任务的pod中(在jenkins上配置好,以后创建的pod都会按此配置挂载);
- jenkins任务的pipeline脚本中,执行mvn命令时指定挂载的 settings.xml 文件;
- 接下来是实现上述思路的操作:
- 准备好 settings.xml 文件,里面已配置好nexus私有仓库的信息,主要是server节点和mirror节点,内容参考下图:
- 将settings.xml上传到kubernetes环境,执行以下命令创建名为 settings.xml 的configmap:
kubectl create configmap settings.xml \
--from-file=settings.xml \
-n helm-jenkins
- 上述命令有以下两点需要注意: a. from-file参数表示此configmap的内容来源,是当前目录下名为 settings.xml 的文件; b. 此configmap的namespace名为 helm-jenkins ,这是jenkins所在的namespace;
- Configure System 页面,找到 Pod Templates 的配置,增加一个Config Map Volume,如下:
- Config Map名称填写 settings.xml ,挂载路径是/home/jenkins/settings,如下图:
- 点击底部的 Save 保存设置;
- 经过以上设置,执行pipeline任务时,pod的 /home/jenkins/settings 目录下就会有settings.xml文件,您只需指定使用此文件即可,mvn命令的 -s 参数就是用来指定settings.xml文件的,下图是一段pipeline脚本,里面有指定settings.xml的参数,可作为参考:
设置pod内存和CPU
- pod内存如果太小,可能导致maven或者gradle运行时报OutOfMemory错误,因此需要设置pod内存:
- Configure System页面,找到 Pod Templates 配置,点击下图红框中的 Advanced... 按钮:
- 如下图红框所示,按照实际需求对CPU和内存进行调整,我这里设置了1G的内存:
- 点击底部的 Save 保存设置;
输出构建结果
-
mavne工程编译构建成功后,我们需要拿到构建结果(例如是个jar文件),这里提供一种方式作为参考:通过数据卷的方式将构建结果保存到宿主机
-
Configure System页面,找到 Pod Templates 配置,如下图,添加卷选择 Host Path Volume :
-
如下所示,主机路径填写 /usr/local/jenkinsoutput ,挂载路径填写/home/jenkins/jenkinsoutput,这样就把pod的文件夹映射到宿主机上了:
-
请确保宿主机的/home/jenkins/jenkins_output 有写权限
-
经过以上设置,jenkins环境已经可以顺利构建maven项目并取得结果了,下一篇文章会挑选一个热门开源项目来实战编译构建。