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 ripristini in tutta l'organizzazione. Per scoprire di più sui ruoli comuni e sulle attività di esempio a cui facciamo riferimento nei Google Cloud contenuti, consulta 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 creato originariamente 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 carico di lavoro è 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 del ruolo IAM 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 Google Cloud console.

gcloud

Per ripristinare un backup, esegui il comando seguente:

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. Dopo il ripristino, devi verificare che tutte le applicazioni siano in esecuzione.

Console

Utilizza le istruzioni seguenti per creare un ripristino nella Google Cloud console:

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

    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 il backup 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 una descrizione facoltativa 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. Dopo il ripristino, devi verificare che tutte le applicazioni siano in esecuzione.

Visualizza un ripristino

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

gcloud

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

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 tranne PROJECT_ID. Il valore - funge da carattere jolly. Il valore - è il valore predefinito per qualsiasi parametro se non specifichi un'opzione della riga di comando o non 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 il comando seguente:

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

Utilizza le istruzioni seguenti per visualizzare un ripristino e i relativi dettagli nella Google Cloud console:

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

    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.

Visualizza 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 un ripristino del volume e i relativi dettagli utilizzando gcloud CLI.

gcloud

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

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 il comando seguente:

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 Google Cloud console.

gcloud

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

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

Utilizza le istruzioni seguenti per aggiornare un ripristino nella Google Cloud console:

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

    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 e fai clic su Salva modifiche.

Elimina un ripristino

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

Puoi eliminare un ripristino utilizzando gcloud CLI o la Google Cloud console.

gcloud

Per eliminare un ripristino, esegui il comando seguente:

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

Utilizza le istruzioni seguenti per eliminare un ripristino nella Google Cloud console:

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

    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 fai clic su Elimina nella finestra di dialogo di conferma.

Considerazioni

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

Passaggi successivi