Per ridurre la latenza di avvio dei workload di Google Kubernetes Engine (GKE), puoi ripristinare i nuovi pod da uno snapshot salvato di un pod in esecuzione. Questo documento mostra come visualizzare gli snapshot esistenti, ripristinare i workload dall'ultimo snapshot o da uno snapshot specifico e disabilitare o eliminare gli snapshot. Per saperne di più su come funzionano gli snapshot dei pod, consulta Informazioni sugli snapshot dei pod GKE.
Questo documento è rivolto agli amministratori e agli operatori della piattaforma e agli sviluppatori di applicazioni che gestiscono gli snapshot dei pod per i loro workload. Per saperne di più sui ruoli comuni e sulle attività di esempio a cui si fa riferimento nei contenuti di Google Cloud , consulta Ruoli e attività comuni degli utenti GKE.
Prima di iniziare
Prima di iniziare, assicurati di aver eseguito le seguenti attività:
- Abilita l'API Google Kubernetes Engine. Abilita l'API Google Kubernetes Engine
- Per utilizzare Google Cloud CLI per questa attività,
installala e poi
inizializza
gcloud CLI. Se hai già installato gcloud CLI, scarica l'ultima
versione eseguendo il comando
gcloud components update. Le versioni precedenti di gcloud CLI potrebbero non supportare l'esecuzione dei comandi in questo documento.
Prepara l'ambiente del cluster e dello spazio di archiviazione e attiva uno snapshot del tuo workload. Per soddisfare questi prerequisiti, completa le attività nei seguenti documenti nell'ordine indicato:
Visualizza snapshot
Quando attivi uno snapshot del pod, GKE crea una risorsa personalizzata PodSnapshot che rappresenta lo stato del pod in quel momento. Il campo status di questa risorsa personalizzata indica se l'operazione di snapshot è riuscita e se lo snapshot è disponibile per il ripristino dei pod.
Per visualizzare tutti i PodSnapshot in uno spazio dei nomi, esegui questo comando:
kubectl get podsnapshots.podsnapshot.gke.io \
--namespace NAMESPACE
Sostituisci NAMESPACE con lo spazio dei nomi dei tuoi pod.
L'output è simile al seguente:
NAME STATUS POLICY AGE
de334898-1e7a-4cdb-9f2e-7cc2181c29e4 AllSnapshotsAvailable example-policy 47h
In questo output, la colonna NAME mostra il nome univoco che GKE genera automaticamente per ogni PodSnapshot. La colonna STATUS mostra il valore AllSnapshotsAvailable, il che significa che lo snapshot è pronto per il ripristino dei pod.
Ripristina un workload dall'ultimo snapshot
Quando un pod viene avviato e corrisponde a uno snapshot esistente, GKE lo ripristina automaticamente dall'ultimo snapshot anziché avviarlo da uno stato nuovo. Puoi attivare questo ripristino in uno dei seguenti modi:
- Crea un nuovo pod: esegui il deployment di un pod con una specifica identica, ad esempio quando aggiungi repliche.
- Rifai il deployment di un pod esistente: elimina il pod esistente, quindi rifai il deployment.
Per ripristinare un pod esistente eliminandolo e rifacendone il deployment, segui questi passaggi:
Elimina il pod:
kubectl delete pod POD_NAME \ --namespace NAMESPACESostituisci quanto segue:
POD_NAME: il nome del pod.NAMESPACE: lo spazio dei nomi dei pod.
Rifai il deployment del pod:
kubectl apply -f MANIFEST_FILESostituisci
MANIFEST_FILEcon il percorso del file manifest del pod.Per confermare che GKE ha ripristinato il pod dallo snapshot, visualizza i log del pod:
kubectl logs POD_NAME \ --namespace NAMESPACEL'output dipende dalla configurazione dell'applicazione. Ad esempio, se hai eseguito il deployment dell'applicazione Python di esempio da Attiva uno snapshot da un workload, i log mostrano
GKE Pod Snapshot: restorequando GKE ripristina il pod.
Ripristina un workload da uno snapshot specifico
Per impostazione predefinita, GKE ripristina i workload dal PodSnapshot più recente che corrisponde al pod. Per ripristinare un workload da un PodSnapshot specifico, aggiungi l'annotazione podsnapshot.gke.io/ps-name alla specifica del pod del workload seguendo questi passaggi:
Per trovare il nome del PodSnapshot da cui vuoi eseguire il ripristino, elenca i PodSnapshot nel tuo spazio dei nomi:
kubectl get podsnapshots.podsnapshot.gke.io \ --namespace NAMESPACESostituisci
NAMESPACEcon lo spazio dei nomi dei tuoi pod.Nel manifest del pod, aggiungi l'annotazione
podsnapshot.gke.io/ps-namee specifica il nome di 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 hereSostituisci quanto segue:
POD_SNAPSHOT_NAME: il nome del PodSnapshot da cui vuoi eseguire il ripristino. Utilizza il nome che hai trovato nel passaggio precedente.SERVICEACCOUNT_NAME: il nome dell'oggetto ServiceAccount a cui hai concesso l'accesso a Cloud Storage in Preparati per gli snapshot dei pod.
Applica il manifest:
kubectl apply -f MANIFEST_FILESostituisci
MANIFEST_FILEcon il percorso del file manifest del pod.
Affinché GKE possa ripristinare il pod dallo snapshot specificato, il PodSnapshot deve esistere nello stesso spazio dei nomi del pod e avere una condizione di stato Ready. Se il PodSnapshot non soddisfa questi requisiti, il pod viene avviato da uno stato nuovo anziché essere ripristinato dallo snapshot.
Corrispondenza e compatibilità degli snapshot
Quando GKE ripristina un pod da uno snapshot, GKE
controlla se uno snapshot disponibile è compatibile con il pod. Per determinare la compatibilità, GKE valuta l'ordine di selezione, i criteri di corrispondenza per gli scope dello snapshot whole-pod o rootfs-only configurati e le eventuali regole di raggruppamento degli snapshot.
Per ulteriori informazioni sui requisiti di corrispondenza, sui criteri di compatibilità e sui campi della specifica del pod che influiscono sulla compatibilità, consulta Corrispondenza e compatibilità degli snapshot.
Disattiva o elimina gli snapshot
L'eliminazione di un PodSnapshotPolicy o di un PodSnapshot dipende dal fatto che tu voglia disattivare gli snapshot per un intero workload o eliminare uno snapshot salvato. Un PodSnapshotPolicy regola il comportamento degli snapshot per tutti i pod che corrispondono al selettore e ogni PodSnapshot rappresenta un singolo snapshot.
Per disattivare gli snapshot per un workload, elimina il PodSnapshotPolicy che regola i pod. L'eliminazione della policy impedisce a GKE di acquisire nuovi snapshot o di ripristinare i pod per quel workload, ma non influisce sui pod in esecuzione. Tuttavia, se elimini la policy mentre GKE salva o ripristina un pod, quest'ultimo potrebbe entrare in uno stato di errore.
Per eliminare un oggetto PodSnapshotPolicy, esegui questo comando:
kubectl delete podsnapshotpolicies.podsnapshot.gke.io \
SNAPSHOT_POLICY \
--namespace NAMESPACE
Sostituisci quanto segue:
SNAPSHOT_POLICY: il nome della risorsa PodSnapshotPolicy che vuoi eliminare, ad esempioexample-pod-snapshot-policy.NAMESPACE: lo spazio dei nomi dei pod.
Puoi anche eliminare un PodSnapshot specifico in modo che GKE non ripristini più i pod da quello snapshot. L'eliminazione di PodSnapshot elimina anche i file di snapshot corrispondenti archiviati in Cloud Storage.
Per eliminare un PodSnapshot specifico, esegui questo comando:
kubectl delete podsnapshots.podsnapshot.gke.io \
POD_SNAPSHOT_NAME \
--namespace NAMESPACE
Sostituisci POD_SNAPSHOT_NAME con il nome del PodSnapshot che vuoi eliminare, ad esempio de334898-1e7a-4cdb-9f2e-7cc2181c29e4.