Cette page explique comment restaurer Cassandra dans Apigee hybrid.
Pourquoi utiliser la restauration ?
Vous pouvez utiliser des backups pour restaurer entièrement l'infrastructure Apigee en cas de défaillances catastrophiques, telles qu'une perte de données irrécupérable dans votre instance hybride Apigee. La restauration extrait vos données de l'emplacement de sauvegarde et les restaure dans un nouveau cluster Cassandra présentant le même nombre de nœuds. Aucune donnée de cluster n'est extraite de l'ancien cluster Cassandra. L'objectif du processus de restauration est de rétablir un état d'origine opérationnel de l'installation d'Apigee hybrid à l'aide des données de sauvegarde d'un instantané.
L'utilisation de sauvegardes pour restaurer n'est pas recommandée dans les scénarios suivants :
- Défaillances de nœuds Cassandra.
- Suppression accidentelle de données telles que
apps
,developers
etapi_credentials
. - Panne d'une ou plusieurs régions dans un déploiement hybride multirégional.
Les déploiements et l'architecture opérationnelle d'Apigee Cassandra prennent en charge la redondance et la tolérance aux pannes d'une seule région. Dans la plupart des cas, la mise en œuvre multirégionale de production recommandée pour l'environnement hybride signifie qu'une défaillance régionale peut être récupérée à partir d'une autre région à l'aide de procédures de mise hors service et d'expansion des régions au lieu d'une restauration à partir d'une sauvegarde.
Avant de commencer la mise en œuvre d'une restauration à partir d'une sauvegarde Cassandra, tenez compte des points suivants :
- Temps d'arrêt : un temps d'arrêt survient pendant toute la durée de la restauration.
- Perte de données : il y a une perte de données entre la dernière sauvegarde valide et la fin de la restauration.
- Heure de restauration : la durée de la restauration dépend de la taille des données et du cluster.
- Sélection de données :vous ne pouvez pas sélectionner uniquement certaines données spécifiques à restaurer. La restauration restaure l'intégralité de la sauvegarde que vous avez sélectionnée.
Restaurations multirégionales
Si vous avez installé Apigee hybrid dans plusieurs régions, vous devez vérifier le fichier de remplacement correspondant à la région que vous restaurez, afin de vous assurer que cassandra:hostNetwork
est défini sur false
avant d'effectuer la restauration. Pour en savoir plus, consultez la page Effectuer une restauration dans plusieurs régions.
Prérequis
Vérifiez que toutes les conditions préalables suivantes sont bien remplies. Analysez tout manquement à ces conditions préalables avant de procéder à la restauration.
- Vérifiez, à l'aide de la commande suivante, que tous les pods Cassandra fonctionnent correctement :
kubectl get pods -n apigee -l app=apigee-cassandra
La sortie doit se présenter sous la forme suivante :
NAME READY STATUS RESTARTS AGE apigee-cassandra-default-0 1/1 Running 0 14m apigee-cassandra-default-1 1/1 Running 0 13m apigee-cassandra-default-2 1/1 Running 0 11m exampleuser@example hybrid-files %
- Vérifiez, à l'aide de la commande suivante, que le StatefulSet Cassandra indique que tous les pods sont en cours d'exécution :
kubectl get sts -n apigee -l app=apigee-cassandra
La sortie doit se présenter sous la forme suivante :
NAME READY AGE apigee-cassandra-default 3/3 15m
- Vérifiez, à l'aide de la commande suivante, que la ressource ApigeeDatastore est à l'état running :
kubectl get apigeeds -n apigee
La sortie doit se présenter sous la forme suivante :
NAME STATE AGE default running 16m
- Vérifiez, à l'aide de la commande suivante, que tous les PVC Cassandra sont à l'état Bound :
kubectl get pvc -n apigee -l app=apigee-cassandra
La sortie doit se présenter sous la forme suivante :
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE cassandra-data-apigee-cassandra-default-0 Bound pvc-a14184e7-8745-4b30-8069-9d50642efe04 10Gi RWO standard-rwo 17m cassandra-data-apigee-cassandra-default-1 Bound pvc-ed129dcb-4706-4bad-a692-ac7c78bad64d 10Gi RWO standard-rwo 15m cassandra-data-apigee-cassandra-default-2 Bound pvc-faed0ad1-9019-4def-adcd-05e7e8bb8279 10Gi RWO standard-rwo 13m
- Vérifiez, à l'aide de la commande suivante, que tous les PV Cassandra sont à l'état Bound :
kubectl get pv -n apigee
La sortie doit se présenter sous la forme suivante :
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE pvc-a14184e7-8745-4b30-8069-9d50642efe04 10Gi RWO Delete Bound apigee/cassandra-data-apigee-cassandra-default-0 standard-rwo 17m pvc-ed129dcb-4706-4bad-a692-ac7c78bad64d 10Gi RWO Delete Bound apigee/cassandra-data-apigee-cassandra-default-1 standard-rwo 16m pvc-faed0ad1-9019-4def-adcd-05e7e8bb8279 10Gi RWO Delete Bound apigee/cassandra-data-apigee-cassandra-default-2 standard-rwo 14m
- Vérifiez, à l'aide de la commande suivante, que la ressource de contrôleur Apigee est à l'état Running :
kubectl get pods -n apigee-system -l app=apigee-controller
La sortie doit se présenter sous la forme suivante :
NAME READY STATUS RESTARTS AGE apigee-controller-manager-856d9bb7cb-cfvd7 2/2 Running 0 20m
Procédure de restauration
Les étapes de restauration de Cassandra diffèrent légèrement selon que votre Apigee hybrid est déployé dans une ou plusieurs régions. Pour obtenir la procédure de restauration détaillée, consultez la documentation suivante :