Restablecer en una sola región

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.

Nota: Antes de comenzar a restablecer una sola región, considera si se aplican los siguientes requisitos:

Si deseas conservar una configuración existente para la solución de problemas y el análisis de causa raíz (RCA), debes borrar todos los componentes org y env del clúster de Kubernetes, excepto el controlador de Apigee, y conservar el clúster. El clúster contendrá el almacén de datos existente de Apigee (Cassandra) que puedes usar para solucionar problemas. Posteriormente, crea un clúster de Kubernetes nuevo y, luego, restablece Cassandra en el clúster nuevo.
Si tu instalación híbrida se configuró con varias organizaciones, obtén los archivos de anulación para cada organización antes de continuar con el restablecimiento en una sola región. Puedes agregar la configuración de restablecimiento como se describe en el Paso 3 a cualquiera de los archivos de anulación. No agregues la configuración de restablecimiento a ningún otro archivo de anulación.

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

Actualiza los detalles de restablecimiento 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
...

Aquí:

Propiedad	Descripción
`namespace`	`YOUR_RESTORE_NAMESPACE` Espacio de nombres para el restablecimiento. Usa el mismo espacio de nombres como en tu clúster original.
`cassandra:hostNetwork`	`hostNetwork` es obligatorio y siempre debe establecerse en `false`.
`restore:enabled`	La opción para restablecer está inhabilitada de forma predeterminada. Debes establecer esta propiedad en `true`.
`restore:serviceAccountPath`	`SA_JSON_FILE_PATH` La ruta de acceso del sistema de archivos a la cuenta de servicio que creaste para la copia de seguridad.
`restore:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_NAME` El nombre de un bucket de Google Cloud Storage que almacena archivos de copia de seguridad para usar en el restablecimiento de los datos. Nota: A partir de la versión 1.13 de Hybrid, el nombre del bucket no necesita llevar el prefijo `gs://`. La compatibilidad con este prefijo dejó de estar disponible y se quitará en versiones futuras.
`restore:cloudProvider`	`GCP` La propiedad `cloudProvider: "GCP"` 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`	Debes establecer esta propiedad en `false` en caso de que se haya configurado previamente como `true`. Nota: La copia de seguridad no debe estar habilitada cuando se restablece.

En caso de que no tengas un clúster limpio para comenzar, sigue la documentación Retira una región híbrida para helm a fin de poner tu instalación híbrida existente en un estado limpio ( puedes dejar Cert Manager instalado). Esto te llevaría al mismo estado que si hubieras seguido el manual de configuración del entorno de ejecución de Helm hasta el comienzo del paso 11.
Verifica que no queden Pods en los espacios de nombres de Apigee:
```
kubectl get pods -n APIGEE_NAMESPACE
```
Si usas la copia de seguridad de CSI, asegúrate de que puedas ver las instantáneas de volumen que deseas usar para el proceso de restablecimiento mediante la ejecución:
```
kubectl get volumesnapshot -n APIGEE_NAMESPACE
          
```
Instala todos los componentes de Hybrid uno por uno como se describe en el Paso 10: Instala Apigee Hybrid con Helm. Ten en cuenta que el pod apigee-cassandra-restore se creará una vez que ejecutes el comando para instalar datastore, pero solo entrará en el estado running después de instalar el componente apigee-org.

Consulta Descripción general de la copia de seguridad de Cassandra para obtener más detalles sobre la copia de seguridad y el restablecimiento de Cassandra.

Verifica el progreso del trabajo de restablecimiento y confirma que apigeeds y todos los demás Pods estén activos:

Verifica apigeeds:

kubectl get apigeeds -n APIGEE_NAMESPACE

Verifica todos los demás Pods:
```
kubectl get pods -n APIGEE_NAMESPACE
```

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 archivo overrides-restore.yaml.
Agrega la configuración de backup al archivo overrides-restore.yaml.

Aplica la configuración de backup mediante el siguiente comando:

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