Effectuer une restauration dans une seule région

Cette page explique comment restaurer Cassandra dans une seule région.

Dans un déploiement n'impliquant qu'une seule région, Apigee hybrid est déployé dans un centre de données ou une région. Si votre déploiement comporte plusieurs organisations Apigee, le processus de restauration restaure les données de toutes les organisations. Dans une configuration comportant plusieurs organisations, vous ne pouvez pas restaurer une organisation spécifique.

Remarque : Avant de commencer à restaurer une région unique, déterminez si les étapes préalables suivantes sont applicables :

Si vous souhaitez conserver une configuration existante pour résoudre des problèmes et analyser des causes fondamentales (RCA), supprimez tous les composants org et env du cluster Kubernetes (sauf le contrôleur Apigee), puis conservez le cluster. Le cluster inclut le datastore Apigee existant (Cassandra) qui peut vous permettre de résoudre des problèmes. Créez un cluster Kubernetes, puis restaurez Cassandra dans le nouveau cluster.
Si votre installation hybride a été configurée avec plusieurs organisations, obtenez les fichiers de remplacement de chaque organisation avant de procéder à la restauration dans une seule région. Vous pouvez ajouter la configuration de restauration comme décrit à l'étape 3 à l'un des fichiers de remplacement. N'ajoutez pas la configuration de restauration à un autre fichier de remplacement.

Restaurer une région à partir d'une sauvegarde

Mettez à jour les détails de restauration Cassandra dans le fichier overrides.yaml :

namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_NAME"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: false
  ...

Où :

Propriété	Description
`namespace`	`YOUR_RESTORE_NAMESPACE` Espace de noms à restaurer. Utilisez l'espace de noms de votre cluster d'origine.
`cassandra:hostNetwork`	`hostNetwork` est obligatoire et doit toujours être défini sur `false`.
`restore:enabled`	La restauration est désactivée par défaut. Vous devez définir cette propriété sur `true`.
`restore:serviceAccountPath`	`SA_JSON_FILE_PATH` Le chemin d'accès, sur votre système de fichiers, au compte de service que vous avez créé pour la sauvegarde.
`restore:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_NAME` Nom d'un bucket Google Cloud Storage qui stocke les archives de sauvegarde à utiliser pour la restauration de données. Remarque : À partir de la version 1.13 d'Apigee Hybrid, le nom du bucket n'a pas besoin d'être précédé de `gs://`. La compatibilité avec ce préfixe est obsolète et sera supprimée dans les prochaines versions.
`restore:cloudProvider`	`GCP` La propriété `cloudProvider: "GCP"` est obligatoire.
`restore:snapshotTimestamp`	`TIMESTAMP` Horodatage de l'instantané de sauvegarde à restaurer. Pour vérifier quels horodatages peuvent être utilisés, accédez à `dbStorageBucket` et examinez les fichiers présents dans le bucket. Chaque nom de fichier contient une valeur d'horodatage. Exemple : `backup_20210203213003_apigee-cassandra-default-0.tgz` Où `20210203213003` correspond à la valeur `snapshotTimestamp` que vous utiliseriez si vous souhaitiez restaurer les sauvegardes créées à ce moment-là.
`backup:enabled`	Vous devez définir cette propriété sur `false` si elle a déjà été définie sur `true`. Remarque:La sauvegarde ne doit pas être activée lors de la restauration.

Si vous n'avez pas de cluster propre pour commencer, suivez la documentation Mettre hors service une région hybride pour Helm afin de rétablir l'état propre de votre installation hybride existante (vous pouvez laisser Cert Manager installé). Vous obtenez ainsi un état identique à celui que vous auriez utilisé pour suivre le manuel de configuration de l'environnement d'exécution Helm jusqu'au début de l'étape 11.
Vérifiez qu'il ne reste aucun pod dans les espaces de noms Apigee :
```
kubectl get pods -n APIGEE_NAMESPACE
```
Si vous utilisez la sauvegarde CSI, assurez-vous que vous pouvez afficher les instantanés de volume que vous souhaitez utiliser pour le processus de restauration en exécutant la commande suivante:
```
kubectl get volumesnapshot -n APIGEE_NAMESPACE
          
```
Installez tous les composants hybrides un par un, comme décrit à l'Étape 10 : Installer Apigee hybrid à l'aide de Helm. Notez que le pod apigee-cassandra-restore est créé une fois que vous avez exécuté la commande permettant d'installer datastore, mais il ne passe à l'état running qu'après l'installation du composant apigee-org.

Pour en savoir plus sur la sauvegarde et la restauration Cassandra, consultez la page Présentation de la sauvegarde Cassandra.

Vérifiez la progression du job de restauration et vérifiez que apigeeds et tous les autres pods sont opérationnels :

Vérifiez apigeeds :

kubectl get apigeeds -n APIGEE_NAMESPACE

Vérifiez tous les autres pods :
```
kubectl get pods -n APIGEE_NAMESPACE
```

Une fois la restauration terminée et la confirmation que les composants d'exécution sont opérationnels, nous vous recommandons de configurer une sauvegarde sur le cluster :

Supprimez la configuration restore du fichier overrides-restore.yaml.
Ajoutez la configuration backup au fichier overrides-restore.yaml.

Appliquez la configuration backup à l'aide de la commande suivante :

helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides-restore.yaml