Backup e ripristino di un cluster di amministrazione con gkectl

In questa pagina viene descritto come eseguire il backup e il ripristino di un cluster di amministrazione, inclusi i dati, i secret e i certificati etcd, utilizzando il comando gkectl. Puoi anche eseguire il backup e il ripristino di un cluster di amministrazione manualmente.

Esegui il backup di un cluster di amministrazione

Puoi configurare i backup del cluster di amministrazione in modo che vengano eseguiti automaticamente prima e dopo la creazione del cluster, l'aggiornamento e l'upgrade per i cluster utente e di amministrazione. Puoi anche eseguire un backup on demand ogni volta che lo ritieni necessario.

Un backup del cluster di amministrazione include quanto segue:

  • Dati etcd del cluster di amministrazione
  • Secret
  • Certificati
  • Chiavi di crittografia dei secret sempre attive e file di configurazione se la funzionalità di crittografia dei secret sempre attiva è abilitata
  • File kubeconfig del cluster di amministrazione (1.29 e versioni successive)
  • File di chiave SSH del cluster di amministrazione (1.29 e versioni successive)

Le dimensioni di un backup possono variare da 3 MB a 100 MB, a seconda delle dimensioni del cluster.

Abilita la funzionalità di backup del cluster di amministrazione

Per impostazione predefinita, questa funzione è disattivata. Per abilitare la funzionalità di backup del cluster di amministrazione:

  1. Aggiungi la seguente sezione al file di configurazione del cluster di amministrazione:

    clusterBackup:
  datastore: DATASTORE

    Sostituisci DATASTORE con il datastore in cui vuoi archiviare il backup. Il datastore deve trovarsi nello stesso data center del cluster di amministrazione.

    Per i cluster di amministrazione non ad alta disponibilità, i backup si trovano nella directory "anthos-backup/DATADISK_PATH" del datastore specificato.

    Per il cluster di amministrazione ad alta disponibilità, i backup si trovano nella directory "anthos/ADMIN_CLUSTER_NAME/backup" del datastore specificato.

  2. Aggiorna il cluster di amministrazione:

    gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

    Sostituisci:

    • ADMIN_CLUSTER_KUBECONFIG con il percorso del file kubeconfig del cluster di amministrazione.
    • ADMIN_CLUSTER_CONFIG con il percorso del file di configurazione del cluster di amministrazione.

Disabilita la funzionalità di backup del cluster di amministrazione

  1. Rimuovi la sezione clusterBackup dal file di configurazione del cluster di amministrazione.

    clusterBackup:
  datastore: DATASTORE

  2. Aggiorna il cluster di amministrazione con questa modifica utilizzando questo comando:

    gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

Aggiorna il datastore di backup

Puoi aggiornare il datastore in cui sono archiviati i backup aggiornando clusterBackup.datastore in modo che rifletta la nuova località. Il nuovo datastore deve trovarsi nello stesso data center del cluster di amministrazione.

  1. Modifica il file di configurazione del cluster di amministrazione per cambiare il valore clusterBackup.datastore.

    clusterBackup:
  datastore: new-datastore

  2. Aggiorna il cluster di amministrazione con questa modifica utilizzando questo comando:

    gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

Backup on demand

Per attivare un backup on demand del cluster di amministrazione, esegui questo comando:

gkectl  backup admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

Limite al numero di backup

Puoi avere un totale massimo di sei backup, suddivisi in un massimo di tre backup on demand e un massimo di tre backup dalle operazioni di aggiornamento, upgrade o creazione del cluster. Questi backup vengono ruotati automaticamente in caso di superamento di questi limiti. Non è necessario alcun intervento manuale.

Ripristina un cluster di amministrazione

Devi ripristinare un cluster di amministrazione solo se è completamente danneggiato e la perdita di dati è danneggiata. Ad esempio,

  • Il disco dei dati master dell'amministratore è danneggiato o smarrito.
  • L'elemento etcd del cluster di amministrazione è andato perduto o è danneggiato.
  • I secret e i certificati del piano di controllo del cluster di amministrazione vengono persi o danneggiati.

Non utilizzare questo approccio per ripristinare uno stato precedente arbitrario di un cluster di amministrazione funzionante. Questa funzionalità di ripristino non deve essere utilizzata per ripristinare le operazioni del cluster di amministrazione, ad esempio l'aggiornamento o l'upgrade del cluster.

Non utilizzare questo approccio per ripristinare il cluster di amministrazione ad alta disponibilità. Per il cluster di amministrazione ad alta disponibilità supportiamo solo gkectl repair admin-master, ma non gkectl repair admin-master --restore-from-backup.

Per ricreare il cluster di amministrazione da un backup, esegui questo comando:

  gkectl repair admin-master --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG --restore-from-backup

Questo comando recupera tutti i backup di questo cluster di amministrazione dal datastore definito nella sezione clusterBackup del file di configurazione del cluster di amministrazione e ti chiede di selezionare quello da utilizzare per ripristinare il cluster di amministrazione.