如何为jenkinsci kubernetes-plugin创建的Jenkins slave配置sidecar容器

原因说明 #

Jenkins Kubernetes插件的containers节点仅用于定义Jenkins Agent的主容器（即与Jenkins Master通信的JNLP容器），直接在此节点下添加其他容器会被插件忽略。额外的Sidecar容器需要通过additionalContainers字段配置。

正确配置示例 #

clouds:
  - kubernetes:
      ...
      name: "kubernetes"
      templates:
      - name: jenkins-slave
        containers:
          - image: "..."
            name: "jnlp"
            resourceLimitCpu: "1000m"
            resourceLimitMemory: "4000Mi"
            ...
        # 配置额外的Sidecar容器
        additionalContainers:
          - name: "buildkit"
            image: "moby/buildkit:latest"
            # 可选：BuildKit默认启动命令及参数
            command: ["buildkitd"]
            args: ["--addr", "tcp://0.0.0.0:1234"]
            # 可选：资源限制配置
            resourceLimitCpu: "500m"
            resourceLimitMemory: "2000Mi"
            # 可选：资源请求配置
            resourceRequestCpu: "200m"
            resourceRequestMemory: "1000Mi"
            # 可选：特权模式（部分镜像构建场景需要）
            privileged: true

关键配置说明 #

• additionalContainers是与containers同级的节点，专门用于定义伴随主Agent容器运行的所有Sidecar。
• 每个Sidecar容器的配置字段和主容器一致，支持镜像、资源限制、启动命令、特权模式等常见Kubernetes容器配置项。
• 同一Pod内的主容器和Sidecar共享网络命名空间，可通过localhost直接通信。

内容的提问来源于stack exchange，提问作者deez