Backup e ripristino di un cluster di amministrazione con gkectl

Questa pagina descrive come eseguire il backup e il ripristino di un cluster di amministrazione, inclusi i dati etcd, i secret e i certificati, utilizzando il comando gkectl. Puoi anche eseguire il backup e il ripristino manuale di un cluster di amministrazione.

Esegui il backup di un cluster di amministrazione

Puoi configurare i backup dei 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 di un 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 chiavi 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 funzionalità è 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 datastore di backup

Per aggiornare il datastore in cui sono archiviati i backup, aggiorna clusterBackup.datastore in modo che rifletta la nuova posizione. 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 del cluster di amministrazione on demand, 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 da 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 quando è completamente danneggiato a causa di perdita o danneggiamento dei dati. Ad esempio:

  • Il disco dati master dell'amministratore è stato smarrito o danneggiato.
  • Il valore etcd del cluster di amministrazione è stato smarrito o danneggiato.
  • I secret e i certificati del piano di controllo del cluster di amministrazione sono andati 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 come un modo per ripristinare le operazioni del cluster di amministrazione, come un aggiornamento o un 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. Ti chiede di selezionare il backup da utilizzare per ripristinare il cluster di amministrazione.