Kubernetes：ConfigMap值变更时如何自动重启关联Pod

前提说明 #

Kubernetes原生不会因为ConfigMap更新自动重启关联Pod，另外你当前通过env的configMapKeyRef方式注入配置的场景下，ConfigMap更新后运行中Pod的环境变量不会自动刷新，必须重启Pod才能加载到新的配置值。

可行实现方案 #

• 方案1：使用Deployment管理Pod + 哈希注解触发滚动重启（生产环境优先推荐）
  裸Pod本身没有自我重建能力，首先把当前的裸Pod改为用Deployment工作负载管理。之后在Deployment的Pod模板注解中加入和ConfigMap内容绑定的哈希值，每次ConfigMap更新后同步更新这个哈希注解，Kubernetes就会自动触发Pod的滚动重建加载新配置。
  示例操作命令：

  # 更新Deployment的注解，触发重启
  kubectl patch deployment busybox -p "{\"spec\":{\"template\":{\"metadata\":{\"annotations\":{\"configmap/hash\":\"$(kubectl get configmap watch-namespace-config -o yaml | sha256sum | awk '{print $1}')\"}}}}}"
  

  你可以把这个命令集成到CI/CD流程中，每次修改ConfigMap后自动执行即可。

• 方案2：部署配置变更监听控制器
  如果你不想手动处理哈希计算和注解更新，可以部署集群级的配置变更监听控制器，这类控制器会自动监听指定ConfigMap/Secret的更新，检测到变更后自动给关联的Deployment/StatefulSet等工作负载更新注解触发滚动重启，无需人工介入操作。

• 方案3：容器内监听配置变更主动退出（仅适合测试场景）
  如果你坚持使用裸Pod，可以给容器加自定义启动逻辑，定期拉取ConfigMap的当前值和本地环境变量对比，发现不一致就主动退出进程，依赖Pod的restartPolicy自动重启加载新配置。示例配置如下：

  kind: Pod
  metadata:
    name: busybox
    namespace: default
  spec:
    # 需要先给对应serviceaccount授予configmap的读权限
    serviceAccountName: default
    containers:
    - image: busybox
      command:
        - /bin/sh
        - -c
        - |
          echo "$WATCH_NAMESPACE" > /tmp/init_watch_ns
          # 后台定期检测配置变更
          while true; do
            current_ns=$(kubectl get configmap watch-namespace-config -o jsonpath='{.data.WATCH_NAMESPACE}')
            if [ "$current_ns" != "$(cat /tmp/init_watch_ns)" ]; then
              exit 1
            fi
            sleep 10
          done &
          # 主进程
          sleep 3600
      imagePullPolicy: IfNotPresent
      name: busybox
      env:
        - name: WATCH_NAMESPACE
          valueFrom:
            configMapKeyRef:
              name: watch-namespace-config
              key: WATCH_NAMESPACE
    restartPolicy: Always
  

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