Questa pagina descrive come recuperare o ripristinare Cassandra in più regioni.
In un deployment multi-regione, Apigee Hybrid viene implementato in più località geografiche in diversi data center. Se una o più regioni hanno esito negativo, ma rimangono regioni integre, puoi utilizzare una regione integro per recuperarla. regioni di Cassandra non riuscite con i dati più recenti.
In caso di errore catastrofico di tutte le regioni ibride, Cassandra può essere ripristinato. È importante notare che, se nel deployment sono presenti più organizzazioni Apigee, Il processo di ripristino ripristina i dati per tutte le organizzazioni. In una configurazione multi-organizzazione, il ripristino di un'organizzazione specifica non è supportato.
Questo argomento descrive entrambi gli approcci per il salvataggio delle regioni non riuscite:
- Recupero delle regioni non riuscite: descrive i passaggi per recuperare le regioni non riuscite in base a una regione sana.
- Ripristina regioni non riuscite: descrive i passaggi per ripristinare le regioni in errore da un backup. Questo approccio è necessario solo se sono interessate tutte le regioni ibride.
Recupera regioni non riuscite
Per recuperare le regioni non riuscite da una regione funzionante:
- Reindirizza il traffico API dalle regioni interessate alla regione funzionante. Piano la capacità di supportare di conseguenza il traffico deviato dalle regioni in errore.
- Rimuovi la regione interessata. Per ogni regione interessata, segui i passaggi descritti in Rimuovere una regione ibrida. Attendi il completamento del ritiro prima di procedere al passaggio successivo.
- Ripristina la regione interessata. Per eseguire il ripristino, crea una nuova regione, come descritto in Deployment multiregionale su GKE, GKE On-Prem e AKS.
Ripristino da un backup
Il backup di Cassandra può trovarsi su Cloud Storage o su un server remoto in base alla configurazione. Per ripristinare Cassandra da un backup, segui questi passaggi:
- Apri il file degli override per la regione da ripristinare.
- Imposta
cassandra:hostNetwork
sufalse
. - Utilizza
apigeectl
per applicare il file degli override:$APIGEECTL_HOME/apigeectl apply YOUR_OVERRIDES_FILE.yaml
- Prima di continuare, assicurati che
hostNetwork
sia impostato sufalse
:kubectl -n apigee get apigeeds -o=jsonpath='{.items[].spec.components.cassandra.hostNetwork}'
- Elimina l'ibrido dalla regione che stai ripristinando:
apigeectl delete -f overrides.yaml
-
Ripristina la regione che ti interessa da un backup. Per ulteriori informazioni, consulta Ripristinare una regione da un backup.
- Rimuovi i riferimenti alle regioni eliminate e aggiungi i riferimenti alle regioni ripristinate nel
Metadati
KeySpaces
. - Ottieni il nome della regione utilizzando l'opzione
nodetool status
.kubectl exec -n apigee -it apigee-cassandra-default-0 -- bash nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status |grep -i Datacenter
dove:
- APIGEE_JMX_USER è il nome utente dell'utente delle operazioni JMX di Cassandra. Utilizzato
per l'autenticazione e la comunicazione con l'interfaccia JMX di Cassandra. Consulta
cassandra:auth:jmx:username
. - APIGEE_JMX_PASSWORD è la password per l'utente delle operazioni JMX di Cassandra.
Consulta:
cassandra:auth:jmx:password
- APIGEE_JMX_USER è il nome utente dell'utente delle operazioni JMX di Cassandra. Utilizzato
per l'autenticazione e la comunicazione con l'interfaccia JMX di Cassandra. Consulta
- Aggiorna la replica di
KeySpaces
.- Crea un container client e connettiti a Cassandra tramite l'interfaccia CQL.
- Recupera l'elenco degli spazi chiavi utente dall'interfaccia CQL:
cqlsh CASSANDRA_SEED_HOST -u APIGEE_DDL_USER -p APIGEE_DDL_PASSWORD --ssl -e "select keyspace_name from system_schema.keyspaces;"|grep -v system
dove:
- CASSANDRA_SEED_HOST è l'host seed multiregione Cassandra. Per la maggior parte delle installazioni con più regioni, utilizza l'indirizzo IP di un host nella prima regione. Consulta
Configurare Apigee
hybrid per più regioni e
cassandra:externalSeedHost
. - APIGEE_DDL_USER e APIGEE_DDL_PASSWORD sono il nome utente e la password
dell'amministratore per l'utente Cassandra Data Definition Language (DDL). La
I valori predefiniti sono "
ddl_user
" e "iloveapis123
".Consulta
cassandra.auth.ddl.password
nel riferimento per le proprietà di configurazione e Opzioni della riga di comando nella documentazione di cqlsh di Apache Cassandra.
- CASSANDRA_SEED_HOST è l'host seed multiregione Cassandra. Per la maggior parte delle installazioni con più regioni, utilizza l'indirizzo IP di un host nella prima regione. Consulta
Configurare Apigee
hybrid per più regioni e
- Per ogni spazio delle chiavi, esegui questo comando dall'interfaccia CQL per aggiornare le impostazioni di replica:
ALTER KEYSPACE KEYSPACE_NAME WITH replication = {'class': 'NetworkTopologyStrategy', 'REGION_NAME':3};
dove:
- KEYSPACE_NAME è il nome dello spazio chiavi elencato nell'output del passaggio precedente.
- REGION_NAME è il nome della regione ottenuto nel passaggio 4.