Ripristino in una singola regione

Attualmente stai visualizzando la versione 1.7 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per ulteriori informazioni, consulta Versioni supportate.

Version 1.7 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• 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 il deployment in un singolo data center o in una regione. Se nel deployment sono presenti più organizzazioni Apigee, la procedura di ripristino ripristina i dati di tutte le organizzazioni. In una configurazione multi-organizzazione, non puoi ripristinare un'organizzazione specifica.

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

• Se vuoi conservare una configurazione esistente per la risoluzione dei problemi e l'analisi delle cause principali, devi eliminare tutti i componenti org e env dal cluster Kubernetes ad eccezione del controller Apigee, quindi conservare il cluster. Il cluster conterrà l'archivio dati 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 ogni 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

Nella configurazione, il backup di Cassandra può risiedere in Cloud Storage o su un server remoto. In entrambi i casi, segui questi passaggi per il ripristino:

1. Verifica la versione ibrida.

   apigeectl version

   Assicurati che la versione sia la stessa che ha creato i file di backup nello spazio di archiviazione.
   Suggerimento:esegui ogni comando apigeectl con il flag --dry-run=true per verificare la presenza di errori apigeectl.
2. Verifica che il cluster Kubernetes a cui stai eseguendo il ripristino non abbia un'installazione precedente di Apigee Hybrid. Se esegui il ripristino nel cluster esistente, utilizza i seguenti comandi per eliminare l'installazione ibrida di Apigee esistente:

   apigeectl delete -f overrides.yaml
   kubectl -n apigee get apigeedatastore,apigeeredis,apigeetelemetry,org,env,arc # The output should be empty.
   apigeectl delete --all -f overrides.yaml

