容器与云原生 / 系统课时

滚动更新与版本回退

滚动更新与版本回退

本课通过一个可执行的 Deployment 示例,配置滚动更新节奏、观察新旧 ReplicaSet 的替换过程,并在新版本异常时按历史修订回退,最终形成一套可验证、可恢复的发布流程。

学习目标

  • 理解 maxSurge、maxUnavailable 如何共同控制更新速度与可用性
  • 使用 kubectl rollout 查看发布状态、历史修订并执行回退
  • 通过镜像版本、Pod 状态和历史记录验证发布结果

配置滚动更新策略

Deployment 更新 Pod 模板后,不会直接修改原有 Pod,而是创建新的 ReplicaSet,再逐步扩大新副本、缩小旧副本。下面配置 4 个副本,并允许更新期间最多额外创建 1 个 Pod、最多有 1 个期望副本暂时不可用。

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
  annotations:
    kubernetes.io/change-cause: "initial release nginx 1.25"
spec:
  replicas: 4
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 1
      maxUnavailable: 1
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: nginx
          image: nginx:1.25-alpine
          ports:
            - containerPort: 80
          readinessProbe:
            httpGet:
              path: /
              port: 80
            periodSeconds: 3
            failureThreshold: 3

该配置生效后,更新期间 Pod 总数最多为 5,至少应保持 3 个可用副本。Readiness Probe 未通过的新 Pod 不会被计入可用副本,因此能阻止控制器过早删除旧 Pod。

Deployment 滚动更新与回退控制流程

执行一次滚动发布

将清单保存为 web-deployment.yaml,先创建初始版本,再把变更原因写入 Deployment 后更新镜像。先记录原因、后修改 Pod 模板,可以让新 ReplicaSet 保存正确的发布说明。

bash
kubectl apply -f web-deployment.yaml
kubectl rollout status deployment/web
kubectl annotate deployment/web kubernetes.io/change-cause="upgrade to nginx 1.26" --overwrite
kubectl set image deployment/web nginx=nginx:1.26-alpine
kubectl rollout status deployment/web
kubectl rollout history deployment/web

预期输出的关键部分如下,修订号和等待时长可能因集群现状不同而变化。

text
deployment.apps/web created
deployment "web" successfully rolled out
deployment.apps/web annotated
deployment.apps/web image updated
deployment "web" successfully rolled out
deployment.apps/web
REVISION  CHANGE-CAUSE
1         initial release nginx 1.25
2         upgrade to nginx 1.26

kubectl rollout status 会持续等待,直到新副本达到期望数量且旧副本完成缩容。若镜像无法拉取或 Readiness 一直失败,命令会保持等待,此时应先查看 Pod 事件,而不是继续叠加新版本。

在异常时回退版本

确认新版本异常后,可以回退到指定修订。回退本身仍由 Deployment 以滚动方式完成,不会直接恢复已经删除的 Pod,而是重新使用目标修订中的 Pod 模板创建新副本。

bash
kubectl rollout undo deployment/web --to-revision=1
kubectl rollout status deployment/web
kubectl get deployment web -o jsonpath='{.spec.template.spec.containers[0].image}'; echo

预期输出如下。

text
deployment.apps/web rolled back
deployment "web" successfully rolled out
nginx:1.25-alpine

回退后还应执行 kubectl get pods -l app=web,确认所有 Pod 为 Running 且 READY 列达到 1/1。如果历史中看不到需要的修订,通常是旧 ReplicaSet 已被 revisionHistoryLimit 清理,不能再依赖 rollout undo 恢复。

发布失败的定位顺序

先运行 kubectl rollout status deployment/web 判断发布是否完成,再用 kubectl get pods -l app=web 找到异常 Pod,最后通过 kubectl describe pod <POD_NAME> 查看镜像拉取、探针和调度事件。只有确认根因后,才决定继续修复当前版本还是立即回退。

常见错误包括把 maxUnavailable 设得过大导致容量骤降、没有 Readiness Probe 就过早接收流量,以及复用浮动镜像标签导致修订内容难以追溯。生产发布应使用不可变镜像标签或镜像摘要,并在变更前记录发布原因。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

滚动更新与版本回退

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通