shadwell/k8s-sidecar

镜像概述

该Docker镜像旨在在Kubernetes集群中运行，用于收集带有指定标签的ConfigMap文件并存储到本地文件夹。当ConfigMap发生变化时，它还可以向指定URL发送HTTP请求。与kiwigrid/k8s-sidecar相比，此镜像针对Jenkins进行了定制，当指定的JCasC（Jenkins Configuration as Code）ConfigMap发生变化时，会重新加载Jenkins的JCasC设置。

核心功能和特性

• 收集带有指定标签的ConfigMap文件并存储到本地文件夹
• ConfigMap变化后可向指定URL发送HTTP请求
• 支持Jenkins JCasC配置的自动重新加载
• 提供全面的日志记录
• 写入状态文件/app/reload_successful.txt，包含布尔值（"true"表示重载成功，"false"表示失败），便于外部判断重载状态
• 默认以非root用户（jenkins）运行，权限最小化

使用场景和适用范围

• Kubernetes环境中运行的Jenkins实例，需要通过ConfigMap管理JCasC配置
• 需要在JCasC配置变化时自动重载Jenkins配置的场景
• CI/CD流水线中，可先部署到"staging" Jenkins实例，通过状态文件检查配置是否成功应用，再将配置变更应用到"production" Jenkins实例

使用方法和配置说明

该镜像作为sidecar容器在Kubernetes Pod中与Jenkins主容器一起运行，通过环境变量进行配置。以下是典型的Kubernetes Pod配置示例：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: jenkins
spec:
  containers:
  - name: jenkins
    image: docker.xuanyuan.run/jenkins/jenkins:lts
    # 其他Jenkins配置...
  - name: jenkins-sc-config
    image: docker.xuanyuan.run/[镜像名称]  # 替换为实际镜像名称
    env:
    - name: label
      value: "jenkins-config=true"  # 指定用于过滤ConfigMap的标签
    - name: folder
      value: "/var/jenkins_home/casc_configs"  # JCasC配置文件存储路径
    - name: namespace
      value: "jenkins"  # 可选，指定搜索ConfigMap的命名空间，或使用"ALL"搜索所有命名空间
    - name: req_url
      value: "http://localhost:8080/reload-configuration-as-code/"  # Jenkins JCasC重载URL
    - name: req_method
      value: "POST"  # 发送POST请求
    volumeMounts:
    - name: casc-configs
      mountPath: "/var/jenkins_home/casc_configs"  # 挂载存储ConfigMap文件的卷
  volumes:
  - name: casc-configs
    emptyDir: {}

环境变量配置

日志与安全

日志获取

通过以下命令获取容器运行日志：

bash
kubectl logs <jenkins-pod> -c jenkins-sc-config

其中<jenkins-pod>为Jenkins Pod名称，jenkins-sc-config为sidecar容器名称。

状态文件

Python脚本会写入状态文件/app/reload_successful.txt，包含单个布尔值："true"表示重载成功，"false"表示失败。可用于外部判断重载状态，例如在CI/CD流水线中验证配置是否成功应用。

安全

容器默认以非root用户（jenkins）运行，权限最小化，降低安全风险。