En esta página, se describe cómo restablecer Cassandra en una sola región.
En una implementación de una sola región, Apigee Hybrid se implementa en un centro de datos o una región única. Si tienes varias organizaciones de Apigee en tu implementación, el proceso de restablecimiento restablece los datos de todas las organizaciones. En una configuración de varias organizaciones, no puedes restablecer una organización específica.
Restablece una región a partir de una copia de seguridad
En la configuración, la copia de seguridad de Cassandra puede residir en Cloud Storage o en un servidor remoto. En cualquier caso, realiza los siguientes pasos para realizar el restablecimiento:
- Verifica la versión híbrida.
Asegúrate de que la versión sea la misma que creó los archivos de copia de seguridad en el almacenamiento.apigeectl version
- Confirma que el clúster de Kubernetes al que restableces no tenga una instalación de Apigee Hybrid anterior. Si restableces al clúster existente, usa el siguiente comando para borrar la instalación existente de Apigee Hybrid:
apigeectl delete --all -f overrides.yaml
- Abre tu archivo
overrides.yaml
y configura las propiedadesrestore
con los valores deseados:Parámetros
namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster. 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: "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"
Ejemplo
namespace: apigee 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" ... 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 * * *" ...
Aquí:
Propiedad Descripción namespace
YOUR_RESTORE_NAMESPACE
Espacio de nombres para el restablecimiento. Usa el espacio de nombres como en tu clúster original.
restore:enabled
La opción para restablecer está inhabilitada de forma predeterminada. Debes establecer esta propiedad en true
.restore:keyFile
PATH_TO_PRIVATE_KEY_FILE
La ruta de tu sistema de archivos local al archivo de claves privadas SSH (llamado
ssh_key
en el paso en el que creaste el par de claves SSH).restore:server
BACKUP_SERVER_IP
La dirección IP de tu servidor de copia de seguridad.
restore:storageDirectory
BACKUP_DIRECTORY
El nombre del directorio de copia de seguridad de tu servidor de copia de seguridad. Debe ser un directorio dentro de
home/apigee
(el directorio de copia de seguridad se llamacassandra_backup
en el paso en el que creaste el directorio de copia de seguridad).restore:cloudProvider
HYBRID
La propiedad
cloudProvider: "HYBRID"
es obligatoria.restore:snapshotTimestamp
TIMESTAMP
La marca de tiempo de la instantánea de la copia de seguridad que se restablecerá. Para comprobar qué marcas de tiempo se pueden usar, ve a
dbStorageBucket
y consulta los archivos que están presentes en el bucket. Cada nombre de archivo contiene un valor de marca de tiempo. Por ejemplo,backup_20210203213003_apigee-cassandra-default-0.tgz
.En el ejemplo anterior, 20210203213003 es el valor
snapshotTimestamp
que usarías si quisieras restablecer las copias de seguridad creadas en ese momento.backup:enabled
La copia de seguridad está inhabilitada de forma predeterminada. Debes establecer esta propiedad en true
.backup:keyFile
PATH_TO_PRIVATE_KEY_FILE
La ruta de tu sistema de archivos local al archivo de claves privadas SSH (llamado
ssh_key
en el paso en el que creaste el par de claves SSH).backup:server
BACKUP_SERVER_IP
La dirección IP de tu servidor de copia de seguridad.
backup:storageDirectory
BACKUP_DIRECTORY
El nombre del directorio de copia de seguridad de tu servidor de copia de seguridad. Debe ser un directorio dentro de
home/apigee
(el directorio de copia de seguridad se llamacassandra_backup
en el paso en el que creaste el directorio de copia de seguridad).backup:cloudProvider
HYBRID
La propiedad
cloudProvider: "HYBRID"
es obligatoria.backup:schedule
SCHEDULE
El momento en el que se inicia la copia de seguridad, especificado en sintaxis de crontab estándar. Predeterminada:
0 2 * * *
- Crea una nueva implementación de entorno de ejecución híbrido. Esto creará un nuevo clúster de Cassandra y comenzará a restablecer los datos de copia de seguridad en el clúster:
${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 el progreso del trabajo de restablecimiento y confirma que
apigeeds
y todos los demás Pods estén activos:- Para consultar
apigeeds
, haz lo siguiente:kubectl get apigeeds -n apigee
- Para verificar todos los demás Pods, haz lo siguiente:
kubectl get pods -n apigee
- Para consultar
Tras completar con éxito el restablecimiento y la confirmación de que los componentes del entorno de ejecución están en buen estado, recomendamos configurar una copia de seguridad en el clúster:
- Quita la configuración de
restore
del archivooverrides-restore.yaml
. - Agrega la configuración de
backup
al archivooverrides-restore.yaml
. - Aplica la configuración de
backup
mediante el siguiente comando:./apigeectl apply -f ../overrides-restore.yaml