Ripristino in una singola regione

Version 1.12 

   Versioni supportate:

• v1.13 (più recente)                        
• v1.12                         
• v1.11                         
• Elenco delle versioni supportate

Versioni non supportate:

• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Questa pagina descrive come ripristinare Cassandra in una singola regione.

In un deployment in una singola regione, Apigee Hybrid viene eseguito in un singolo data center o in una regione. Se nel tuo deployment sono presenti più organizzazioni Apigee, il processo di ripristino ripristina i dati per tutte le organizzazioni. In una configurazione con più organizzazioni, non puoi ripristinare un'organizzazione specifica.

Nota: prima di iniziare a ripristinare una singola regione, valuta se sono applicabili i seguenti passaggi preliminari:

• Se vuoi mantenere una configurazione esistente per la risoluzione dei problemi e l'analisi delle cause principali (RCA), devi elimina tutti i componenti org e env dal cluster Kubernetes tranne il controller Apigee, quindi conserva il cluster. Il cluster conterrà il datastore Apigee esistente (Cassandra) che puoi utilizzare per la risoluzione dei problemi. Crea un nuovo cluster Kubernetes e poi ripristina Cassandra nel nuovo cluster.
• Se l'installazione ibrida è stata configurata con più organizzazioni, recupera i file di override per ciascuna organizzazione prima di procedere con il ripristino in una singola regione. Puoi aggiungere la configurazione di ripristino come descritto nel Passaggio 3 a uno qualsiasi dei file di override. Non aggiungere la configurazione di ripristino a nessun altro file di override.

Ripristino di una regione da un backup

1. Aggiorna i dettagli del ripristino di Cassandra nel file overrides.yaml:

   namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
   cassandra:
     hostNetwork: false
   ...
   restore:
     enabled: true
     serviceAccountPath: "SA_JSON_FILE_PATH"
     dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
     cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
     snapshotTimestamp: "TIMESTAMP"
   ...
   backup:
     enabled: false
   ...

   Dove:

   Proprietà	Descrizione
   namespace	YOUR_RESTORE_NAMESPACE Spazio dei nomi per il ripristino. Utilizza lo stesso spazio dei nomi del cluster originale.
   cassandra:hostNetwork	Il campo hostNetwork è obbligatorio e deve essere sempre impostato su false.
   restore:enabled	Il ripristino è disattivato per impostazione predefinita. Devi impostare questa proprietà su true.
   restore:serviceAccountPath	SA_JSON_FILE_PATH Il percorso sul tuo file system all'account di servizio che hai creato per il backup.
   restore:dbStorageBucket	CLOUD_STORAGE_BUCKET_PATH Percorso del bucket Cloud Storage in cui sono archiviati i dati di backup nel seguente formato: gs://BUCKET_NAME. gs:// è obbligatorio.
   restore:cloudProvider	GCP La proprietà cloudProvider: "GCP" è obbligatoria.
   restore:snapshotTimestamp	TIMESTAMP Il timestamp dello snapshot del backup da ripristinare. Per verificare quali timestamp possono essere utilizzati, vai a dbStorageBucket e controlla i file presenti nel bucket. Ogni nome file contiene un valore timestamp. Ad esempio: backup_20210203213003_apigee-cassandra-default-0.tgz Dove 20210203213003 è il valore snapshotTimestamp che vorresti da utilizzare per ripristinare i backup creati in quel momento.
   backup:enabled	Devi impostare questa proprietà su false nel caso in cui sia stata impostata in precedenza su true. Nota: il backup non deve essere attivato durante il ripristino.

   Nota: se utilizzi il backup CSI, segui la configurazione di ripristino di esempio nella documentazione relativa al backup e al ripristino di CSI.

2. Se non disponi di un cluster pulito con cui iniziare, segui le Rimuovere una regione ibrida per Helm documentazione per ripristinare lo stato della tua installazione ibrida esistente (puoi lasciare installato Gestore certificati). In questo modo otterrai lo stesso stato come se avessi seguito il manuale di configurazione del runtime di Helm fino all'inizio del passaggio 11.

3. Verifica che non siano rimasti pod negli spazi dei nomi Apigee:

   kubectl get pods -n apigee
   kubectl get pods -n apigee-system

4. Se utilizzi il backup CSI, assicurati di poter vedere gli snapshot dei volumi che vuoi utilizzare per la procedura di ripristino eseguendo:

   kubectl get volumesnapshot -n apigee
             

5. Installa tutti i componenti di Hybrid uno alla volta come descritto nel passaggio 11 del manuale di installazione. Tieni presente che il pod apigee-cassandra-restore riceverà creato dopo l'esecuzione del comando per installare datastore, ma passa allo stato running dopo l'installazione del componente apigee-org.

   Importante: ometti il flag ‑‑atomic per tutti i comandi upgrade per cluster migrati.

Per ulteriori dettagli sul backup e sul ripristino di Cassandra, consulta la panoramica del backup di Cassandra.

Verifica l'avanzamento del job di ripristino e verifica che apigeeds e tutti gli altri pod siano attivi:

1. Controlla apigeeds:

   kubectl get apigeeds -n apigee

2. Controlla tutti gli altri pod:

   kubectl get pods -n apigee

Al termine del ripristino e dopo aver verificato che i componenti di runtime sono operativi, consigliamo di configurare un backup sul cluster:

1. Rimuovi la configurazione restore dal file overrides-restore.yaml.
2. Aggiungi la configurazione backup al file overrides-restore.yaml.
3. Applica la configurazione backup con il seguente comando:

   helm upgrade datastore apigee-datastore/ \
     --namespace apigee \
     --atomic \
     -f overrides-restore.yaml