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 :

  1. 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 $APIGEE_HELM_CHARTS_HOME/apigee-operator/etc/ :
    ./tools/create-service-account --env non-prod --dir ./

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

    Pour en savoir plus sur les comptes de service Google Cloud, consultez la page Créer et gérer des comptes de service.

  2. 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.
  3. 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.
  4. Ouvrez votre fichier overrides.yaml.
  5. 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_NAME
          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: "myname-cassandra-backup"
          schedule: "45 23 * * 6"
          cloudProvider: "GCP"
          
    
    
        ... 
  6. Où :
    Propriété 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_NAME

    Nom d'un bucket Google Cloud Storage existant qui sera utilisé pour stocker les archives de sauvegarde. Si vous devez en créer un, consultez la page Créer des buckets.

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

  7. Appliquez les changements de configuration au nouveau cluster. Par exemple :
    helm upgrade datastore apigee-datastore/ \
      --namespace APIGEE_NAMESPACE \
      --atomic \
      -f OVERRIDES_FILE.yaml
    

    OVERRIDES_FILE est le chemin d'accès au fichier que vous venez de modifier.

  8. Vérifiez la tâche de sauvegarde. Par exemple :
    kubectl get cronjob -n APIGEE_NAMESPACE
      NAME                      SCHEDULE     SUSPEND   ACTIVE   LAST SCHEDULE   AGE
      apigee-cassandra-backup   33 * * * *   False     0        <none>          94s