- 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 pianificare i backup per Cassandra senza Cloud Storage. Con questo metodo, i backup vengono archiviati su un server remoto specificato da te anziché su un bucket Cloud Storage. Apigee utilizza SSH per comunicare con il server remoto.
Devi pianificare i backup come job cron
. Dopo aver applicato una pianificazione del backup al cluster ibrido, viene eseguito periodicamente un job di backup di Kubernetes in base alla pianificazione nel piano di runtime. Il job attiva uno script di backup su ogni nodo Cassandra nel tuo cluster ibrido che raccoglie tutti i dati sul nodo, crea un file di archivio (compresso) dei dati e invia l'archivio al server specificato nel file overrides.yaml
.
I passaggi seguenti includono esempi comuni per il completamento di attività specifiche, come la creazione di una coppia di chiavi SSH. Utilizza i metodi appropriati per la tua installazione.
La procedura è costituita dai seguenti componenti:
Configura il server e SSH
- Specifica un server Linux o Unix per i backup. Questo server deve essere raggiungibile tramite SSH dal piano di runtime ibrido Apigee. Deve avere spazio di archiviazione sufficiente per i tuoi backup.
- Configura un server SSH sul server o assicurati che sia configurato un server SSH sicuro.
- Crea una coppia di chiavi SSH e archivia il file della chiave privata in un percorso accessibile dal tuo piano di runtime ibrido. È necessario utilizzare una password vuota per la coppia di chiavi, altrimenti il backup non andrà a buon fine. 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]-----+Dove: exampleuser@example.com è una stringa. Qualsiasi stringa che segue
-C
nel comandossh-keygen
diventa un commento incluso nella chiavessh
appena creata. La stringa di input può essere qualsiasi stringa. Quando utilizzi un nome account nel formato exampleuser@example.com, puoi identificare rapidamente quale account viene associato alla chiave. - Crea un account utente con il nome
apigee
sul server di backup. Assicurati che il nuovo utenteapigee
abbia una home directory in/home
. - Sul server di backup, crea una directory
.ssh
nella nuova directory/home/apigee
. - Copia la chiave pubblica (
ssh_key.pub
nell'esempio precedente) in un file denominatoauthorized_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'utenteapigee
vi abbia accesso. Ad esempio:cd /home/apigee
mkdir cassandra-backup
- Prova la connessione. Devi assicurarti che i pod Cassandra possano connettersi al server di backup tramite SSH:
- Accedi al 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 con il nome del pod da cui vuoi connetterti.
- Connettiti tramite SSH al server di backup utilizzando la chiave SSH privata montata sull'indirizzo IP del pod e del server Cassandra:
ssh -i /var/secrets/keys/key apigee@BACKUP_SERVER_IP
- Accedi al shell del pod Cassandra. Ad esempio:
Imposta la pianificazione e la destinazione per il backup
Hai impostato la pianificazione e la destinazione dei backup nel tuo 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 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
GCP/HYBRID
Per un backup di Cloud Storage, imposta la proprietà su
GCP
. Ad esempio,cloudProvider: "GCP"
.Per eseguire il backup di un server remoto, imposta la proprietà su
HYBRID
. Ad esempio,cloudProvider: "HYBRID"
.backup:schedule
SCHEDULE
L'ora di avvio del backup, specificata nella sintassi standard di crontab. Valore predefinito:
0 2 * * *
- Applica la configurazione del backup all'ambito di archiviazione del tuo
cluster:
Helm
helm upgrade datastore apigee-datastore/ \ --namespace apigee \ --atomic \ -f OVERRIDES_FILE.yaml
apigeectl
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --datastore
Dove OVERRIDES_FILE è il percorso del file di override che hai appena modificato.
- Verifica il job di backup. Ad esempio:
kubectl get cronjob -n apigee
NAME SCHEDULE SUSPEND ACTIVE LAST SCHEDULE AGE apigee-cassandra-backup 33 * * * * False 0 <none> 94s