Programa copias de seguridad en Cloud Storage

En esta página, se describe cómo programar copias de seguridad para Cassandra en Cloud Storage. En este método, las copias de seguridad se almacenan en el bucket de Cloud Storage especificado.

Para programar copias de seguridad de Cassandra, sigue estos pasos:

Ejecuta el siguiente comando de create-service-account para crear una cuenta de servicio de Google Cloud con el rol estándar roles/storage.objectAdmin. Este rol de la cuenta de servicio te permite escribir datos de copia de seguridad en Cloud Storage. Ejecuta el siguiente comando en el directorio $APIGEE_HELM_CHARTS_HOME/apigee-operator/etc/:

./tools/create-service-account --env non-prod --dir ./

Con este comando, se crea una sola cuenta de servicio llamada apigee-non-prod para usarla en entornos que no son de producción y se coloca el archivo de claves descargado en el directorio ./.

Nota: Si prefieres crear todas las cuentas de servicio individuales para un entorno de producción, usa el siguiente comando:

./tools/create-service-account --env prod --dir ./

Luego, mueve cada cuenta de servicio a su directorio de gráficos correspondiente. En la siguiente tabla, se enumera cada cuenta de servicio y los gráficos de Helm de Apigee Hybrid correspondientes:

Cuenta de servicio	Gráfico de Helm para Apigee
`apigee-cassandra`	`apigee-datastore`
`apigee-logger`	`apigee-telemetry`
`apigee-mart`	`apigee-org`
`apigee-metrics`	`apigee-telemetry`
`apigee-runtime`	`apigee-env`
`apigee-synchronizer`	`apigee-env`
`apigee-udca`	`apigee-org`
`apigee-watcher`	`apigee-org`

Para obtener más información sobre las cuentas de servicio de Google Cloud, consulta Crea y administra cuentas de servicio.

El comando create-service-account guarda un archivo JSON que contiene la clave privada de la cuenta de servicio. El archivo se guarda en el mismo directorio en el que se ejecuta el comando. Necesitarás la ruta a este archivo en los siguientes pasos.
Crea buckets de almacenamiento. Especifica una política de retención de datos razonable para el bucket. Apigee recomienda una política de retención de datos de 15 días.
Abre el archivo overrides.yaml.

Agrega las siguientes propiedades de cassandra.backup para habilitar la copia de seguridad. No quites ninguna de las propiedades que ya están configuradas.

Parámetros

cassandra:
    ...

    backup:
      enabled: true
      serviceAccountPath: SA_JSON_FILE_PATH
      dbStorageBucket: CLOUD_STORAGE_BUCKET_NAME
      schedule: BACKUP_SCHEDULE_CODE
      cloudProvider: "GCP"  # For remote server backup set this to HYBRID (all caps)

    ...

Ejemplo

  ...

  cassandra:
    storage:
      type: gcepd
      capacity: 50Gi
      gcepd:
        replicationType: regional-pd
    auth:
      default:
        password: "abc123"
      admin:
        password: "abc234"
      ddl:
        password: "abc345"
      dml:
        password: "abc456"
    nodeSelector:
      key: cloud.google.com/gke-nodepool
      value: apigee-data
    backup:
      enabled: true
      serviceAccountPath: "/Users/myhome/.ssh/my-cassandra-backup-sa.json"
      dbStorageBucket: "myname-cassandra-backup"
      schedule: "45 23 * * 6"
      cloudProvider: "GCP"
      


    ...

Propiedad	Descripción
`backup:enabled`	La copia de seguridad está inhabilitada de forma predeterminada. Debes establecer esta propiedad en `true`.
`backup:serviceAccountPath`	`SA_JSON_FILE_PATH` La ruta de tu sistema de archivos al archivo JSON de la cuenta de servicio que se descargó cuando ejecutaste el comando `./tools/create-service-account`. También puedes proporcionar una ruta de archivo relativa. La ruta de acceso será relativa al directorio `hybrid-base-directory/hybrid-files`.
`backup:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_NAME` Es el nombre de un bucket de Google Cloud Storage existente que se usará para almacenar los archivos de copia de seguridad. Consulta Crea buckets si necesitas crear uno. 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.
`backup:cloudProvider`	`GCP/HYBRID` Para una copia de seguridad de Cloud Storage, establece la propiedad en `GCP`. Por ejemplo: `cloudProvider: "GCP"` Para una copia de seguridad del servidor remoto, configura la propiedad como `HYBRID`. Por ejemplo: `cloudProvider: "HYBRID"`
`backup:schedule`	`BACKUP_SCHEDULE_CODE` El momento en el que se inicia la copia de seguridad, especificado en sintaxis de crontab estándar. Predeterminada: `0 2 * * ` Nota:* Evita programar una copia de seguridad que comienza poco tiempo después de que aplicas la configuración de copia de seguridad al clúster. Cuando aplicas la configuración de copia de seguridad, Kubernetes vuelve a crear los nodos de Cassandra. Si la copia de seguridad se inicia antes de que se reinicien los nodos, la primera copia de seguridad fallará y las copias de seguridad posteriores pasarán.

Aplica los cambios de configuración al clúster nuevo. Por ejemplo:
```
helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE.yaml
```
Nota: Si ves un error que dice Error: UPGRADE FAILED: "datastore" has no deployed releases, reemplaza upgrade por install y vuelve a intentar aplicar el comando.

En el que OVERRIDES_FILE es la ruta de acceso al archivo de anulación que acabas de editar.

Verifica el trabajo de copia de seguridad. Por ejemplo:

kubectl get cronjob -n APIGEE_NAMESPACE

  NAME                      SCHEDULE     SUSPEND   ACTIVE   LAST SCHEDULE   AGE
  apigee-cassandra-backup   33 * * * *   False     0        <none>          94s