3. K8s 原生回滚机制详解

Kubernetes 原生回滚机制是 Deployment 控制器内置的版本管理与状态恢复能力，核心围绕 kubectl rollout 命令族展开。本章深入解析回滚命令、历史查看、版本指定及策略参数配置，帮助你在故障排查中精准、快速地恢复服务。

3.1 kubectl rollout undo 命令

kubectl rollout undo 是执行回滚的核心命令，其基本语法如下：

# 回滚到上一个版本（默认）
kubectl rollout undo deployment/<deployment-name>

# 回滚到指定版本
kubectl rollout undo deployment/<deployment-name> --to-revision=<revision-number>

# 回滚并指定命名空间
kubectl rollout undo deployment/<deployment-name> -n <namespace>

3.2 回滚历史查看

回滚历史由 Deployment 的 .metadata.annotations 中的 deployment.kubernetes.io/revision 字段记录，每个 ReplicaSet 对应一个 Revision。使用以下命令查看：

# 查看回滚历史列表
kubectl rollout history deployment/<deployment-name>

# 查看指定版本的详细信息（包含模板内容）
kubectl rollout history deployment/<deployment-name> --revision=<revision-number>

输出示例：

deployment.apps/nginx-deployment
REVISION  CHANGE-CAUSE
1         kubectl apply --filename=nginx-v1.yaml
2         kubectl apply --filename=nginx-v2.yaml
3         kubectl apply --filename=nginx-v3.yaml

3.3 回滚到指定版本

通过 --to-revision 参数可以精确回滚到任意历史版本：

# 回滚到 Revision 2
kubectl rollout undo deployment/nginx-deployment --to-revision=2

回滚过程的状态可以通过以下命令监控：

# 查看回滚状态
kubectl rollout status deployment/nginx-deployment

# 查看回滚过程中的事件
kubectl describe deployment/nginx-deployment

3.4 回滚策略参数配置

回滚行为受 Deployment 的 spec.strategy 参数控制，主要包括滚动更新策略和 Revision 历史限制。下表列出关键参数：

配置示例：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  revisionHistoryLimit: 20  # 保留 20 个历史版本
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 2           # 最多允许超出 2 个 Pod
      maxUnavailable: 1     # 最多允许 1 个 Pod 不可用
  template:
    # ... Pod 模板配置

3.5 回滚流程与状态转换

下图展示了从执行回滚命令到 Pod 状态稳定的完整流程：

3.6 常见回滚场景与避坑指南

• 场景一：回滚后服务仍异常 — 检查目标 Revision 的镜像版本和配置是否正确，必要时回滚到更早的版本。
• 场景二：Revision 历史被清理 — 确认 revisionHistoryLimit 设置是否过小，或手动删除过 ReplicaSet。
• 场景三：回滚过程中 Pod 一直 Pending — 检查资源配额、节点状态、镜像拉取策略等。
• 场景四：回滚后 CHANGE-CAUSE 为空 — 在 kubectl apply 时添加 --record 参数，或在 Deployment 的 metadata.annotations 中手动设置 kubernetes.io/change-cause。