- v1.12 (più recente)
- Versione 1.11
- Versione 1.10
- Elenco delle versioni supportate
- Versione 1.9
- Versione 1.8
- Versione 1.7
- Versione 1.6
- Versione 1.5
- Versione 1.4
- Versione 1.3
- Versione 1.2
- Versione 1.1
Versioni supportate:
Versioni non supportate:
In questa pagina viene descritto come ripristinare Cassandra in un'unica regione.
In un'unica regione, il deployment di Apigee hybrid viene eseguito in un singolo data center o in un'unica regione. Se nel deployment sono presenti più organizzazioni Apigee, il processo di ripristino ripristina i dati per tutte le organizzazioni. In una configurazione multi-organizzazione, non puoi ripristinare un'organizzazione specifica.
Ripristino di una regione da un backup
Nella tua configurazione, il backup di Cassandra può risiedere su Cloud Storage o su un server remoto. In entrambi i casi, segui questi passaggi per il ripristino:
- Verifica la versione ibrida.
apigeectl version
Assicurati che la versione sia la stessa che ha creato i file di backup nello spazio di archiviazione. - Verifica che il cluster Kubernetes in cui stai eseguendo il ripristino non abbia un'installazione ibrida di Apigee precedente. Se
stai ripristinando il cluster esistente, utilizza il comando seguente per eliminare l'installazione ibrida di Apigee esistente:
apigeectl delete --all -f overrides.yaml
- Apri il file
overrides.yaml
e imposta le proprietàrestore
sui valori desiderati:Parametri
namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster. cassandra: ... 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: ... 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 tuo cluster originale.
restore:enabled
Il ripristino è disabilitato 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 è stata creata 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 è denominatacassandra_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 controlla i file presenti nel bucket. Ogni nome file contiene un valore di timestamp. Ad esempio:backup_20210203213003_apigee-cassandra-default-0.tgz
Dove 20210203213003 è il valore
snapshotTimestamp
da utilizzare 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 è stata creata 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 è denominatacassandra_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 avvio del backup, specificata nella sintassi standard di crontab. Valore predefinito:
0 2 * * *
- Creare un nuovo deployment del runtime ibrido. Verrà creato un nuovo cluster Cassandra e verrà avviato 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
- Verifica l'avanzamento del job di ripristino e verifica 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
- Per controllare
Una volta completato il ripristino e confermato che i componenti di runtime sono integri, ti consigliamo di configurare un backup sul cluster:
- Rimuovi la configurazione
restore
dal fileoverrides-restore.yaml
. - Aggiungi la configurazione
backup
al fileoverrides-restore.yaml
. - Applica la configurazione
backup
con il comando seguente:./apigeectl apply -f ../overrides-restore.yaml