Questa sezione illustra come configurare il backup e il recupero del tuo database Cassandra utilizzando SSH e il tuo file system anziché utilizzare Google Cloud. Vedi anche:
Che cos'è il backup e il recupero di Cassandra senza i servizi Google Cloud?
Il backup senza servizi cloud archivia i backup del database Cassandra in file compressi nel file system di un server specificato. I backup vengono eseguiti in base a una pianificazione specificata nel file delle sostituzioni. La connessione al server avviene tramite SSH sicura.
Configurazione dei backup senza i servizi cloud:
I passaggi seguenti includono esempi comuni per il completamento di attività specifiche, come la creazione di un SSH una coppia di chiavi. Utilizza i metodi appropriati per la tua installazione.
La procedura è composta dalle seguenti parti:
- Configura il server e SSH
- Imposta la pianificazione e la destinazione per il backup
- Preparati per il rinnovo
Configura il server e SSH
- Specifica un server Linux o Unix per i backup. Questo server deve essere raggiungibile tramite SSH da il tuo piano di runtime ibrido Apigee. Deve avere spazio di archiviazione sufficiente per i backup.
- Configura un server SSH sul server o assicurati che sia configurato un server SSH sicuro.
- Creare una coppia di chiavi SSH e archiviare il file della chiave privata in un percorso accessibile dal server
nel piano di runtime. Non utilizzare una password vuota per la coppia di chiavi. Ad esempio:
ssh-keygen -t rsa -b 4096 -C exampleuser@example.com
Enter file in which to save the key (/Users/exampleuser/.ssh/id_rsa): $APIGEE_HOME/hybrid-files/certs/ssh_key Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in ssh_key Your public key has been saved in ssh_key.pub The key fingerprint is: SHA256:DWKo334XMZcZYLOLrd/8HNpjTERPJJ0mc11UYmrPvSA exampleuser@example.com The key's randomart image is: +---[RSA 4096]----+ | +. ++X| | . . o.=.*+| | . o . . o==o | | . . . =oo+o...| | . S +E oo .| | . . .. . o .| | . . . . o.. | | . ...o ++. | | .. .. +o+. | +----[SHA256]-----+ - Crea un account utente sul server di backup con il nome "
apigee
". Assicurati che il nuovo "apigee
" l'utente ha una home directory in/home
. - Sul server di backup, crea un "
ssh
" nella nuova versione di/home/apigee
. - Copia la chiave pubblica (
ssh_key.pub
nell'esempio precedente) in un file denominato "authorized_keys
" nella nuova directory/home/apigee/ssh
. Ad esempio:cd /home/apigee
mkdir .ssh
cd .ssh
vi authorized_keys
- Sul server di backup, crea una directory di backup all'interno della directory
/home/apigee/
. La directory di backup può essere qualsiasi directory, a condizione che l'utente "apigee" abbia accesso. Ad esempio:cd /home/apigee
mkdir cassandra-backup
- Testa la connessione. Devi assicurarti che i pod Cassandra possano connettersi
server di backup tramite SSH:
- Accedi alla shell del pod Cassandra. Ad esempio:
kubectl exec -it -n apigee apigee-cassandra-default-0 -- /bin/bash
Dove apigee-cassandra-default-0 è il nome di un pod cassandra. Cambia in il nome del pod da cui vuoi connetterti.
- Connettiti tramite SSH al server di backup utilizzando l'indirizzo IP del server:
ssh apigee@backup-server-ip
- Accedi alla shell del pod Cassandra. Ad esempio:
Imposta la pianificazione e la destinazione del backup
Imposti la pianificazione e la destinazione dei backup nel file overrides.yaml
.
- Aggiungi i seguenti parametri al file
overrides.yaml
:Parametri
cassandra: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
cassandra: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 backup:enabled
Il backup è disattivato per impostazione predefinita. Devi impostarlo proprietà per true
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-ip L'indirizzo IP del server di backup. backup-directory Il nome della directory di backup sul server di backup. Deve essere una directory all'interno home/apigee
(la directory di backup è denominatacassandra_backup
nel passaggio in cui hai creato la directory di backup).HYBRID
La proprietà cloudProvider: "HYBRID"
è obbligatoria.schedule L'ora di avvio del backup, specificata in sintassi standard di crontab. 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 i nodi Cassandra. Se il backup viene avviato prima del riavvio dei nodi (probabilmente diversi minuti) il backup non andrà a buon fine.
- Utilizza
apigeectl
per applicare la configurazione del backup all'ambito di archiviazione del tuo cluster:$APIGEECTL_HOME/apigeectl --datastore -f your-overrides-file
Dove your-overrides-file è il percorso del file degli override che hai appena modificato.
Configurare il ripristino
Il ripristino recupera i dati dal file di backup con il timestamp specificato e li ripristina in un nuovo cluster Cassandra con lo stesso numero di pod. Il nuovo cluster deve avere uno spazio dei nomi diverso da quello del cluster del piano di runtime.
Per ripristinare i backup di Cassandra:
- Crea un nuovo cluster Kubernetes con un nuovo spazio dei nomi. Non puoi usare lo stesso che hai utilizzato per l'installazione ibrida originale.
- Nella directory di installazione ibrida principale, crea un nuovo file
overrides-restore.yaml
. - Copia la configurazione completa di Cassandra dal file
overrides.yaml
originale in quello nuovo. - Aggiungi i seguenti parametri al file
overrides-restore.yaml
:Parametri
namespace: restore-namespace 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: "backup-to-restore"
Esempio
namespace: cassandra-restore 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"
Dove:
Proprietà Descrizione restore-namespace Il nome del nuovo spazio dei nomi per il nuovo cluster Cassandra. Non utilizzare lo stesso spazio dei nomi utilizzato per il cluster originale. restore:enabled
Il ripristino è disattivato per impostazione predefinita. Devi impostarlo proprietà per true
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-ip L'indirizzo IP del server di backup. backup-directory Il nome della directory di backup sul server di backup. Deve essere una directory all'interno home/apigee
(la directory di backup è denominatacassandra_backup
nel passaggio in cui hai creato la directory di backup).HYBRID
La proprietà cloudProvider: "HYBRID"
è obbligatoria.backup-to-restore Il backup specifico che vuoi ripristinare, specificato in sintassi standard di crontab (non sono consentiti caratteri jolly). - Utilizza
apigeectl
per applicare la configurazione del backup all'ambito di archiviazione del tuo cluster:$APIGEECTL_HOME/apigeectl --datastore -f your-overrides-restore-file
dove your-overrides-restore-file è il percorso del file
overrides-restore.yaml
che hai appena modificato.