k8s下的jenkins如何设置maven

关于k8s环境的jenkins集群

k8s下搭建了jenkins集群后，执行任务时会新建pod，任务完成后pod被销毁，架构以下图所示：
在k8s搭建jenkins集群的步骤请参照《》

关于jenkins构建maven

做为java开发者，用jenkins构建maven工程是常见的编译构建方式，当jenkins部署到kubernetes之上后，要作一些设置才能顺利编译构建；

实战简介

本次实战是在k8s的jenkins环境编译构建spring-cloud-alibaba这个开源的maven工程，涉及到的环境信息以下：

• kubernetes：1.15
• jenkins：2.190.2
• maven：3.6.3
• spring-cloud-alibaba：2.1.1.RELEASE

设置maven

若是您已经参考《》一文在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私有仓库是常常用到的，做用以下：

1. 缓存中央仓库的jar，这样局域网内的开发者在运行maven工程时，所需jar是从nexus下载的，而没必要去中央仓库下载，可节省下载时间；
2. 本身作的二方库发布到nexus私有仓库，给局域网内的其余人使用；

一般是经过配置maven的settings.xml来访问nexus私有仓库的，所以，jenkins在构建maven项目时也要用到配置好的settings.xml文件，才能访问nexus私有仓库；

• 若是您想了解更多nexus的细节，请参考文章《》

设置maven的settings.xml

这是本文的重点，思路以下：

1. 把settings.xml作成configmap;
2. 挂载到执行任务的pod中;
3. 执行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脚本，可做为参考：
  

设置pod内存和CPU

执行任务的pod的内存若是过小，可能会致使maven或者gradle编译时报OutOfMemory错误，所以须要设置pod内存：

• 在Configure System页面，找到Pod Templates的配置，点击下图红框中的Advanced...按钮：
  
• 以下图红框所示，按照实际需求对CPU和内存进行调整，我这里设置了1G的内存：
  
• 点击底部的Save按钮保存设置；

输出构建结果

mavne工程编译构建成功后，想要获得构建结果能够有多种途径，这里提供一种参考：经过数据卷的方式将构建结果保存到到宿主机

• 在Configure System页面，找到Pod Templates的配置，以下图，添加卷选择Host Path Volume：
  
• 以下所示，主机路径填写/usr/local/jenkins_output，挂载路径填写/home/jenkins/jenkins_output，这样就把pod的文件夹映射到宿主机上了
• 注意：确保宿主机的/home/jenkins/jenkins_output有写权限

通过以上设置，jenkins环境如今能够顺利构建maven项目了，下一篇文章，会挑选一个热门开源项目来实战编译构建。

欢迎关注个人公众号：程序员欣宸

https://github.com/zq2599/blog_demos