Planifier des sauvegardes dans Cloud Storage

Cette page explique comment planifier des sauvegardes pour Cassandra dans Cloud Storage. Dans cette méthode, les sauvegardes sont stockées dans le bucket Cloud Storage spécifié.

Pour planifier des sauvegardes Cassandra, procédez comme suit :

Exécutez la commande create-service-account suivante pour créer un compte de service Google Cloud avec le rôle standard roles/storage.objectAdmin. Ce rôle de compte de service vous permet d'écrire les données de sauvegarde dans Cloud Storage. Exécutez la commande suivante dans le répertoire hybrid-base-directory/hybrid-files :
```
./tools/create-service-account --env non-prod --dir ./service-accounts
```
Cette commande crée un seul compte de service nommé apigee-non-prod pour l'utiliser dans des environnements hors production et place le fichier de clé téléchargé dans le répertoire ./service-accounts.
Remarque : Si vous préférez créer tous les comptes de service individuels pour un environnement de production, exécutez la commande suivante :
```
./tools/create-service-account --env prod --dir ./service-accounts
```
Pour en savoir plus sur les comptes de service Google Cloud, consultez la page Créer et gérer des comptes de service.
La commande create-service-account enregistre un fichier JSON contenant la clé privée du compte de service. Le fichier est enregistré dans le répertoire où est exécutée la commande. Vous aurez besoin du chemin d'accès à ce fichier lors des étapes suivantes.
Créez un bucket Cloud Storage. Spécifiez une règle de conservation des données raisonnable pour le bucket. Apigee recommande une règle de conservation des données de 15 jours.
Ouvrez votre fichier overrides.yaml.

Ajoutez-y les propriétés cassandra.backup suivantes pour activer la sauvegarde. Ne supprimez aucune des propriétés déjà configurées.

Paramètres

cassandra:
    ...

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

    ...

Exemple

  ...

  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: "gs://myname-cassandra-backup"
      schedule: "45 23 * * 6"
      cloudProvider: "GCP"
      

    ...

Valeur	Description
`backup:enabled`	La sauvegarde est désactivée par défaut. Vous devez définir cette propriété sur `true`.
`backup:serviceAccountPath`	`SA_JSON_FILE_PATH` Chemin d'accès sur votre système de fichiers au fichier JSON du compte de service qui a été téléchargé lors de l'exécution de la commande `./tools/create-service-account`. Vous pouvez également fournir un chemin d'accès relatif au fichier. Le chemin d'accès au répertoire `hybrid-base-directory/hybrid-files` est relatif.
`backup:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_PATH` Chemin du bucket Cloud Storage au format suivant : `gs://BUCKET_NAME`. `gs://` est obligatoire.
`backup:cloudProvider`	`GCP/HYBRID` Pour effectuer une sauvegarde Cloud Storage, définissez la propriété sur `GCP`. Par exemple, `cloudProvider: "GCP"`. Pour effectuer une sauvegarde sur un serveur distant, définissez la propriété sur `HYBRID`. Par exemple, `cloudProvider: "HYBRID"`.
`backup:schedule`	`BACKUP_SCHEDULE_CODE` L'heure de début de la sauvegarde, spécifiée dans la syntaxe crontab standard. Par défaut : `0 2 * * ` Remarque* : Évitez de programmer une sauvegarde qui démarre peu de temps après l'application de la configuration de sauvegarde à votre cluster. Lorsque vous appliquez la configuration de sauvegarde, Kubernetes recrée les nœuds Cassandra. Si la sauvegarde se lance avant le redémarrage des nœuds, la première sauvegarde échoue et les sauvegardes suivantes réussissent.

Appliquez les changements de configuration au nouveau cluster. Exemple :
```
$APIGEECTL_HOME/apigeectl apply --datastore -f YOUR_OVERRIDES_FILE
```
Où YOUR_OVERRIDES_FILE est le chemin d'accès au fichier que vous venez de modifier.

Vérifiez la tâche de sauvegarde. Exemple :

kubectl get cronjob -n apigee

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