Restaurar en una sola región

En esta página se describe cómo restaurar Cassandra en una sola región.

En una implementación de una sola región, Apigee hybrid se implementa en un único centro de datos o región. Si tienes varias organizaciones de Apigee en tu implementación, el proceso de restauración restaurará los datos de todas las organizaciones. En una configuración de varias organizaciones, no puedes restaurar una organización específica.

Restaurar una región a partir de una copia de seguridad

1. Actualiza los detalles de la restauración de Cassandra en el archivo 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
     ...

   Donde:

   Propiedad	Descripción
   namespace	YOUR_RESTORE_NAMESPACE Espacio de nombres de la restauración. Usa el mismo espacio de nombres que en tu clúster original.
   cassandra:hostNetwork	hostNetwork es obligatorio y siempre debe tener el valor false.
   restore:enabled	La restauración está inhabilitada de forma predeterminada. Debe asignar el valor true a esta propiedad.
   restore:serviceAccountPath	SA_JSON_FILE_PATH La ruta del sistema de archivos a la cuenta de servicio que has creado para la copia de seguridad.
   restore:dbStorageBucket	CLOUD_STORAGE_BUCKET_NAME Nombre de un segmento de Google Cloud Storage que almacena archivos de copia de seguridad que se usarán para restaurar datos.
   restore:cloudProvider	GCP La propiedad cloudProvider: "GCP" es obligatoria.
   restore:snapshotTimestamp	TIMESTAMP Marca de tiempo de la copia de seguridad que se va a restaurar. Para comprobar qué marcas de tiempo se pueden usar, ve a dbStorageBucket y consulta los archivos que hay en el contenedor. Cada nombre de archivo contiene una marca de tiempo. Por ejemplo: backup_20210203213003_apigee-cassandra-default-0.tgz Donde 20210203213003 es el valor de snapshotTimestamp que usarías si quisieras restaurar las copias de seguridad creadas en ese momento.
   backup:enabled	Debe asignar el valor false a esta propiedad si se le había asignado el valor true anteriormente.

2. Si no tienes un clúster limpio para empezar, sigue las instrucciones de la documentación Retirar una región híbrida para Helm para que tu instalación híbrida esté en un estado limpio (puedes dejar instalado Cert Manager). De esta forma, llegarás al mismo punto que si hubieras seguido el manual de configuración del tiempo de ejecución de Helm hasta el principio del paso 11.

3. Comprueba que no queden pods en el espacio de nombres de Apigee:

   kubectl get pods -n APIGEE_NAMESPACE

4. Si utilizas copias de seguridad de CSI, asegúrate de que puedes ver las instantáneas de volumen que quieres usar en el proceso de restauración ejecutando el siguiente comando:

   kubectl get volumesnapshot -n APIGEE_NAMESPACE
             

5. Instala todos los componentes de Hybrid uno a uno tal como se describe en el paso 10: Instala Apigee Hybrid con Helm . Ten en cuenta que el pod apigee-cassandra-restore se creará cuando ejecutes el comando para instalar datastore, pero solo pasará al estado running después de instalar el componente apigee-org.

Consulte la descripción general de la copia de seguridad de Cassandra para obtener más información sobre la copia de seguridad y la restauración de Cassandra.

Verifica el progreso del trabajo de restauración y confirma que apigeeds y todos los demás pods están activos:

1. Comprueba apigeeds:

   kubectl get apigeeds -n APIGEE_NAMESPACE

2. Comprueba todos los demás pods:

   kubectl get pods -n APIGEE_NAMESPACE

Una vez que se haya completado la restauración correctamente y se haya confirmado que los componentes del tiempo de ejecución están en buen estado, te recomendamos que configures una copia de seguridad en el clúster:

1. Quita la configuración de restore del archivo overrides-restore.yaml.
2. Añada la configuración de backup al archivo overrides-restore.yaml.
3. Aplica la configuración backup con el siguiente comando:

   helm upgrade datastore apigee-datastore/ \
     --namespace APIGEE_NAMESPACE \
     --atomic \
     -f overrides-restore.yaml