Questa pagina è stata tradotta dall'API Cloud Translation.

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 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 quanto segue i passaggi preliminari sono applicabili:

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 ripristina Cassandra nel nuovo cluster.
Se l'installazione ibrida è stata configurata con più organizzazioni, ottieni i file di override per ogni organizzazione prima di procedere con il recupero 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ò trovarsi su Cloud Storage o su un server remoto. In entrambi i casi, segui questi passaggi per eseguire il ripristino:

Verifica la versione ibrida.
```
apigeectl version
```
Assicurati che sia la stessa versione con cui sono stati creati i file di backup nello spazio di archiviazione.
Suggerimento: esegui prima ogni comando apigeectl con il flag --dry-run=true per verificare la presenza di eventuali errori apigeectl.
Verifica che il cluster Kubernetes in cui stai eseguendo il ripristino non abbia un'installazione ibrida precedente di Apigee. Se che stai ripristinando nel cluster esistente, utilizza i seguenti comandi per eliminare la piattaforma Apigee esistente installazione ibrida:
```
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
```

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 all'account di servizio che hai creato per il backup.
`restore:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_PATH` Il percorso del bucket Cloud Storage in cui sono archiviati i dati di backup nel seguente formato: `gs://BUCKET_NAME`. L'attributo `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 puoi usare: vai su `dbStorageBucket` per esaminare i file presenti di sincronizzare la directory di una VM con un bucket. Ogni nome di file contiene un valore timestamp. Ad esempio: `backup_20210203213003_apigee-cassandra-default-0.tgz` dove `20210203213003` è il valore `snapshotTimestamp` che useresti se volessi ripristinare i backup creati in quel momento.
`backup:enabled`	Il backup è disattivato per impostazione predefinita. Devi impostarlo a `true`.
`backup:serviceAccountPath`	`SA_JSON_FILE_PATH` Il percorso sul tuo file system al file JSON dell'account di servizio scaricato durante l'esecuzione `./tools/create-service-account`
`backup:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_PATH` Il percorso del bucket Cloud Storage in questo formato: `gs://BUCKET_NAME`. L'attributo `gs://` è obbligatorio.
`backup:cloudProvider`	`GCP` La proprietà `cloudProvider: "GCP"` è obbligatoria.
`backup:schedule`	`SCHEDULE` L'ora di avvio del backup, specificata in sintassi standard di crontab. Predefinita: `0 2 * * ` Nota:* evita di pianificare un backup che venga avviato poco tempo dopo l'applicazione della configurazione del backup. nel cluster. Quando applichi la configurazione di backup, Kubernetes ricrea Nodi Cassandra. Se il backup viene avviato prima del riavvio dei nodi (probabilmente diversi minuti) il backup non andrà a buon fine.

Non cloud storage

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`	Il campo `hostNetwork` è obbligatorio e deve essere sempre impostato su `false`.
`restore:enabled`	Il ripristino è disattivato per impostazione predefinita. Devi impostarlo a `true`.
`restore:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` Il percorso nel file system locale del file della chiave privata SSH (chiamato `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 `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 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`	Il backup è disattivato per impostazione predefinita. Devi impostarlo a `true`.
`backup:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` Il percorso nel file system locale del file della chiave privata SSH (chiamato `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 `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 in sintassi crontab standard. Valore predefinito: `0 2 * * ` Nota:* evita di pianificare un backup che inizi poco dopo aver applicato la configurazione del backup al cluster. Quando applichi la configurazione di backup, Kubernetes ricrea Nodi Cassandra. Se il backup viene avviato prima del riavvio dei nodi (possibilmente 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 backup nel file overrides.yaml.

Creare un nuovo deployment di runtime ibrido. Verrà creato un nuovo cluster Cassandra e verrà avviata ripristinando i 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 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
```

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

Rimuovi la configurazione restore dal file overrides-restore.yaml.
Aggiungi la configurazione backup al file overrides-restore.yaml.
Applica la configurazione backup con il seguente comando:
```
./apigeectl apply -f ../overrides-restore.yaml
```