Pianificare una serie di ripristini

Questo documento descrive come creare, modificare ed eliminare un piano di ripristino in Google Distributed Cloud (GDC) air-gapped.

I piani di ripristino sono scenari di ripristino preconfigurati per una linea di backup corrispondente. I piani di ripristino possono assegnare autorizzazioni agli utenti con il ruolo Backup Creator per utilizzare queste configurazioni.

I Backup Creator possono ripristinare un backup in modo rapido e indipendente quando si verifica un incidente. Ad esempio, i dati persistenti potrebbero essere danneggiati da un aggiornamento software in un'applicazione di cui è stato eseguito il deployment, mettendo lo spazio dei nomi dell'applicazione in uno stato non valido, che richiede un ripristino.

Durante il ripristino, puoi facoltativamente applicare un insieme di regole di sostituzione che vengono utilizzate per trovare un insieme di risorse e sostituire il valore corrente di un attributo su queste risorse con un nuovo valore. Ad esempio, una regola di sostituzione può modificare lo spazio dei nomi delle risorse di cui è stato eseguito il backup durante il ripristino per eseguire la migrazione di un workload da uno spazio dei nomi a un altro.

Prima di iniziare

Richiedi ruoli IAM

Per creare un piano di ripristino, chiedi all'amministratore dell'organizzazione IAM di concederti il ruolo User Cluster Backup Admin (user-cluster-backup-admin). Questo ruolo crea, recupera, elenca, controlla, aggiorna, applica patch ed elimina risorse di backup come piani di backup e piani di ripristino nei cluster utente.

Se sei un operatore di applicazioni, chiedi a un amministratore con privilegi di amministratore dei backup dei cluster utente di creare un piano di ripristino per te.

Crea un piano di ripristino

Crea un piano di ripristino utilizzando la console GDC o l'API.

