转载

Jenkins kubernetes插件的原理

Jenkins kubernetes插件的原理

技术干货,可收藏,点“在看”后,再看。

如何使用

使用Kubernetes插件时,我们需要做三件事情:

  1. 根据官方文档,在Jenkins上加入kubernetes配置。

  2. 在Jenkinsfile中加入kubernetes agent的申明。

  3. 指定容器执行你的业务脚本。

关于第2点,kubernetes agent的申明又有两种方式。一种是脚本式的,代码样例如下:

一种是申明式,代码样例如下:

笔者推荐使用申明式。yaml配置部分看起来并不优雅,这是另一个话题。咱们今后再讲。

原理

我们都知道Jenkins是master/agent的架构。而master与agent之间通信方法有两种:

  1. 通过JNLP协议:需要启动JNLP客户端主动连接master。这是Kubernetes插件使用的方式。

  2. 通过SSH协议:master使用SSH主动连接agent机器。

Kubernetes插件的具体的做法就是连接到Kubernetes集群,然后启动一个Pod。Pod中包含一个JNLP客户端,容器名约定为:jnlp。jnlp 会主动连接Jenkins master。

所以,当你发现Jenkins任务的日志中,一直在等待jnlp连接时,我们可以这样查问题:

  1. 查看相应的Pod是否存活。

  2. jnlp 容器连接不上master:大概率是配置不对。

可是,我们看到上面的示例代码中,都没有叫jnlp的容器呢。这是因为Jenkins kubernates插件在真正创建pod前,为我们混入了默认的jnlp的容器定义。也就是,最终执行的yaml其实是:

最后,pod启动后,pod中的jnlp容器会连上Jenkins master。当pipeline运行到以下代码:

kubernates插件会找到名为 maven 的容器,然后将闭包内的代码发给它执行。

以上基本就是kubernates插件全部。

更换jnlp实现

当我们知道它的原理后,我们也就可以更换jnlp的实现镜像了。比如有些同学是在arm架构的机器上执行Kubernetes的,那么,他可以创建一个基于arm架构的jnlp镜像,然后,加入到yaml中。比如:

小结

总的来说,它的原理无非就是创建pod,pod中的jnlp容器连接到Jenkins master,然后Jenkins master根据需要,将需要执行的命令发送给相应的容器执行。

附录

  1. Jenkins kubernetes源码:https://github.com/jenkinsci/kubernetes-plugin

  2. 混入jnlp容器的代码位置:  org.csanchez.jenkins.plugins.kubernetes.PodTemplateBuilder#build()

  3. 创建pod的代码位置:  org.csanchez.jenkins.plugins.kubernetes.KubernetesLauncher#launch

原文  http://mp.weixin.qq.com/s?__biz=MzU1Njk2NjkxNA==&mid=2247483846&idx=1&sn=e3482a7be4d3e97d8a2499f263099f65
正文到此结束
Loading...