技术干货,可收藏,点“在看”后,再看。
使用Kubernetes插件时,我们需要做三件事情:
根据官方文档,在Jenkins上加入kubernetes配置。
在Jenkinsfile中加入kubernetes agent的申明。
指定容器执行你的业务脚本。
关于第2点,kubernetes agent的申明又有两种方式。一种是脚本式的,代码样例如下:
一种是申明式,代码样例如下:
笔者推荐使用申明式。yaml配置部分看起来并不优雅,这是另一个话题。咱们今后再讲。
我们都知道Jenkins是master/agent的架构。而master与agent之间通信方法有两种:
通过JNLP协议:需要启动JNLP客户端主动连接master。这是Kubernetes插件使用的方式。
通过SSH协议:master使用SSH主动连接agent机器。
Kubernetes插件的具体的做法就是连接到Kubernetes集群,然后启动一个Pod。Pod中包含一个JNLP客户端,容器名约定为:jnlp。jnlp 会主动连接Jenkins master。
所以,当你发现Jenkins任务的日志中,一直在等待jnlp连接时,我们可以这样查问题:
查看相应的Pod是否存活。
jnlp 容器连接不上master:大概率是配置不对。
可是,我们看到上面的示例代码中,都没有叫jnlp的容器呢。这是因为Jenkins kubernates插件在真正创建pod前,为我们混入了默认的jnlp的容器定义。也就是,最终执行的yaml其实是:
最后,pod启动后,pod中的jnlp容器会连上Jenkins master。当pipeline运行到以下代码:
kubernates插件会找到名为 maven
的容器,然后将闭包内的代码发给它执行。
以上基本就是kubernates插件全部。
当我们知道它的原理后,我们也就可以更换jnlp的实现镜像了。比如有些同学是在arm架构的机器上执行Kubernetes的,那么,他可以创建一个基于arm架构的jnlp镜像,然后,加入到yaml中。比如:
总的来说,它的原理无非就是创建pod,pod中的jnlp容器连接到Jenkins master,然后Jenkins master根据需要,将需要执行的命令发送给相应的容器执行。
Jenkins kubernetes源码:https://github.com/jenkinsci/kubernetes-plugin
混入jnlp容器的代码位置: org.csanchez.jenkins.plugins.kubernetes.PodTemplateBuilder#build()
创建pod的代码位置: org.csanchez.jenkins.plugins.kubernetes.KubernetesLauncher#launch