Console

  1. Accedi alla console GDC.
  2. Nel menu di navigazione, fai clic su Backup for Clusters.
  3. Fai clic su Crea piano di ripristino.
  4. Nella sezione Elementi di base del piano di ripristino, completa i seguenti passaggi e fai clic su Avanti:
    1. In Nome piano di ripristino, inserisci il nome del piano di ripristino.
    2. (Facoltativo) In Descrizione del piano di ripristino, inserisci una descrizione per il piano di ripristino.
    3. Nell'elenco Cluster di origine, scegli il cluster di origine per il piano di ripristino.
    4. Nell'elenco Progetto, scegli il progetto per il piano di ripristino.
    5. Seleziona il progetto collegato al cluster di origine.
    6. Nel campo Piano di backup, scegli un piano di backup per un cluster esistente che corrisponda ai backup che vuoi ripristinare.
    7. Nel campo Cluster di destinazione, scegli il cluster di destinazione in cui vuoi ripristinare il backup.
  5. Nella sezione Scegli risorse con spazio dei nomi, completa i seguenti passaggi e fai clic su Avanti:
    1. Scegli gli spazi dei nomi da ripristinare:
      1. Fai clic su Risorse con spazio dei nomi selezionate per specificare gli spazi dei nomi nel backup da ripristinare.
        1. Fai clic su Modifica spazi dei nomi del cluster, quindi su Aggiungi spazio dei nomi del cluster per inserire uno spazio dei nomi.
      2. Fai clic su Applicazioni protette selezionate per aggiungere risorse specificando lo spazio dei nomi e il nome dell'applicazione.
    2. Scegli come gestire i conflitti:
      1. Fai clic su Errore in caso di conflitto (non distruttivo) per non eseguire il ripristino se nel cluster di destinazione esistono già spazi dei nomi scelti come target per il ripristino da un backup.
      2. Fai clic su Rollback (distruttivo) per eliminare gli spazi dei nomi esistenti prima di ripristinare i nuovi spazi dei nomi se esistono già spazi dei nomi destinati al ripristino da un backup nel cluster di destinazione.
    3. Scegli come ripristinare i dati del volume:
      1. 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.
      2. Fai clic su Non ripristinare i dati di 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 della PersistentVolumeClaim, il cluster viene associato al volume.
      3. Fai clic su Riutilizza i volumi esistenti contenenti i tuoi dati per non ripristinare i dati di backup del volume. Tutte le PersistentVolumeClaims sono associate a volumi che fanno riferimento a dischi permanenti esistenti.
  6. (Facoltativo) Nella sezione Scegli le risorse con ambito cluster, completa i seguenti passaggi e fai clic su Avanti:
    1. Fai clic su Non ripristinare le risorse con ambito cluster per lasciare invariata la versione esistente della risorsa.
    2. Fai clic su Ripristina le risorse con ambito cluster per GroupKind per ripristinare queste risorse.
      1. Fai clic su Modifica GroupKind per aggiungere altre risorse con ambito cluster. Inserisci il gruppo API e il tipo di oggetto per trovare le risorse corrispondenti all'interno di questi tipi.
    3. Fai clic su Conserva le risorse esistenti per creare risorse se non esistono nel cluster di destinazione.
    4. Fai clic su Sovrascrivi le risorse nel cluster di destinazione per eliminare una risorsa se esiste già nel cluster di destinazione e ripristina la copia dal backup.
  7. (Facoltativo) Nella sezione Aggiungi regole di sostituzione, completa i seguenti passaggi e fai clic su Avanti:
    1. Fai clic su Aggiungi nuova regola.
    2. Nella casella Spazi dei nomi del cluster, digita un elenco di spazi dei nomi per trovare le risorse al loro interno.
    3. Per aggiungere GroupKind, fai clic su Aggiungi GroupKind e inserisci il gruppo API e il tipo di oggetto per trovare le risorse corrispondenti all'interno di questi tipi.
    4. Nel campo Percorso JSON, digita il percorso JSON che identifica i campi all'interno delle risorse corrispondenti a cui si applica la sostituzione.
    5. Nel campo Pattern del valore originale, digita il pattern originale da confrontare con il nuovo valore.
    6. Nel campo Nuovo valore, digita il nuovo valore che sostituisce il valore corrente degli attributi corrispondenti.
    7. Fai clic su Salva.
  8. Fai clic su Crea.

API

Crea una risorsa personalizzata ClusterRestorePlan per pianificare i ripristini da un ClusterBackupPlan esistente. Il ruolo ClusterRestorePlan assegna l'insieme esatto di risorse e spazi dei nomi che un Backup Creator è autorizzato a ripristinare. Ecco un esempio di ClusterRestorePlan:

apiVersion: backup.gdc.goog/v1
kind: ClusterRestorePlan
metadata:
  name: RESTORE_PLAN_NAME
  namespace:  PROJECT_NAME
spec:
  targetCluster:
    targetClusterType: UserCluster
    targetClusterName:
      kind: "Cluster"
      name: CLUSTER_NAME
  description: RESTORE_PLAN_DESCRIPTION
  clusterBackupPlanName: CLUSTER_BACKUP_PLAN_NAME
  clusterRestoreConfig:
    volumeDataRestorePolicy: RestoreVolumeDataFromBackup
    clusterResourceConflictPolicy: UseBackupVersion
    namespacedResourceRestoreMode: DeleteAndRestore
    namespacedResourceRestoreScope:
      selectedNamespaces:
        namespaces: [NAME_SPACE]
    clusterBackupRepositoryRef: CLUSTER_BACKUP_REPOSITORY
    substitutionRules:
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE
      - newValue: NEW_CONFIG_VALUE
        originValuePattern: VALUE_PATTERN
        target:
          groupKinds:
          jsonPath: '{.metadata.name}'
          namespaces:
          - NAME_SPACE

Sostituisci quanto segue:

  • Sostituisci RESTORE_PLAN_NAME con il nome del piano di ripristino.
  • Sostituisci PROJECT_NAME con il nome del tuo progetto GDC.
  • Sostituisci CLUSTER_NAME con il nome del tuo cluster.

