在 Kubernetes 中，修改 Deployment 并触发滚动更新（Rolling Update）是一个核心操作。

核心原则

Deployment 的滚动更新仅在 spec.template（Pod 模板）发生变化时触发。Kubernetes 通过计算 spec.template 的哈希值来判断是否需要创建新的 ReplicaSet 并替换旧的 Pod。

如何修改 Deployment 并触发滚动更新

方法 1：直接修改 spec.template（推荐）

任何对 spec.template 内部字段的修改都会自动触发滚动更新。

操作步骤：

1. 编辑 Deployment 配置：

kubectl edit deployment <deployment-name>

1. 修改 spec.template 中的字段，例如：

• 容器镜像：

spec:
  template:
    spec:
      containers:
        - name: nginx
          image: nginx:1.21 # 从 nginx:1.19 更新到 nginx:1.21

• 环境变量：

spec:
  template:
    spec:
      containers:
        - name: app
          env:
            - name: VERSION
              value: "2.0" # 修改环境变量值

• 资源限制：

spec:
  template:
    spec:
      containers:
        - name: app
          resources:
            requests:
              memory: "256Mi"
              cpu: "100m"
            limits:
              memory: "512Mi"
              cpu: "200m"

• 卷挂载（如你之前的问题）：

spec:
  template:
    spec:
      containers:
        - name: app
          volumeMounts:
            - name: new-config
              mountPath: /etc/new-config
      volumes:
        - name: new-config
          configMap:
            name: updated-configmap

1. 保存并退出（如果使用 kubectl edit）。

1. 观察滚动更新：

kubectl rollout status deployment/<deployment-name>
# 示例输出：Waiting for deployment "my-app" rollout to finish: 1 old replicas are pending termination...
# 最终输出：deployment "my-app" successfully rolled out
kubectl get pods -w # 实时观察旧 Pod 终止，新 Pod 启动

方法 2：使用 kubectl set 命令（快速修改镜像）

专门用于快速更新容器镜像。

kubectl set image deployment/<deployment-name> <container-name>=<new-image>:<tag>
# 例如：
kubectl set image deployment/nginx-deployment nginx=nginx:1.21

此命令会直接修改 spec.template.spec.containers[].image，从而触发滚动更新。

方法 3：强制重启（最可靠）

如果修改了 spec.template 但不确定是否触发更新，或想明确重启，使用：

kubectl rollout restart deployment/<deployment-name>

原理：此命令会在 spec.template.metadata.annotations 中添加一个时间戳注解（如 kubectl.kubernetes.io/restartedAt: "2025-08-22T07:30:00Z"），强制改变 Pod 模板，从而100%触发滚动更新。

方法 4：修改 spec.template.metadata.annotations（手动触发）

这是 最佳实践，用于确保任何变更（尤其是非容器字段变更）都能触发更新。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  template:
    metadata:
      labels:
        app: my-app
      annotations:
        # 添加或修改此注解会强制触发更新
        kubernetes.io/change-cause: "Updated config on 2025-08-22"
        # 或
        # kubectl.kubernetes.io/restartedAt: "2025-08-22T07:30:00Z"
    spec:
      containers:
        - name: my-container
          image: my-image:v1
          # ... 其他配置

应用后：

kubectl apply -f deployment.yaml

什么修改 不会 触发滚动更新？

修改 spec 中 template 之外的字段，不会创建新 Pod：

• spec.replicas：只调整 Pod 数量，现有 Pod 不重启。
• spec.strategy：修改更新策略参数，但只影响下一次滚动更新。
• spec.selector：禁止修改，会导致不可预测行为。

验证更新是否成功

1. 检查滚动状态：

kubectl rollout status deployment/<deployment-name>

1. 查看新旧 ReplicaSet：

kubectl get replicaset -l app=<your-app-label>
# 你会看到旧的 ReplicaSet (DESIRED > 0) 和新的 ReplicaSet (CURRENT > 0)

1. 检查新 Pod 的配置：

kubectl get pod <new-pod-name> -o yaml | grep -A 10 "containers"
# 确认镜像、环境变量、卷等已更新

回滚到上一个版本

如果更新后出现问题：

kubectl rollout undo deployment/<deployment-name>
# 回滚到更早的版本
kubectl rollout undo deployment/<deployment-name> --to-revision=2

总结

• 触发条件：只有 spec.template 变化才会触发滚动更新。
• 推荐方法：
• 直接修改 spec.template 中的配置（如镜像、环境变量、卷）。
• 或 使用 kubectl rollout restart deployment/<name> 强制重启。
• 或 在 spec.template.metadata.annotations 中添加注解作为明确信号。
• 避免：依赖修改 spec.replicas 等非 template 字段来触发更新。