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.
Prepare o cluster e o ambiente de armazenamento e acione um snapshot da carga de trabalho. Para atender a esses pré-requisitos, conclua as tarefas nos seguintes documentos, em ordem:
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:
Exclua o pod:
kubectl delete pod POD_NAME \ --namespace NAMESPACESubstitua:
POD_NAME: o nome do pod.NAMESPACE: o namespace dos pods.
Reimplante o pod:
kubectl apply -f MANIFEST_FILESubstitua
MANIFEST_FILEpelo caminho para o arquivo de manifesto do pod.Para confirmar que o GKE restaurou o pod do snapshot, confira os registros do pod:
kubectl logs POD_NAME \ --namespace NAMESPACEA 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: restorequando 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:
Para encontrar o nome do PodSnapshot que você quer restaurar, liste os PodSnapshots no namespace:
kubectl get podsnapshots.podsnapshot.gke.io \ --namespace NAMESPACESubstitua
NAMESPACEpelo namespace dos pods.No manifesto do pod, adicione a anotação
podsnapshot.gke.io/ps-namee 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 hereSubstitua:
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.
Aplique o manifesto:
kubectl apply -f MANIFEST_FILESubstitua
MANIFEST_FILEpelo 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, comoexample-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.