Ripristino in una singola regione

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.

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_NAME"
    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

    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_NAME

    Il nome di un bucket Google Cloud Storage che archivia i backup da utilizzare per il ripristino dei dati.
    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 Devi impostare questa proprietà su false nel caso in cui fosse stata impostata in precedenza su true.

  2. Se non hai un cluster pulito con cui iniziare, segui la documentazione Ritira una regione ibrida per Helm per portare l'installazione ibrida esistente in uno stato pulito (puoi lasciare installato Cert Manager). In questo modo, si otterrà uno stato equivalente a quello che si otterrebbe seguendo la guida alla configurazione di Apigee hybrid runtime fino all'inizio del passaggio 12.

  3. Verifica che non siano rimasti pod nello spazio dei nomi Apigee:

    kubectl get pods -n APIGEE_NAMESPACE

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

    kubectl get volumesnapshot -n APIGEE_NAMESPACE

  5. Installa tutti i componenti di Hybrid uno alla volta come descritto in Passaggio 11: installa Apigee hybrid utilizzando Helm . Tieni presente che il pod apigee-cassandra-restore verrà creato dopo l'esecuzione del comando per installare datastore, ma passerà allo stato running solo dopo l'installazione del componente apigee-org.

Per ulteriori dettagli sul backup e sul ripristino di Cassandra, vedi Panoramica del backup di Cassandra.

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

  1. Controlla apigeeds: 
    kubectl get apigeeds -n APIGEE_NAMESPACE
  2. Controlla tutti gli altri pod: 
    kubectl get pods -n APIGEE_NAMESPACE

Una volta completato il ripristino e confermato che i componenti di runtime sono 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: 
    helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides-restore.yaml