从 Pod 快照恢复工作负载

如需缩短 Google Kubernetes Engine (GKE) 工作负载的启动延迟时间,您可以从正在运行的 Pod 的已保存快照中恢复新 Pod。本文档介绍了如何查看现有快照、从最新快照或特定快照恢复工作负载,以及停用或删除快照。如需详细了解 Pod 快照的工作原理,请参阅 GKE Pod 快照简介。

本文档适用于管理其工作负载的 Pod 快照的平台管理员、运维人员和应用开发者。如需详细了解我们在 Google Cloud 内容中提及的常见角色和示例任务,请参阅常见的 GKE 用户角色和任务。

准备工作

在开始之前,请确保您已执行以下任务:

  • 启用 Google Kubernetes Engine API。
  • 启用 Google Kubernetes Engine API
  • 如需使用 Google Cloud CLI 执行此任务,请安装并初始化 gcloud CLI。如果您之前安装了 gcloud CLI,请通过运行 gcloud components update 命令来获取最新版本。较早版本的 gcloud CLI 可能不支持运行本文档中的命令。
  • 准备集群和存储环境,并触发工作负载的快照。如需满足这些前提条件,请按顺序完成以下文档中的任务:

    1. 准备 Pod 快照
    2. 触发 Pod 快照

查看快照

触发 Pod 快照时,GKE 会创建一个 PodSnapshot 自定义资源,用于表示当时的 Pod 状态。此自定义资源的 status 字段指示快照操作是否成功,以及快照是否可用于恢复 Pod。

如需查看命名空间中的所有 PodSnapshot,请运行以下命令:

kubectl get podsnapshots.podsnapshot.gke.io \
    --namespace NAMESPACE

将 NAMESPACE 替换为 Pod 的命名空间。

输出类似于以下内容:

NAME                                  STATUS                 POLICY          AGE
de334898-1e7a-4cdb-9f2e-7cc2181c29e4  AllSnapshotsAvailable  example-policy  47h

在此输出中,NAME 列显示 GKE 为每个 PodSnapshot 自动生成的唯一名称。STATUS 列显示 AllSnapshotsAvailable 值,这意味着快照已准备好恢复 Pod。

从最新快照恢复工作负载

当 Pod 启动并与现有快照匹配时,GKE 会自动从最新快照恢复 Pod,而不是从全新状态启动 Pod。您可以通过以下任一方式触发此恢复:

  • 创建新 Pod:部署具有相同规范的 Pod,例如在添加副本时。
  • 重新部署现有 Pod:删除现有 Pod,然后重新部署。

如需通过删除并重新部署现有 Pod 来恢复该 Pod,请按以下步骤操作:

  1. 删除 Pod:

    kubectl delete pod POD_NAME \
        --namespace NAMESPACE
    

    替换以下内容:

    • POD_NAME:您的 pod 的名称。
    • NAMESPACE:Pod 的命名空间。
  2. 重新部署 Pod:

    kubectl apply -f MANIFEST_FILE
    

    将 MANIFEST_FILE 替换为 Pod 的清单文件的路径。

  3. 如需确认 GKE 已从快照恢复 Pod,请查看 Pod 日志:

    kubectl logs POD_NAME \
        --namespace NAMESPACE
    

    输出取决于您配置应用的方式。例如,如果您部署了从工作负载触发快照中的示例 Python 应用,则当 GKE 恢复 Pod 时,日志会显示 GKE Pod Snapshot: restore。

从特定快照恢复工作负载

默认情况下,GKE 会从与 Pod 匹配的最新 PodSnapshot 恢复工作负载。如需从特定 PodSnapshot 恢复工作负载,请按照以下步骤将 podsnapshot.gke.io/ps-name 注解添加到工作负载 Pod 规范中:

  1. 如需查找要从中恢复的 PodSnapshot 的名称,请列出命名空间中的 PodSnapshot:

    kubectl get podsnapshots.podsnapshot.gke.io \
        --namespace NAMESPACE
    

    将 NAMESPACE 替换为 Pod 的命名空间。

  2. 在 Pod 清单中,添加 podsnapshot.gke.io/ps-name 注解并指定 PodSnapshot 的名称:

    apiVersion: v1
    kind: Pod
    metadata:
      name: my-app
      namespace: NAMESPACE
      labels:
        app: my-app
      annotations:
        podsnapshot.gke.io/ps-name: "POD_SNAPSHOT_NAME"
    spec:
      serviceAccountName: SERVICEACCOUNT_NAME
      runtimeClassName: gvisor
      containers:
      # Multiple lines are omitted here
    

    替换以下内容:

    • POD_SNAPSHOT_NAME:要从中恢复的 PodSnapshot 的名称。使用您在上一步中找到的名称。
    • SERVICEACCOUNT_NAME:您在准备 Pod 快照中向其授予 Cloud Storage 访问权限的 ServiceAccount 对象的名称。
  3. 应用清单:

    kubectl apply -f MANIFEST_FILE
    

    将 MANIFEST_FILE 替换为 Pod 的清单文件的路径。

为了让 GKE 从指定快照恢复 Pod,PodSnapshot 必须与 Pod 位于同一命名空间中,并且具有 Ready 状态条件。如果 PodSnapshot 不满足这些要求,则 Pod 会从全新状态启动,而不是从快照恢复。

快照匹配和兼容性

当 GKE 从快照恢复 Pod 时,GKE 会检查可用快照是否与 Pod 兼容。为了确定兼容性,GKE 会评估选择顺序、配置的 whole-pod 或 rootfs-only 快照范围的匹配条件以及任何快照分组规则。

如需详细了解匹配要求、兼容性条件以及影响兼容性的 Pod 规范字段,请参阅快照匹配和兼容性。

停用或删除快照

是删除 PodSnapshotPolicy 还是 PodSnapshot 取决于您是要为整个工作负载停用快照,还是要删除一个已保存的快照。PodSnapshotPolicy 负责管理与其选择器匹配的所有 Pod 的快照行为,每个 PodSnapshot 代表一个快照。

如需为工作负载停用快照,请删除管理这些 Pod 的 PodSnapshotPolicy。删除政策会阻止 GKE 为该工作负载创建新快照或恢复 Pod,但不会影响正在运行的 Pod。但是,如果您在 GKE 保存或恢复 Pod 时删除该政策,则 Pod 可能会进入失败状态。

如需删除 PodSnapshotPolicy,请运行以下命令:

kubectl delete podsnapshotpolicies.podsnapshot.gke.io \
    SNAPSHOT_POLICY \
    --namespace NAMESPACE

替换以下内容:

  • SNAPSHOT_POLICY:要删除的 PodSnapshotPolicy 的名称,例如 example-pod-snapshot-policy。
  • NAMESPACE:Pod 的命名空间。

您还可以删除特定的 PodSnapshot,以便 GKE 不再从该快照恢复 Pod。删除 PodSnapshot 也会删除存储在 Cloud Storage 中的相应快照文件。

如需删除特定 PodSnapshot,请运行以下命令:

kubectl delete podsnapshots.podsnapshot.gke.io \
    POD_SNAPSHOT_NAME \
    --namespace NAMESPACE

将 POD_SNAPSHOT_NAME 替换为您要删除的 PodSnapshot 的名称,例如 de334898-1e7a-4cdb-9f2e-7cc2181c29e4。

后续步骤