作者:Rick
Jenkins 能够很好地与 Kubernetes 集成,不论是控制器(controller)还是构建节点(agent),都能以 Pod 的模式运行在 Kubernetes 上。相熟 Jenkins 的用户,都晓得 Jenkins 反对多种类型的构建节点,例如:固定配置、动静配置。而节点与控制器连贯的形式,又包含:JNLP、SSH 等。对于曾经在全面拥抱容器技术的用户,大多数是通过连贯 Kubernetes 集群并动静启动、销毁 Pod 的形式来应用构建节点。而随着构建节点的品种、数量增多后,如何更无效地保护这些基于 Kubernetes 的节点,则逐步成为一个问题。而在这篇文章中,我将会介绍一种 基于配置即代码的计划 来治理、保护构建节点。
配置即代码(Configuration as Code,简称为:CasC),是一个十分赞的思路,它使得 Jenkins 用户不须要再一次次地关上 UI 界面去批改系统配置。通过 UI 批改配置的长处是:借助页面上配置项的形容信息,能够绝对容易地了解其含意。但绝对应的毛病也是非常明显的:难以复用,即使是完全相同的配置,也须要手动地在其余环境上再次操作;无奈追踪批改过程;产生谬误时无奈疾速回滚。借助 CasC 的能力,咱们能够把 Jenkins 的系统配置保留到一个 Git 代码仓库中,以及 GitOps 工具(例如:Argo CD),最终使得批改 Jenkins 系统配置,成为一件 可控、便捷的工作。
不过,当 Jenkins 的变得配置简单当前,对应的 YAML 配置文件也可能会变得越来越大,难以保护。
回归到咱们心愿解决的外围问题上来,预期的计划是:只须要独自保护 PodTemplate 即可实现对 Jenkins 构建节点的保护。为了解决该问题,咱们须要搞定 Jenkins 配置中的 PodTemplate 与 Kubernetes 中内置 PodTemplate 不统一的问题;以及如何 动静加载 Jenkins 配置的问题。
为了解决上述的几个问题点,只须要部署一个 Deployment 即可。这个组件负责监听 Kubernetes 内置的 PodTemplate,把其加载到 Jenkins 的系统配置(CasC YAML 文件)中,再调用 Jenkins API 从新加载配置。为了充沛地利用到 Kubernetes 的劣势,咱们把 CasC 配置存储为 ConfigMap,并以卷(Volume)的模式挂载到 Jenkins 中。
以下是试验步骤(本文提供的是外围思路和关键步骤,每个具体的文件都能够在文末提供的代码仓库地址中找到):
筹备一个 Kubernetes 集群,确保有足够的拜访权限,确保不会影响到集群已有业务。举荐应用诸如:MiniKube、Kind、K3s 等便于开发、测试的轻型集群。
首先,把 Jenkins 的系统配置以 CasC YAML 格局寄存到 ConfigMap 中,例如:
apiVersion: v1
data:
jenkins_user.yaml: |
jenkins:
mode: EXCLUSIVE
numExecutors: 0
scmCheckoutRetryCount: 2
disableRememberMe: true
clouds:
- kubernetes:
name: "kubernetes"
serverUrl: "https://kubernetes.default"
skipTlsVerify: true
kind: ConfigMap
metadata:
name: jenkins-casc-config
namespace: kubesphere-devops-system
而后,把下面的 ConfigMap 挂载到 Jenkins 工作负载中。须要留神的是,试验中应用的 Jenkins 必须装置的插件有:kubernetes kubernetes-credentials-provider configuration-as-code。参考如下:
spec:
template:
spec:
containers:
- image: ghcr.io/linuxsuren/jenkins:lts
env:
- name: CASC_JENKINS_CONFIG
value: "/var/jenkins_home/casc_configs/" # loading config file from a directory that was mount from a ConfigMap
volumeMounts:
- mountPath: /var/jenkins_home/casc_configs
name: casc-config # mount from a volume
volumes:
- configMap:
defaultMode: 420
name: jenkins-casc-config # clamin a ConfigMap volume, all the CasC YAML content will be here
name: casc-config
接下来,便是外围的 Kubernetes 控制器了。请参考如下配置创立对应的 Deployment:
apiVersion: apps/v1
kind: Deployment
metadata:
name: jenkins-agent
namespace: kubesphere-devops-system
spec:
template:
spec:
containers:
- image: kubespheredev/devops-controller:dev-v3.2.1-rc.3-6726130
name: controller
args:
- --enabled-controllers
- all=false,jenkinsagent=true,jenkinsconfig=true # only enable the necessary features of this controller
该控制器会监听所有带有标签 jenkins.agent.pod
的 PodTemplate 资源,并把它转化为 Jenkins 格调的 PodTemplate 后加载到系统配置中。通常状况下,这可能会有 3~5 秒的提早。
当你实现以上所有步骤,确保相干组件都正确启动后,就能够尝试增加一个 Kubernetes 内置的 PodTemplate 了。而后,你能够创立一个流水线来测试对应的节点。
参考资料
- 示例配置文件
- 外围控制器
-
英文版本
本文由博客一文多发平台 OpenWrite 公布!