Esta página se ha traducido con Cloud Translation API.

Restaurar un despliegue de 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.

Nota: Antes de empezar a restaurar una sola región, plantéate si se aplican los siguientes pasos:

Si quiere conservar una configuración para solucionar problemas y analizar las causas raíz, debe eliminar todos los componentes org y env del clúster de Kubernetes excepto el controlador de Apigee y, a continuación, conservar el clúster. El clúster contendrá el almacén de datos de Apigee (Cassandra), que puedes usar para solucionar problemas. Crea un clúster de Kubernetes y restaura Cassandra en él.
Si tu instalación híbrida se configuró con varias organizaciones, obtén los archivos de anulaciones de cada organización antes de continuar con la restauración en una sola región. Puedes añadir la configuración de restauración, tal como se describe en el paso 3, a cualquiera de los archivos de anulaciones. No añadas la configuración de restauración a ningún otro archivo de anulaciones.

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

En tu configuración, la copia de seguridad de Cassandra puede residir en Cloud Storage o en un servidor remoto. En cualquier caso, sigue estos pasos para restaurar el contenido:

Verifica la versión híbrida.
```
apigeectl version
```
Asegúrate de que la versión sea la misma que creó los archivos de copia de seguridad en el almacenamiento.
Nota: Ejecuta todos los comandos apigeectl con la marca --dry-run=true primero para comprobar si hay errores de apigeectl.
Confirma que el clúster de Kubernetes en el que vas a restaurar la copia de seguridad no tenga una instalación anterior de Apigee Hybrid. Si vas a restaurar el clúster, usa el siguiente comando para eliminar la instalación de Apigee hybrid:
```
apigeectl delete --all -f overrides.yaml
```

Abre el archivo overrides.yaml y asigna a las propiedades de restore los valores que quieras:

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 * * *"
  ...

Donde:

Propiedad	Descripción
`namespace`	`YOUR_RESTORE_NAMESPACE` Espacio de nombres de la restauración. Usa el espacio de nombres como en el clúster original.
`restore:enabled`	La restauración está inhabilitada de forma predeterminada. Debe asignar el valor `true` a esta propiedad.
`restore:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` La ruta del archivo de clave privada SSH (llamado `ssh_key` en el paso en el que creaste el par de claves SSH) en tu sistema de archivos local.
`restore:server`	`BACKUP_SERVER_IP` La dirección IP de tu servidor de copia de seguridad.
`restore:storageDirectory`	`BACKUP_DIRECTORY` Nombre del directorio de la copia de seguridad en el servidor de copias de seguridad. Debe ser un directorio de `home/apigee` (el directorio de copia de seguridad se llama `cassandra_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` 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`	La copia de seguridad está inhabilitada de forma predeterminada. Debe asignar el valor `true` a esta propiedad.
`backup:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` La ruta del archivo de clave privada SSH en tu sistema de archivos local (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` Nombre del directorio de la copia de seguridad en el servidor de copias de seguridad. Debe ser un directorio de `home/apigee` (el directorio de copia de seguridad se llama `cassandra_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` Hora en la que se inicia la copia de seguridad, especificada en la sintaxis estándar de crontab. Predeterminado: `0 2 * * ` Nota:* No programes una copia de seguridad que empiece poco después de aplicar la configuración de la copia de seguridad a tu clúster. Cuando apliques la configuración de la copia de seguridad, Kubernetes volverá a crear los nodos de Cassandra. Si la copia de seguridad se inicia antes de que se reinicien los nodos (posiblemente varios minutos), la copia de seguridad fallará.

Nota: Apigee restaura Cassandra a partir de una copia de seguridad de Cloud Storage o de una copia de seguridad de un servidor remoto en función de la configuración de backup en el archivo overrides.yaml.

Crea un nuevo despliegue de tiempo de ejecución híbrido. De esta forma, se creará un clúster de Cassandra y se empezarán a restaurar los datos de la copia de seguridad en el clúster:
```
${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml
```
```
${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
```
Nota: La marca --restore se introdujo en la versión 1.6.6 de Hybrid. Si tienes una versión anterior, ejecuta el siguiente comando sin la marca --restore.
```
${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore
```
```
${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml
```
Verifica el progreso del trabajo de restauración y confirma que apigeeds y todos los demás pods están activos:
- Para comprobar apigeeds, haz lo siguiente:
```
kubectl get apigeeds -n apigee
```
- Para comprobar todos los demás pods, sigue estos pasos:
```
kubectl get pods -n apigee
```

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:

Quita la configuración de restore del archivo overrides-restore.yaml.
Añada la configuración de backup al archivo overrides-restore.yaml.
Aplica la configuración backup con el siguiente comando:
```
./apigeectl apply -f ../overrides-restore.yaml
```