Questo esempio utilizza i seguenti valori:


Valore
Attributo
Description
targetClusterName Nome del cluster di origine in un progetto a cui è associato questo piano.
description Una descrizione fornita dall'utente per lo scopo di ClusterRestorePlan.
clusterBackupPlanName Il nome della risorsa ClusterBackupPlan da ripristinare. ClusterBackupPlan deve esistere nello stesso spazio dei nomi di ClusterRestorePlan.
clusterRestoreConfig Configurazione per il processo di ripristino.
volumeDataRestorePolicy Specifica una delle seguenti opzioni:
  • NoVolumeDataRestoration: i PV/PVC non vengono ripristinati.
  • RestoreVolumeDataFromBackup: vengono creati nuovi PV e PVC dal backup.
  • ReuseVolumeHandleFromBackup: crea nuovi PV, ma tenta di ripristinare i PVC utilizzando i PV originali. Destinato al ripristino nello stesso cluster da cui è stato eseguito il backup.
clusterResourceConflictPolicy Specifica il comportamento per la gestione dei conflitti delle risorse del cluster, ad esempio se la risorsa esiste già nel cluster. Specifica uno dei seguenti valori:
  • UseExistingVersion: non sovrascrive le risorse esistenti durante un conflitto
  • UseBackupVersion: elimina e ricrea le risorse del cluster esistenti durante il conflitto. Le risorse con ambito cluster esistenti nel cluster di destinazione verranno sovrascritte dalle versioni del backup. Questa è un'opzione pericolosa che può causare una perdita di dati involontaria se utilizzata in modo inappropriato. Ad esempio, l'eliminazione di una definizione di risorsa personalizzata comporta l'eliminazione di tutte le risorse personalizzate di quel tipo da parte di Kubernetes.
namespacedResourceRestoreMode Gestisce la situazione in cui gli insiemi di risorse con spazio dei nomi in fase di ripristino esistono già nel cluster di destinazione. Specifica una delle seguenti opzioni:
  • DeleteAndRestore: quando vengono rilevate risorse di primo livello in conflitto, come Namespaces o ProtectedApplications, viene attivata l'eliminazione della risorsa in conflitto e di tutte le risorse a cui fa riferimento prima di ripristinare le risorse da Backup. Utilizza questa modalità solo se intendi ripristinare una parte di un cluster a uno stato precedente.
  • FailOnConflict: se all'inizio o durante il processo di ripristino vengono rilevate risorse di primo livello in conflitto, ad esempio la risorsa Namespace o ProtectedApplication, il Restore non va a buon fine.
  • MergeSkipOnConflict: se durante il processo di ripristino vengono rilevate risorse in conflitto, questa modalità ignora il ripristino delle risorse in conflitto dal backup e continua a ripristinare altre risorse che non si trovano nel cluster.
  • MergeReplaceOnConflict: se durante il processo di ripristino vengono rilevate risorse in conflitto, questa modalità sostituisce le risorse in conflitto dal backup e continua a ripristinare altre risorse che non si trovano nel cluster.
namespacedResourceRestoreScope Specifica quali Namespaces o ProtectedApplications sono consentiti per il ripristino.
  • selectedApplications associa le applicazioni protette a questo ripristino.
  • selectedNamespaces contiene NAME_SPACE, che specifica lo spazio dei nomi da ripristinare dal backup.
clusterBackupRepositoryRef Specifica il repository in cui archiviare le risorse Restore. Questo repository può essere diverso da quello da cui proviene il backup. Il repository deve essere un repository ReadWrite nel cluster.
substitutionRules Regole per sostituire i valori nelle risorse Kubernetes di cui è stato eseguito il backup durante il ripristino. Un elenco vuoto indica che non viene eseguita alcuna sostituzione. Le regole di sostituzione vengono applicate in sequenza nell'ordine definito. Questo ordine è importante, poiché le modifiche apportate da una regola potrebbero influire sulla logica di corrispondenza della regola successiva. Ogni regola specifica un target, un originValuePattern da trovare (VALUE_PATTERN) e un newValue (NEW_CONFIG_VALUE) con cui sostituirlo. target può includere namespaces per definire l'ambito della regola (NAME_SPACE).