3. Apri il file overrides.yaml e imposta le proprietà restore sui valori desiderati:

   Cloud Storage

   Parametri

   namespace: YOUR_RESTORE_NAMESPACE # Use the 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: true
       serviceAccountPath: "SA_JSON_FILE_PATH"
       dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
       cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
       schedule: "SCHEDULE"

   Esempio

   namespace: apigee
   cassandra:
     hostNetwork: false
     ...
     restore:
       enabled: true
       serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
       dbStorageBucket: "gs://myname-cassandra-backup"
       cloudProvider: "GCP"
       snapshotTimestamp: "20201001183903"
     ...
     backup:
       enabled: true
       serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
       dbStorageBucket: "gs://myname-cassandra-backup"
       cloudProvider: "GCP"
       schedule: "0 2 * * *"
     ...

   Dove:

   Proprietà	Descrizione
   namespace	YOUR_RESTORE_NAMESPACE Spazio dei nomi per il ripristino. Utilizza lo spazio dei nomi come nel cluster originale.
   cassandra:hostNetwork	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 nel file system dell'account di servizio che hai creato per il backup.
   restore:dbStorageBucket	CLOUD_STORAGE_BUCKET_PATH Il percorso del bucket Cloud Storage in cui sono memorizzati i dati di backup nel seguente formato: gs://BUCKET_NAME. Il campo gs:// è obbligatorio.
   restore:cloudProvider	GCP La proprietà cloudProvider: "GCP" è obbligatoria.
   restore:snapshotTimestamp	TIMESTAMP Il timestamp dello snapshot di backup da ripristinare. Per verificare quali timestamp possono essere utilizzati, vai a dbStorageBucket e guarda 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 utilizzeresti se volessi ripristinare i backup creati in quel momento.
   backup:enabled	Il backup è disattivato per impostazione predefinita. Devi impostare questa proprietà su true.
   backup:serviceAccountPath	SA_JSON_FILE_PATH Il percorso nel file system del file JSON dell'account di servizio che è stato scaricato quando hai eseguito ./tools/create-service-account
   backup:dbStorageBucket	CLOUD_STORAGE_BUCKET_PATH Il percorso del bucket Cloud Storage in questo formato: gs://BUCKET_NAME. Il campo gs:// è obbligatorio.
   backup:cloudProvider	GCP La proprietà cloudProvider: "GCP" è obbligatoria.
   backup:schedule	SCHEDULE L'ora di inizio del backup, specificata nella sintassi standard di crontab. Valore predefinito: 0 2 * * * Nota: evita di pianificare un backup che inizi poco dopo l'applicazione della configurazione di backup al cluster. Quando applichi la configurazione di backup, Kubernetes ricrea i nodi Cassandra. Se il backup inizia prima del riavvio dei nodi (potrebbero essere necessari diversi minuti), il backup non andrà a buon fine.

   Spazio di archiviazione non sul cloud

   Parametri

   namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
   cassandra:
     hostNetwork: false
     ...
     restore:
       enabled: true
       keyFile: "PATH_TO_PRIVATE_KEY_FILE"
       server: "BACKUP_SERVER_IP"
       storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
       cloudProvider: "HYBRID"  # required verbatim "HYBRID" (all caps)
       snapshotTimestamp: "TIMESTAMP"
     ...
     backup:
       enabled: true
       keyFile: "PATH_TO_PRIVATE_KEY_FILE"
       server: "BACKUP_SERVER_IP"
       storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
       cloudProvider: "HYBRID" # required verbatim "HYBRID" (all caps)
       schedule: "SCHEDULE"

   Esempio

   namespace: apigee
   cassandra:
     hostNetwork: false
     ...
     restore:
       enabled: true
       keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
       server: "34.56.78.90"
       storageDirectory: "/home/apigee/cassbackup"
       cloudProvider: "HYBRID"
       snapshotTimestamp: "20201001183903"
     ...
     backup:
       enabled: true
       keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
       server: "34.56.78.90"
       storageDirectory: "/home/apigee/cassbackup"
       cloudProvider: "HYBRID"
       schedule: "0 2 * * *"
     ...

   Dove:

   Proprietà	Descrizione
   namespace	YOUR_RESTORE_NAMESPACE Spazio dei nomi per il ripristino. Utilizza lo spazio dei nomi come nel cluster originale.
   cassandra:hostNetwork	hostNetwork è obbligatorio e deve essere sempre impostato su false.
   restore:enabled	Il ripristino è disattivato per impostazione predefinita. Devi impostare questa proprietà su true.
   restore:keyFile	PATH_TO_PRIVATE_KEY_FILE Il percorso nel file system locale del file della chiave privata SSH (denominato ssh_key nel passaggio in cui hai creato la coppia di chiavi SSH).
   restore:server	BACKUP_SERVER_IP L'indirizzo IP del server di backup.
   restore:storageDirectory	BACKUP_DIRECTORY Il nome della directory di backup sul server di backup. Deve essere una directory all'interno di home/apigee (la directory di backup è denominata cassandra_backup nel passaggio in cui hai creato la directory di backup).
   restore:cloudProvider	HYBRID La proprietà cloudProvider: "HYBRID" è obbligatoria.
   restore:snapshotTimestamp	TIMESTAMP Il timestamp dello snapshot di backup da ripristinare. Per verificare quali timestamp possono essere utilizzati, vai a dbStorageBucket e guarda 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 utilizzeresti se volessi ripristinare i backup creati in quel momento.
   backup:enabled	Il backup è disattivato per impostazione predefinita. Devi impostare questa proprietà su true.
   backup:keyFile	PATH_TO_PRIVATE_KEY_FILE Il percorso nel file system locale del file della chiave privata SSH (denominato ssh_key nel passaggio in cui hai creato la coppia di chiavi SSH).
   backup:server	BACKUP_SERVER_IP L'indirizzo IP del server di backup.
   backup:storageDirectory	BACKUP_DIRECTORY Il nome della directory di backup sul server di backup. Deve essere una directory all'interno di home/apigee (la directory di backup è denominata cassandra_backup nel passaggio in cui hai creato la directory di backup).
   backup:cloudProvider	HYBRID La proprietà cloudProvider: "HYBRID" è obbligatoria.
   backup:schedule	SCHEDULE L'ora di inizio del backup, specificata nella sintassi standard di crontab. Valore predefinito: 0 2 * * * Nota: evita di pianificare un backup che inizi poco dopo l'applicazione della configurazione di backup al cluster. Quando applichi la configurazione di backup, Kubernetes ricrea i nodi Cassandra. Se il backup inizia prima del riavvio dei nodi (potrebbero essere necessari diversi minuti), il backup non andrà a buon fine.

   Nota: Apigee ripristina Cassandra da un backup di Cloud Storage o da un backup del server remoto in base alla configurazione di backup nel file overrides.yaml.
4. Crea un nuovo deployment del runtime ibrido. Verrà creato un nuovo cluster Cassandra e inizierà il ripristino dei dati di backup nel cluster:

   ${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml

   ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml

   ${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore

   ${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml

5. Verifica l'avanzamento del job di ripristino e conferma che apigeeds e tutti gli altri pod siano attivi:
   • Per controllare apigeeds:

     kubectl get apigeeds -n apigee

   • Per controllare tutti gli altri pod:

     kubectl get pods -n apigee

Una volta completato il ripristino e verificato che i componenti di runtime siano integri, ti 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:

   ./apigeectl apply -f ../overrides-restore.yaml