Questa pagina descrive come creare un piano di ripristino di Backup per GKE da utilizzare per ripristinare i backup in Google Kubernetes Engine (GKE).
I piani di ripristino sono scenari di ripristino preconfigurati per una riga di backup corrispondente. I piani di ripristino possono assegnare autorizzazioni per consentire agli amministratori di utilizzare queste configurazioni. Questi utenti possono ripristinare un backup in modo rapido e in modo indipendente quando si verifica un incidente. Ad esempio, i dati permanenti potrebbero essere danneggiati da un aggiornamento del software in un'applicazione di cui è stato eseguito il deployment, impostando lo spazio dei nomi dell'applicazione in uno stato non valido, il che richiede un ripristino.
Durante il ripristino, puoi facoltativamente applicare regole di trasformazione, che vengono utilizzate per trovare corrispondenze con un insieme di risorse e sostituire il valore attuale di un attributo su queste risorse con un nuovo valore.
Prima di iniziare
Pianifica un insieme di backup.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare e gestire un piano di ripristino,
chiedi all'amministratore di concederti
Amministratore ripristino Backup per GKE (roles/gkebackup.restoreAdmin
), che è un sottoinsieme del ruolo IAM Backup per GKE (roles/gkebackup.admin
)
nel tuo progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Crea un piano di ripristino
Puoi creare un piano di ripristino per i backup utilizzando Google Cloud CLI o la console Google Cloud.
gcloud
Per creare un piano di ripristino, esegui questo comando:
gcloud beta container backup-restore restore-plans create RESTORE_PLAN \
--project=PROJECT_ID \
--location=LOCATION \
--backup-plan=BACKUP_PLAN \
--cluster=CLUSTER \
--namespaced-resource-restore-mode=NAMESPACED_RESOURCE_RESTORE_MODE \
--all-namespaces \
--cluster-resource-conflict-policy=CLUSTER_RESOURCE_CONFLICT_POLICY \
--cluster-resource-scope-selected-group-kinds=CLUSTER_RESOURCE_SCOPE \
--volume-data-restore-policy=VOLUME_DATA_RESTORE_POLICY
Sostituisci quanto segue:
RESTORE_PLAN
: il nome del piano di ripristino che vuoi creare.PROJECT_ID
: l'ID del tuo progetto Google Cloud.LOCATION
: la regione di computing per la risorsa, ad esempious-central1
. Consulta Informazioni sulle località delle risorse. La località deve essere nella stessa regione in cui si trova il cluster di destinazione.BACKUP_PLAN
: l'origine dei backup che possono essere ripristinati con questo piano di ripristino:projects/PROJECT_ID/locations/BACKUP_LOCATION/backupPlans/BACKUP_PLAN_NAME
CLUSTER
: il nome del cluster di destinazione in cui vuoi ripristinare il backup:- Cluster a livello di regione:
projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME
- Cluster di zona:
projects/PROJECT_ID/locations/ZONE/clusters/CLUSTER_NAME
- Cluster a livello di regione:
NAMESPACED_RESOURCE_RESTORE_MODE
: definisce come gestire i conflitti in fase di ripristino per le risorse con spazio dei nomi. Le risorse con pacing dei nomi vengono sempre ripristinate in gruppi, per spazio dei nomi o da ProtectedApplication. Utilizza una delle seguenti opzioni:merge-skip-on-conflict
: ignora le singole risorse in conflitto.merge-replace-volume-on-conflict
: ignora le singole risorse in conflitto, ma sostituisci i dati del volume permanente sottostante.merge-replace-on-conflict
: sostituisce le singole risorse in conflitto e i dati del volume permanente sottostanti.delete-and-restore
: quando il cluster di destinazione contiene lo stesso gruppo di risorse di destinazione del ripristino nel cluster, il gruppo di risorse esistente viene eliminato prima del ripristino delle nuove risorse.fail-on-conflict
: se nel cluster di destinazione esistono già gruppi di risorse destinate al ripristino da un backup, il ripristino non andrà a buon fine.
--all-namespaces
: ripristina tutte le risorse con spazio dei nomi nel backup. In alternativa, specifica:--excluded-namespaces
con un elenco di spazi dei nomiNAMESPACE1,NAMESPACE2,...
per ripristinare tutti gli spazi dei nomi tranne quelli nell'elenco.--selected-applications
con un elenco di ProtectedApplications comeNAMESPACE1/APP1,NAMESPACE2/APP2,...
da ripristinare.--selected-namespaces
con un elenco di spazi dei nomiNAMESPACE1,NAMESPACE2,...
da ripristinare.--no-namespaces
non ripristina le risorse con spazio dei nomi nel backup. Questa opzione non può essere specificata insieme a--cluster-resource-scope-no-group-kinds
.
Quando crei un piano di ripristino, devi specificare una di queste opzioni.
CLUSTER_RESOURCE_CONFLICT_POLICY
: definisce come gestire i conflitti in fase di ripristino per le risorse del cluster selezionate. Utilizza una di queste opzioni:use-existing-version
: se le risorse da ripristinare esistono già nel cluster di destinazione, Backup per GKE conserva le risorse esistenti.use-backup-version
: se le risorse da ripristinare esistono già nel cluster di destinazione, Backup per GKE sostituisce le risorse esistenti con le nuove risorse del backup.
--cluster-resource-scope-selected-group-kinds
: (facoltativo) ripristina le risorse cluster con i tipi di gruppi selezionati nel formatoGroup/Kind
.CLUSTER_RESOURCE_SCOPE
definisce GroupKinds delle risorse cluster da ripristinare. Ad esempio,apiextension.k8s.io/CustomResourceDefinition,storage.k8s.io/StorageClass
.In alternativa, specifica:
cluster-resource-scope-all-group-kinds
per selezionare tutti i tipi di gruppi di risorse del cluster da ripristinare.cluster-resource-scope-excluded-group-kinds
con un elenco di tipi di gruppi di risorse cluster per ripristinare tutti i tipi di gruppi di risorse del cluster, ad eccezione di quelli nell'elenco.cluster-resource-scope-no-group-kinds
. Questa opzione non può essere specificata insieme a--no-namespaces
.
Se non specifichi una di queste opzioni, le risorse del cluster non verranno ripristinate.
VOLUME_DATA_RESTORE_POLICY
: definisce il modo in cui i dati vengono compilati per i volumi ripristinati. Utilizza una delle seguenti opzioni:restore-volume-data-from-backup
: i nuovi PV verranno ripristinati utilizzando i dati di backup del volume corrispondenti nel backup.reuse-volume-handle-from-backup
: verrà eseguito il pre-provisioning dei volumi permanenti utilizzando l'handle del volume del volume permanente originale nel backup.no-volume-data-restoration
: i volumi permanenti non verranno ripristinati. Il ripristino ripristina solo le PVC selezionate e prevede che il driver di archiviazione corrispondente esegua dinamicamente il provisioning dei PV vuoti o le leghi a PV di cui è stato eseguito il pre-provisioning creati fuori banda.
Per l'elenco completo delle opzioni, consulta la documentazione di gcloud beta container backup-restore restore-plans create
.
Crea un RecoveryPlan per tutti gli spazi dei nomi
Il seguente comando crea un RecoveryPlan per ripristinare tutti gli spazi dei nomi e le risorse del cluster:
gcloud beta container backup-restore restore-plans create RESTORE_PLAN \
--location=LOCATION \
--backup-plan=BACKUP_PLAN \
--cluster=CLUSTER \
--namespaced-resource-restore-mode=fail-on-conflict \
--all-namespaces \
--cluster-resource-conflict-policy=use-existing-version \
--cluster-resource-scope-all-group-kinds \
--volume-data-restore-policy=restore-volume-data-from-backup
Crea un RecoveryPlan per eseguire il rollback di uno spazio dei nomi
Il comando seguente crea un RecoveryPlan per eseguire il rollback dello spazio dei nomi my-ns
dal backup:
gcloud beta container backup-restore restore-plans create RESTORE_PLAN \
--location=LOCATION \
--backup-plan=BACKUP_PLAN \
--cluster=CLUSTER \
--namespaced-resource-restore-mode=delete-and-restore \
--selected-namespaces=my-ns \
--cluster-resource-conflict-policy=use-existing-version \
--cluster-resource-scope-selected-group-kinds=apiextension.k8s.io/CustomResourceDefinition,storage.k8s.io/StorageClass \
--volume-data-restore-policy=restore-volume-data-from-backup
Crea un RecoveryPlan per eseguire il rollback di un ProtectedApplication
per riconnettere i volumi originali
Il seguente comando crea un RecoveryPlan per eseguire il rollback di ProtectedApplication my-ns/my-app
per riconnettere i volumi originali:
gcloud beta container backup-restore restore-plans create RESTORE_PLAN \
--location=LOCATION \
--backup-plan=BACKUP_PLAN \
--cluster=CLUSTER \
--namespaced-resource-restore-mode=delete-and-restore \
--selected-applications=my-ns/my-app \
--cluster-resource-conflict-policy=use-existing-version \
--cluster-resource-scope-no-group-kinds \
--volume-data-restore-policy=reuse-volume-handle-from-backup
Crea un RecoveryPlan per ripristinare solo le risorse del cluster
Il comando seguente crea un RecoveryPlan per ripristinare tutte le risorse del cluster:
gcloud beta container backup-restore restore-plans create RESTORE_PLAN \
--location=LOCATION \
--backup-plan=BACKUP_PLAN \
--cluster=CLUSTER \
--namespaced-resource-restore-mode=fail-on-conflict \
--no-namespaces \
--cluster-resource-conflict-policy=use-existing-version \
--cluster-resource-scope-all-group-kinds
Console
Segui queste istruzioni per creare un piano di ripristino nella console Google Cloud:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Nel menu di navigazione, fai clic su Backup per GKE.
Fai clic su Crea un piano di ripristino.
Nella sezione Assegna un nome al piano e scegli un cluster, completa quanto segue e fai clic su Avanti:
- Inserisci il nome del piano di ripristino e la descrizione facoltativa.
- Scegli un piano di backup per un cluster esistente corrispondente ai backup che vuoi ripristinare.
- Scegli il cluster di destinazione in cui vuoi ripristinare il backup.
Nella sezione Scegli risorse con spazio dei nomi, completa quanto segue e fai clic su Avanti:
Scegli quali spazi dei nomi ripristinare:
- Fai clic su Tutte le risorse con spazio dei nomi per ripristinare tutte le risorse con spazio dei nomi nel backup.
- Fai clic su Aggiungi spazi dei nomi nella sezione Eccezioni per escludere uno spazio dei nomi nel backup.
- Fai clic su Risorse con spazio dei nomi selezionate per specificare gli spazi dei nomi nel backup da ripristinare.
- Fai clic su Applicazioni protette selezionate per aggiungere risorse specificando lo spazio dei nomi e il nome dell'applicazione.
- Fai clic su Nessuna risorsa con spazio dei nomi per non ripristinare le risorse con spazio dei nomi.
- Fai clic su Tutte le risorse con spazio dei nomi per ripristinare tutte le risorse con spazio dei nomi nel backup.
Scegli come gestire i conflitti se sono selezionate risorse con spazio dei nomi:
- Fai clic su Unisci e salta (non distruttivo) se una risorsa specifica esiste già. Salta il ripristino della risorsa dal backup.
- Fai clic su Unisci e sostituisci volume (distruttivo) se una risorsa specifica esiste già. Salta il ripristino della risorsa, ma sostituisci il volume permanente sottostante utilizzando il criterio di ripristino dei dati del volume. Il volume di unione e sostituzione raggiunge il ripristino dei soli dati.
- Fai clic su Unisci e sostituisci (distruttivo) se una risorsa specifica esiste già. Sostituiscila con una del backup e con i dati di volume associati seguendo il criterio di ripristino dei dati del volume.
- Fai clic su Errore in caso di conflitto (non distruttivo) per interrompere il ripristino se nel cluster di destinazione sono già presenti spazi dei nomi scelti come target per il ripristino da un backup.
- Fai clic su Rollback (distruttivo) per eliminare gli spazi dei nomi esistenti prima di ripristinare i nuovi spazi dei nomi se nel cluster di destinazione esistono già spazi dei nomi scelti come target per il ripristino da un backup.
Scegli come ripristinare i dati del volume e fai clic su Avanti:
- Fai clic su Esegui il provisioning di nuovi volumi e ripristina i dati di volume dal backup per ripristinare i dati di volume dal backup su un nuovo disco permanente.
- Fai clic su Non ripristinare i dati del volume per eseguire il provisioning di un nuovo volume permanente. Se il cluster di destinazione contiene un volume permanente non associato che soddisfa i requisiti di
PersistentVolumeClaim
, il cluster viene associato al volume. - Fai clic su Riutilizza i volumi esistenti contenenti i tuoi dati per non ripristinare i dati di backup del volume. Qualsiasi
PersistentVolumeClaims
è associato a volumi che fanno riferimento a dischi permanenti esistenti.
(Facoltativo) Nella sezione Scegli risorse con ambito cluster, completa quanto segue e fai clic su Avanti:
Scegli i tipi di gruppi da ripristinare:
- Fai clic su Tutte le risorse con ambito cluster per ripristinare tutte le risorse con ambito cluster nel backup.
- Fai clic su Add groupkinds nella sezione Eccezioni per escludere qualsiasi risorsa con ambito cluster nel backup.
- Fai clic su Risorse con ambito cluster selezionate per specificare nel backup le risorse con ambito cluster da ripristinare.
apiextensions.k8s.io/CustomResourceDefinition
estorage.k8s.io/StorageClass
sono selezionati per impostazione predefinita. Fai clic su Aggiungi GroupKind per aggiungere altre risorse con ambito cluster. - Fai clic su Nessuna risorsa con ambito cluster per scegliere di non ripristinare alcuna risorsa del cluster.
- Fai clic su Tutte le risorse con ambito cluster per ripristinare tutte le risorse con ambito cluster nel backup.
Scegli come gestire i conflitti se sono selezionate risorse con ambito cluster:
- Fai clic su Mantieni le risorse nel cluster di destinazione per saltare una risorsa se esiste già nel cluster di destinazione.
Fai clic su Sostituisci le risorse nel cluster di destinazione per eliminare una risorsa, se esiste già nel cluster di destinazione, e ripristina la copia dal backup.
(Facoltativo) Nella sezione Aggiungi regole di trasformazione, completa quanto segue e fai clic su Avanti:
- Fai clic su Aggiungi regola e inserisci una descrizione facoltativa.
- Se vuoi limitare le regole di trasformazione alle risorse che soddisfano condizioni specifiche, segui questi passaggi nella sezione Specificare condizioni e azioni delle risorse:
- Fai clic su Condizione spazi dei nomi e digita un elenco di spazi dei nomi per trovare corrispondenze delle risorse all'interno di quegli spazi dei nomi.
- Fai clic su Condizione di Groupkind e digita il tipo di gruppo API, quindi digita il tipo di oggetto. Associa un gruppo API alle risorse di questi tipi.
- Fai clic su Condizione percorso JSON e digita il percorso JSON che identifica i campi all'interno delle risorse corrispondenti a cui si applica la trasformazione.
- Digita il nuovo valore che sostituisce il valore corrente degli attributi corrispondenti o seleziona la casella di controllo Sostituisci valori specifici (utilizzando un'espressione regolare). Poi digita il pattern da confrontare con il valore attuale delle risorse.
- Fai clic su Salva modifiche.
Esamina i dettagli del piano di ripristino e fai clic su Crea piano.
Visualizza un piano di ripristino
Puoi visualizzare un piano di ripristino e i relativi dettagli utilizzando gcloud CLI o la console Google Cloud.
gcloud
Per elencare tutti i piani di ripristino all'interno del progetto e della località, esegui questo comando:
gcloud beta container backup-restore restore-plans list \
--project=PROJECT_ID \
--location=LOCATION
Solo per i comandi list
, puoi fornire -
come valore per qualsiasi
parametro tranne PROJECT_ID
. Il valore -
funge da carattere jolly. Il valore -
è il valore predefinito per qualsiasi parametro se non
specifica un'opzione della riga di comando o non imposti una proprietà.
Per l'elenco completo delle opzioni, consulta la documentazione di gcloud beta container backup-restore restore-plans list
.
Per visualizzare i dettagli di un piano di ripristino, esegui questo comando:
gcloud beta container backup-restore restore-plans describe RESTORE_PLAN \
--project=PROJECT_ID \
--location=LOCATION
Console
Segui queste istruzioni per visualizzare un piano di ripristino e i relativi dettagli nella console Google Cloud:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Nel menu di navigazione, fai clic su Backup per GKE.
Fai clic sulla scheda Piani di ripristino.
Espandi il piano di backup e fai clic sul nome del piano di ripristino.
Fai clic sulla scheda Dettagli per visualizzare i relativi dettagli.
Aggiorna un piano di ripristino
Aggiorna un piano di ripristino e i relativi dettagli utilizzando gcloud CLI.
gcloud
Per aggiornare un piano di ripristino, ad esempio aggiungendo una nuova descrizione, esegui questo comando:
gcloud beta container backup-restore restore-plans update RESTORE_PLAN \
--project=PROJECT_ID \
--location=LOCATION \
--description=DESCRIPTION
Per l'elenco completo delle opzioni, consulta la documentazione di gcloud beta container backup-restore restore-plans update
.
Console
Segui queste istruzioni per aggiornare un piano di ripristino nella console Google Cloud:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Nel menu di navigazione, fai clic su Backup per GKE.
Fai clic sulla scheda Piani di ripristino.
Fai clic sul nome del piano di ripristino.
Fai clic sulla scheda Dettagli.
Fai clic su edit Modifica per modificare la sezione di un piano, quindi fai clic su Salva modifiche.
Eliminare un piano di ripristino
Puoi eliminare un piano di ripristino utilizzando gcloud CLI o la console Google Cloud. L'eliminazione di un piano di ripristino comporta anche l'eliminazione di eventuali piani di ripristino secondari.
gcloud
Per eliminare un piano di ripristino, esegui questo comando:
gcloud beta container backup-restore restore-plans delete RESTORE_PLAN \
--project=PROJECT_ID \
--location=LOCATION
Per l'elenco completo delle opzioni, consulta la documentazione di gcloud beta container backup-restore restore-plans delete
.
Console
Segui queste istruzioni per eliminare un piano di ripristino nella console Google Cloud:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Nel menu di navigazione, fai clic su Backup per GKE.
Fai clic sulla scheda Piani di ripristino.
Espandi il cluster e fai clic sul nome del piano.
Fai clic su delete Elimina piano.
Digita il nome del piano di ripristino e fai clic su Elimina piano di ripristino nella finestra di dialogo di conferma.
Passaggi successivi
- Scopri di più sul ripristino di un backup.