对 DaemonSet 执行回滚

本文展示了如何对 DaemonSet 执行回滚。

准备开始

你必须拥有一个 Kubernetes 的集群,同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。 建议在至少有两个节点的集群上运行本教程,且这些节点不作为控制平面主机。 如果你还没有集群,你可以通过 Minikube 构建一个你自己的集群,或者你可以使用下面任意一个 Kubernetes 工具构建:

你的 Kubernetes 服务器版本必须不低于版本 1.7. 要获知版本信息,请输入 kubectl version.

你应该已经了解如何为 DaemonSet 执行滚东更新

对 DaemonSet 执行回滚

步骤 1:找到想要 DaemonSet 回滚到的历史修订版本(revision)

如果只想回滚到最后一个版本,可以跳过这一步。

列出 DaemonSet 的所有版本:

  1. kubectl rollout history daemonset <daemonset-name>

此命令返回 DaemonSet 版本列表:

  1. daemonsets "<daemonset-name>"
  2. REVISION CHANGE-CAUSE
  3. 1 ...
  4. 2 ...
  5. ...
  • 在创建时,DaemonSet 的变化原因从 kubernetes.io/change-cause 注解(annotation) 复制到其修订版本中。用户可以在 kubectl 命令中设置 --record=true, 将执行的命令记录在变化原因注解中。

执行以下命令,来查看指定版本的详细信息:

  1. kubectl rollout history daemonset <daemonset-name> --revision=1

该命令返回相应修订版本的详细信息:

  1. daemonsets "<daemonset-name>" with revision #1
  2. Pod Template:
  3. Labels: foo=bar
  4. Containers:
  5. app:
  6. Image: ...
  7. Port: ...
  8. Environment: ...
  9. Mounts: ...
  10. Volumes: ...

步骤 2:回滚到指定版本

  1. # 在 --to-revision 中指定你从步骤 1 中获取的修订版本
  2. kubectl rollout undo daemonset <daemonset-name> --to-revision=<revision>

如果成功,命令会返回:

  1. daemonset "<daemonset-name>" rolled back

说明: 如果 --to-revision 参数未指定,将选中最近的版本。

步骤 3:监视 DaemonSet 回滚进度

kubectl rollout undo daemonset 向服务器表明启动 DaemonSet 回滚。 真正的回滚是在集群的 控制面 异步完成的。

执行以下命令,来监视 DaemonSet 回滚进度:

  1. kubectl rollout status ds/<daemonset-name>

回滚完成时,输出形如:

  1. daemonset "<daemonset-name>" successfully rolled out

理解 DaemonSet 修订版本

在前面的 kubectl rollout history 步骤中,你获得了一个修订版本列表,每个修订版本都存储在名为 ControllerRevision 的资源中。

要查看每个修订版本中保存的内容,可以找到 DaemonSet 修订版本的原生资源:

  1. kubectl get controllerrevision -l <daemonset-selector-key>=<daemonset-selector-value>

该命令返回 ControllerRevisions 列表:

  1. NAME CONTROLLER REVISION AGE
  2. <daemonset-name>-<revision-hash> DaemonSet/<daemonset-name> 1 1h
  3. <daemonset-name>-<revision-hash> DaemonSet/<daemonset-name> 2 1h

每个 ControllerRevision 中存储了相应 DaemonSet 版本的注解和模板。

kubectl rollout undo 选择特定的 ControllerRevision,并用 ControllerRevision 中存储的模板代替 DaemonSet 的模板。 kubectl rollout undo 相当于通过其他命令(如 kubectl editkubectl apply) 将 DaemonSet 模板更新至先前的版本。

说明: 注意 DaemonSet 修订版本只会正向变化。也就是说,回滚完成后,所回滚到的 ControllerRevision 版本号 (.revision 字段) 会增加。 例如,如果用户在系统中有版本 1 和版本 2,并从版本 2 回滚到版本 1, 带有 .revision: 1ControllerRevision 将变为 .revision: 3

故障排查