修改ConfigMap后如何强制K8s重新拉取Pod镜像？

我有如下YAML配置，希望每次修改ConfigMap并执行kubectl apply -f命令后，Pod能重新拉取镜像。我尝试过修改Deployment的annotation，看到有说法称当imagePullPolicy设置为Always时，修改annotation会触发镜像重拉，但并未生效。相关配置如下：

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: ConfigMap
metadata:
  name: my-configmap
data:
  index.html: |
    <html>
      <head>
        <title>Testing FluxCD</title>
      </head>
      <body>
        <h1>Version 2.0</h1>
      </body>
    </html>
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-nginx
  annotations:
   "version": "2"
spec:
  selector:
    matchLabels:
      app: my-nginx
  replicas: 1
  template:
    metadata:
      labels:
        app: my-nginx
    spec:
      containers:
      - name: nginx
        image: nginx:latest
        imagePullPolicy: Always
        ports:
        - containerPort: 80
        volumeMounts:
        - name: html
          mountPath: /usr/share/nginx/html
      volumes:
      - name: html
        configMap:
          name: my-configmap
EOF

解决方案 #

核心问题说明 #

修改Deployment顶层metadata的annotation不会触发Pod重建，因为Kubernetes只会检测Pod模板（spec.template）的变化。只有当Pod模板内容改变时，才会触发滚动更新Pod，进而结合imagePullPolicy: Always重新拉取镜像。

可行解决方法 #

• 修改Pod模板内的标识：在spec.template.metadata中添加或更新annotation/label，比如新增config-revision字段，每次修改ConfigMap时同步更新该值。示例修改后的Deployment片段：

  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: my-nginx
    annotations:
      "version": "2"
  spec:
    selector:
      matchLabels:
        app: my-nginx
    replicas: 1
    template:
      metadata:
        labels:
          app: my-nginx
        annotations:
          "config-revision": "2" # 每次修改ConfigMap时更新此值
      spec:
        containers:
        - name: nginx
          image: nginx:latest
          imagePullPolicy: Always
          ports:
          - containerPort: 80
          volumeMounts:
          - name: html
            mountPath: /usr/share/nginx/html
        volumes:
        - name: html
          configMap:
            name: my-configmap
  

• 手动触发滚动更新：直接执行命令kubectl rollout restart deployment/my-nginx，该命令会强制Deployment滚动重启所有Pod，结合imagePullPolicy: Always即可重新拉取镜像，无需修改配置。
• 自动注入ConfigMap哈希值：借助Kustomize等工具，将ConfigMap的哈希值自动注入到Pod模板的annotation/label中。每次ConfigMap修改后，哈希值变化会自动触发Pod重建，无需手动维护版本号。

补充说明 #

imagePullPolicy: Always仅在Pod启动阶段生效，因此只有Pod重建时才会触发镜像拉取。若仅修改ConfigMap未触发Pod重建，即使配置了Always，也不会重新拉取镜像。

内容的提问来源于stack exchange，提问作者Chris G.