Ripristina un backup

Questa pagina descrive come ripristinare un backup in un cluster in Google Kubernetes Engine (GKE) utilizzando il servizio Backup per GKE.

Questa pagina è rivolta agli amministratori di backup e ripristino di emergenza (RE) che gestiscono ed eseguono backup e recuperi in tutta l'organizzazione. Per scoprire di più sui ruoli comuni e sulle attività di esempio a cui facciamo riferimento nei contenuti di Google Cloud , consulta la pagina Ruoli e attività comuni degli utenti GKE.

Introduzione

Dopo aver creato un backup, gli amministratori possono creare un ripristino per quel backup, che avvia il ripristino di una parte dei contenuti del backup in un cluster di destinazione (che potrebbe essere diverso dal cluster da cui è stato originariamente creato il backup).

Quando viene ripristinato un backup, le risorse Kubernetes vengono ricreate nel cluster di destinazione. Una volta create le risorse, il ripristino effettivo della funzionalità del workload è soggetto al normale processo di riconciliazione del cluster (ad esempio, i pod vengono pianificati sui nodi e poi avviati su questi nodi).

Prima di iniziare

Pianifica una serie di ripristini.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire un ripristino, chiedi all'amministratore di concederti il ruolo IAM Backup per GKE Restore Admin (roles/gkebackup.restoreAdmin), che è un sottoinsieme di Backup per GKE Admin (roles/gkebackup.admin), sul tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un ripristino

Puoi ripristinare un backup utilizzando Google Cloud CLI o la console Google Cloud .

gcloud

Per ripristinare un backup, esegui questo comando:

gcloud beta container backup-restore restores create RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --backup=BACKUP

Sostituisci quanto segue:

  • RESTORE: il nome del ripristino che vuoi creare.
  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION: la regione di computing del piano di ripristino principale.
  • RESTORE_PLAN: il nome del piano di ripristino principale da cui deriva questo ripristino.

  • BACKUP: il backup da ripristinare (deve trovarsi nel piano di backup a cui fa riferimento il piano di ripristino principale):

    • projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUP_PLAN/backups/BACKUP

Per l'elenco completo delle opzioni, consulta la gcloud beta container backup-restore restores create documentazione.

L'operazione di ripristino viene completata dopo che tutte le risorse Kubernetes sono state ripristinate correttamente dal backup. Devi verificare che tutte le applicazioni siano in esecuzione dopo il ripristino.

Console

Segui le istruzioni riportate di seguito per creare un ripristino nella console Google Cloud :

  1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud .

    Vai a Google Kubernetes Engine

  2. Nel menu di navigazione, fai clic su Backup per GKE.

  3. Fai clic sulla scheda Backup.

  4. Nell'elenco dei backup, trova quello che vuoi ripristinare e fai clic su Configura un ripristino.

  5. Scegli un piano di ripristino dall'elenco dei piani applicabili a questo backup.

  6. Inserisci un nome e, facoltativamente, una descrizione per il ripristino.

  7. Fai clic su Ripristina.

L'operazione di ripristino viene completata dopo che tutte le risorse Kubernetes sono state ripristinate correttamente dal backup. Devi verificare che tutte le applicazioni siano in esecuzione dopo il ripristino.

Visualizzare un ripristino

Visualizza un ripristino e i relativi dettagli utilizzando gcloud CLI o la console Google Cloud .

gcloud

Per elencare i ripristini per un piano di ripristino, esegui questo comando:

gcloud beta container backup-restore restores list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN

Solo per i comandi list, puoi fornire - come valore per qualsiasi parametro, ad eccezione di PROJECT_ID. Il valore - funge da carattere jolly. Il valore - è il valore predefinito per qualsiasi parametro se non specifici un'opzione della riga di comando o imposti una proprietà.

Per l'elenco completo delle opzioni, consulta la gcloud beta container backup-restore restores list documentazione.