Dopo la creazione di un ClusterRestorePlan, gli utenti con il ruolo Backup Creator possono ripristinare manualmente i backup.

Visualizza un piano di ripristino

Visualizza un piano di ripristino utilizzando la console GDC:

  1. Accedi alla console GDC.
  2. Nel menu di navigazione, fai clic su Backup for Clusters.
  3. Fai clic su Seleziona progetto per selezionare un'organizzazione o un progetto a seconda del tuo ruolo:
    1. Amministratore backup cluster utente: seleziona un'organizzazione per visualizzare tutti i piani di ripristino in un'organizzazione o seleziona un progetto per visualizzare tutti i piani di ripristino in un progetto.
    2. Backup Creator: seleziona un progetto per visualizzare tutti i piani di ripristino in un progetto.
  4. Fai clic sulla scheda Piani di ripristino.
  5. Fai clic su un piano di ripristino nell'elenco per visualizzarne i dettagli.

Modifica un piano di ripristino

Se il repository di backup associato al piano di ripristino che vuoi modificare ha un valore nel campo Cluster collegato(sola lettura) quando viene creato il piano di ripristino, viene creato due volte. Il piano di ripristino viene propagato sia ai cluster di lettura e scrittura sia a quelli di sola lettura.

Quando modifichi il piano di ripristino di proprietà di un repository di backup con cluster di lettura e scrittura e di sola lettura, devi modificare il piano di ripristino con TARGET CLUSTER impostato sul cluster di lettura e scrittura.

