Restaurar uma carga de trabalho de um snapshot de pod

Para reduzir a latência de inicialização das cargas de trabalho do Google Kubernetes Engine (GKE), é possível restaurar novos pods de um snapshot salvo de um pod em execução. Neste documento, mostramos como visualizar snapshots, restaurar cargas de trabalho do snapshot mais recente ou de um snapshot específico e desativar ou excluir snapshots. Para mais informações sobre como os snapshots de pods funcionam, consulte Sobre os snapshots de pods do GKE.

Este documento é destinado a administradores e operadores de plataforma e desenvolvedores de aplicativos que gerenciam snapshots de pods para as cargas de trabalho. Para mais informações sobre os papéis comuns e as tarefas de exemplo referenciados no conteúdo do Google Cloud , consulte Papéis e tarefas comuns de usuário do GKE.

Antes de começar

Antes de começar, verifique se você realizou as tarefas a seguir:

  • Ative a API Google Kubernetes Engine.
  • Ativar a API Google Kubernetes Engine
  • Para usar a Google Cloud CLI nesta tarefa, instale e inicialize a CLI gcloud. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando o comando gcloud components update. Talvez as versões anteriores da CLI gcloud não sejam compatíveis com a execução dos comandos neste documento.

Ver snapshots

Quando você aciona um snapshot de pod, o GKE cria um recurso personalizado PodSnapshot que representa o estado do pod naquele momento. O campo status desse recurso personalizado indica se a operação de snapshot foi bem-sucedida e se o snapshot está disponível para restaurar pods.

Para ver todos os PodSnapshots em um namespace, execute o seguinte comando:

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

Substitua NAMESPACE pelo namespace dos pods.

O resultado será o seguinte:

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

Nessa saída, a coluna NAME mostra o nome exclusivo que o GKE gera automaticamente para cada PodSnapshot. A coluna STATUS mostra o valor AllSnapshotsAvailable, o que significa que o snapshot está pronto para restaurar pods.

Restaurar uma carga de trabalho do snapshot mais recente

Quando um pod é iniciado e corresponde a um snapshot atual, o GKE restaura automaticamente o pod do snapshot mais recente, em vez de iniciá-lo do zero. É possível acionar essa restauração de uma das seguintes maneiras:

  • Criar um novo pod: implante um pod com uma especificação idêntica, como ao adicionar réplicas.
  • Reimplantar um pod atual: exclua o pod atual e o reimplante.

Para restaurar um pod atual excluindo e reimplantando-o, siga estas etapas:

  1. Exclua o pod:

    kubectl delete pod POD_NAME \
        --namespace NAMESPACE
    

    Substitua:

    • POD_NAME: o nome do pod.
    • NAMESPACE: o namespace dos pods.
  2. Reimplante o pod:

    kubectl apply -f MANIFEST_FILE
    

    Substitua MANIFEST_FILE pelo caminho para o arquivo de manifesto do pod.

  3. Para confirmar que o GKE restaurou o pod do snapshot, confira os registros do pod:

    kubectl logs POD_NAME \
        --namespace NAMESPACE
    

    A saída depende de como você configurou o aplicativo. Por exemplo, se você implantou o aplicativo Python de exemplo de Acionar um snapshot de uma carga de trabalho, os registros vão mostrar GKE Pod Snapshot: restore quando o GKE restaurar o pod.

Restaurar uma carga de trabalho de um snapshot específico

Por padrão, o GKE restaura cargas de trabalho do PodSnapshot mais recente que corresponde ao pod. Para restaurar uma carga de trabalho de um PodSnapshot específico, adicione a anotação podsnapshot.gke.io/ps-name à especificação do pod da carga de trabalho seguindo estas etapas:

  1. Para encontrar o nome do PodSnapshot que você quer restaurar, liste os PodSnapshots no namespace:

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

    Substitua NAMESPACE pelo namespace dos pods.

  2. No manifesto do pod, adicione a anotação podsnapshot.gke.io/ps-name e especifique o nome do 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
    

    Substitua:

    • POD_SNAPSHOT_NAME: o nome do PodSnapshot que você quer restaurar. Use o nome que você encontrou na etapa anterior.
    • SERVICEACCOUNT_NAME: o nome do objeto ServiceAccount ao qual você concedeu acesso ao Cloud Storage em Preparar para snapshots de pod.
  3. Aplique o manifesto:

    kubectl apply -f MANIFEST_FILE
    

    Substitua MANIFEST_FILE pelo caminho para o arquivo de manifesto do pod.

Para que o GKE restaure o pod do snapshot especificado, o PodSnapshot precisa existir no mesmo namespace que o pod e ter uma condição de status Ready. Se o PodSnapshot não atender a esses requisitos, o pod será iniciado em um estado novo, em vez de ser restaurado do snapshot.

Correspondência e compatibilidade de snapshots

Quando o GKE restaura um pod de um snapshot, ele verifica se um snapshot disponível é compatível com o pod. Para determinar a compatibilidade, o GKE avalia a ordem de seleção, os critérios de correspondência para os escopos do snapshot whole-pod ou rootfs-only configurados e todas as regras de agrupamento de snapshots.

Para mais informações sobre requisitos de correspondência, critérios de compatibilidade e os campos de especificação do pod que afetam a compatibilidade, consulte Correspondência e compatibilidade de snapshots.

Desativar ou excluir snapshots

A exclusão de uma PodSnapshotPolicy ou de um PodSnapshot depende se você quer desativar os snapshots de uma carga de trabalho inteira ou excluir um snapshot salvo. Uma PodSnapshotPolicy rege o comportamento de snapshot para todos os pods que correspondem ao seletor, e cada PodSnapshot representa um único snapshot.

Para desativar as capturas de tela de uma carga de trabalho, exclua a PodSnapshotPolicy que rege esses pods. A exclusão da política impede que o GKE faça novos snapshots ou restaure pods para essa carga de trabalho, mas não afeta os pods em execução. No entanto, se você excluir a política enquanto o GKE estiver salvando ou restaurando um pod, ele poderá entrar em um estado de falha.

Para excluir uma PodSnapshotPolicy, execute o seguinte comando:

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

Substitua:

  • SNAPSHOT_POLICY: o nome da PodSnapshotPolicy que você quer excluir, como example-pod-snapshot-policy.
  • NAMESPACE: o namespace dos pods.

Também é possível excluir um PodSnapshot específico para que o GKE não restaure mais pods desse snapshot. A exclusão do PodSnapshot também exclui os arquivos de snapshot correspondentes armazenados no Cloud Storage.

Para excluir um PodSnapshot específico, execute o seguinte comando:

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

Substitua POD_SNAPSHOT_NAME pelo nome do PodSnapshot que você quer excluir, como de334898-1e7a-4cdb-9f2e-7cc2181c29e4.

A seguir