Per visualizzare i dettagli di un ripristino, esegui questo comando:

gcloud beta container backup-restore restores describe RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN

Per l'elenco completo delle opzioni, consulta la gcloud beta container backup-restore restores describe documentazione.

Console

Segui queste istruzioni per visualizzare un ripristino e i relativi dettagli nella console Google Cloud :

  1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud .

    Vai a Google Kubernetes Engine

  2. Nel menu di navigazione, fai clic su Backup per GKE.

  3. Fai clic sulla scheda Ripristini.

  4. Nell'elenco dei ripristini, fai clic sul nome del ripristino e visualizzane i dettagli.

Visualizzare un ripristino del volume

Un ripristino del volume è un record di un ripristino del volume. Questa risorsa viene creata e gestita automaticamente dall'agente nell'ambito dell'operazione di ripristino.

Visualizza il ripristino di un volume e i relativi dettagli utilizzando gcloud CLI.

gcloud

Per elencare tutti i ripristini del volume per un ripristino, esegui questo comando:

gcloud beta container backup-restore volume-restores list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --restore=RESTORE

Per l'elenco completo delle opzioni, consulta la gcloud beta container backup-restore volume-restores list documentazione.

Per visualizzare i dettagli di un ripristino del volume, esegui questo comando:

gcloud beta container backup-restore volume-restores describe VOLUME_RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --restore=RESTORE

Per l'elenco completo delle opzioni, consulta la gcloud beta container backup-restore volume-restores describe documentazione.

Aggiorna un ripristino

Aggiorna un ripristino utilizzando gcloud CLI o la consoleGoogle Cloud .

gcloud

Per aggiornare un ripristino, ad esempio aggiungendo una nuova descrizione, esegui questo comando:

gcloud beta container backup-restore restores update RESTORE\
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --description=DESCRIPTION

Per l'elenco completo delle opzioni, consulta la gcloud beta container backup-restore restores update documentazione.

Console

Segui queste istruzioni per aggiornare un ripristino nella console Google Cloud :

  1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud .

    Vai a Google Kubernetes Engine

  2. Nel menu di navigazione, fai clic su Backup per GKE.

  3. Fai clic sulla scheda Ripristina.

  4. Nell'elenco dei ripristini, fai clic sul nome del ripristino.

  5. Nel campo Descrizione, fai clic su Modifica. Aggiorna la descrizione, quindi fai clic su Salva modifiche.

Eliminare un ripristino

A differenza dei backup, i ripristini non hanno artefatti associati. Dopo aver ripristinato un backup, puoi eliminarlo senza influire sul cluster di destinazione o sul backup di origine.

Puoi eliminare un ripristino utilizzando gcloud CLI o la consoleGoogle Cloud .

gcloud

Per eliminare un ripristino, esegui questo comando:

gcloud beta container backup-restore restores delete RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN

Per l'elenco completo delle opzioni, consulta la gcloud beta container backup-restore restores delete documentazione.

Console

Segui queste istruzioni per eliminare un ripristino nella console Google Cloud :

  1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud .

    Vai a Google Kubernetes Engine

  2. Nel menu di navigazione, fai clic su Backup per GKE.

  3. Fai clic sulla scheda Ripristini.

  4. Nell'elenco dei ripristini, fai clic sul nome del ripristino.

  5. Fai clic su Elimina.

  6. Digita il nome del piano di ripristino e poi fai clic su Elimina nella finestra di dialogo di conferma.

Considerazioni

Per GKE 1.32.3-gke.1748000 e versioni successive: se un oggetto PersistentVolumeClaim (PVC) utilizza un oggetto StorageClass con la modalità di binding del volume WaitForFirstConsumer e nessun pod fa riferimento al PVC durante un ripristino, PersistentVolume (PV) viene comunque ripristinato e associato al PVC. Questo comportamento si applica anche se nessun pod utilizza il PVC.

Passaggi successivi