Restablece una implementación de 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.

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:

  1. 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.
  2. 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
  3. Abre tu archivo overrides.yaml y configura las propiedades restore 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 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

    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 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

    El momento en el que se inicia la copia de seguridad, especificado en sintaxis de crontab estándar. Predeterminada: 0 2 * * *

  4. 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
  5. 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

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:

  1. Quita la configuración de restore del archivo overrides-restore.yaml.
  2. Agrega la configuración de backup al archivo overrides-restore.yaml.
  3. Aplica la configuración de backup mediante el siguiente comando:
    ./apigeectl apply -f ../overrides-restore.yaml