Modifica un piano di ripristino utilizzando la console GDC:

  1. Accedi alla console GDC.
  2. Nel menu di navigazione, fai clic su Backup for Clusters.
  3. Fai clic su Seleziona progetto per selezionare un'organizzazione o un progetto a seconda del tuo ruolo:
    1. Amministratore backup cluster utente: seleziona un'organizzazione per visualizzare tutti i piani di ripristino in un'organizzazione o seleziona un progetto per visualizzare tutti i piani di ripristino in un progetto.
    2. Backup Creator: seleziona un progetto per visualizzare tutti i piani di ripristino in un progetto.
  4. Fai clic sulla scheda Piani di ripristino.
  5. Fai clic sul nome del piano di ripristino da modificare.
  6. Fai clic sulla scheda Configurazione piano per visualizzare i campi che possono essere modificati.

  7. Fai clic sull'icona Modifica accanto a Risorse con spazio dei nomi per modificare la risorsa:

    1. Nella sezione Scegli risorse con spazio dei nomi, seleziona le risorse con spazio dei nomi nel backup che vuoi ripristinare:

      1. Seleziona Risorse con spazio dei nomi selezionate per ripristinare le risorse dagli spazi dei nomi selezionati nel backup:

        1. Seleziona Modifica spazi dei nomi del cluster per selezionare lo spazio dei nomi del cluster.
        2. Nel campo Spazio dei nomi del cluster 1, inserisci il nome dello spazio dei nomi.
        3. Fai clic sul pulsante Salva.

      2. Seleziona Applicazioni protette selezionate per ripristinare le risorse dalle applicazioni protette selezionate nel backup:

        1. Seleziona Modifica applicazioni protette per selezionare lo spazio dei nomi e l'applicazione protetta.
        2. Nel campo Spazio dei nomi 1, inserisci il nome dello spazio dei nomi.
        3. Nel campo Applicazione protetta 1, inserisci il nome dell'applicazione protetta.
        4. Fai clic sul pulsante Salva.

  8. Fai clic sull'icona di modifica accanto a Risorse con ambito cluster per modificare la risorsa:

    1. (Facoltativo) Nella sezione Scegli le risorse con ambito cluster, seleziona le risorse con ambito cluster da ripristinare specificando i gruppi API e GroupKinds e decidi come risolvere i conflitti:

      1. Seleziona Non ripristinare le risorse con ambito cluster per rimuovere le risorse con ambito cluster dal processo di ripristino.

      2. Seleziona Ripristina le risorse con ambito cluster per GroupKind per ripristinare le risorse in base al GroupKind specificato:

      3. Per specificare un GroupKind, fai clic sul pulsante Modifica GroupKind.

      4. Fai clic sul pulsante Aggiungi GroupKind.

      5. Inserisci il nome del GroupKind.

      6. Fai clic sul pulsante Salva.

    2. Nella sezione Gestione dei conflitti, determina l'azione da intraprendere se la risorsa esiste già nel cluster di destinazione:

      1. Seleziona Conserva le risorse esistenti per creare risorse se non esistono già nel cluster.
      2. Seleziona Sovrascrivi le risorse esistenti per eliminare le risorse esistenti trovate e sostituirle con la risorsa ripristinata.

    3. Fai clic sul pulsante Salva per confermare le modifiche.

  9. Nella sezione Regole di sostituzione, fai clic sul pulsante Aggiungi nuova regola per aggiungere una nuova regola di sostituzione:

    1. Nel campo Namespace del cluster, inserisci il nome del namespace del cluster a cui applicare questa regola di sostituzione.
    2. Fai clic sul pulsante Aggiungi GroupKind per applicare questa regola a un determinato oggetto GroupKind.
    3. Nel campo Percorso JSON, inserisci il percorso dell'attributo della risorsa che vuoi sostituire, in formato JSON.
    4. Nel campo Pattern del valore originale, inserisci un'espressione regolare che corrisponda al valore originale dell'attributo.
    5. Nel campo Nuovo valore, inserisci il valore che sostituisce il campo di destinazione. Se questo campo è vuoto, il campo di destinazione viene rimosso dalla risorsa.
    6. Fai clic sul pulsante Salva per completare la creazione della nuova regola di sostituzione.

  10. Nella sezione Regole di sostituzione, fai clic sull'icona di modifica per modificare una regola di sostituzione esistente.

  11. Nella sezione Regole di sostituzione, fai clic sull'icona Elimina per eliminare una regola di sostituzione esistente.

Elimina un piano di ripristino

RestorePlans può essere eliminato tramite la console GDC o eliminando la risorsa direttamente dal server API Kubernetes. In questo modo, tutti gli artefatti RestorePlan associati vengono eliminati dall'archivio di oggetti.

Console

  1. Accedi alla console GDC.
  2. Nel menu di navigazione, fai clic su Backup for Clusters.
  3. Fai clic su Seleziona progetto per selezionare un'organizzazione o un progetto a seconda del tuo ruolo:
    1. Amministratore backup cluster utente: seleziona un'organizzazione per visualizzare tutti i piani di ripristino di un'organizzazione oppure seleziona un progetto per visualizzare tutti i piani di ripristino di un progetto.
    2. Backup Creator: seleziona un progetto per visualizzare tutti i piani di ripristino al suo interno.
  4. Fai clic sulla scheda Piani di ripristino.
  5. Fai clic sul nome del piano di ripristino che vuoi eliminare.
  6. Fai clic sul pulsante Elimina.
  7. Inserisci il nome del piano di ripristino nel campo.
  8. Fai clic sul pulsante Elimina per confermare l'eliminazione del piano di ripristino.

API

Elimina la risorsa del piano di ripristino:

kubectl delete clusterRestoreplan RESTORE_PLAN_NAME -n NAMESPACE

Sostituisci quanto segue:

  • RESTORE_PLAN_NAME: il nome del piano di ripristino.
  • NAMESPACE: lo spazio dei nomi che contiene il piano di ripristino.

Passaggi successivi