View a markdown version of this page

Validation, découpage et restauration lors d'une mise à niveau basée sur un clone - Amazon OpenSearch Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Validation, découpage et restauration lors d'une mise à niveau basée sur un clone

Après avoir lancé une mise à niveau basée sur un clone, OpenSearch Le service crée un cluster cloné de votre domaine et y copie vos données. Lorsque le cluster cloné est prêt, la mise à niveau vous attend. Cette page explique comment valider le cluster cloné, y accéder, annuler la mise à niveau et revenir en arrière. Pour plus d'informations sur les demandes qui exécutent chaque action, voir Mise à niveau d'un domaine (CLI) et Mettre à niveau un domaine (SDK).

Surveiller la progression

Pour suivre une mise à niveau basée sur un clone, appelez DescribeDomainChangeProgress. La réponse énumère les étapes suivantes. Les étapes font référence au cluster cloné sous le nom de nouvel environnement et au cluster principal en tant que ancien environnement.

Étape Ce que cela signifie
Initialisation OpenSearch Le service initialise la mise à niveau.
Validation OpenSearch Le service vérifie que votre domaine est éligible à la mise à niveau.
Création d'un nouvel environnement OpenSearch Le service crée le cluster cloné.
Approvisionnement de nouveaux nœuds OpenSearch Le service crée les nœuds du cluster cloné.
Réplication des données OpenSearch Le service réplique vos données vers le cluster cloné.
Validation de l'application client Le cluster cloné est prêt. Après la préparation, testez votre application sur la nouvelle version avant de décider de la supprimer ou non. La mise à niveau vous attend.
Changement de trafic OpenSearch Le service envoie la part du trafic de lecture que vous avez choisie au cluster cloné.
Cut-over vers un nouvel environnement OpenSearch Le service passe au cluster cloné.
Mise à niveau complète OpenSearch Le service termine la mise à niveau.
Suppression des anciennes ressources OpenSearch Le service supprime les ressources associées à l'ancien environnement.

Pendant que le cluster cloné vous attend, ConfigChangeStatus est PendingUserInput. La réponse inclut également TrafficSplit, qui indique la part du trafic de lecture qui va au cluster principal et au cluster cloné.

Validez le cluster cloné

Pendant l'attente de la mise à niveau, votre domaine continue de gérer le trafic provenant du cluster principal. Les écritures vont toujours vers le cluster principal, vous ne pouvez donc valider que les lectures. Utilisez l'une des méthodes suivantes.

Envoyer une part du trafic de lecture au cluster cloné

Utiliser UpdateClone avec TrafficSplitOptions pour envoyer un pourcentage de demandes de lecture, compris entre 0 et 100, au cluster cloné. Le pourcentage s'applique aux demandes de recherche, telles que _search, _msearch, _count, et _mget. Les autres demandes, y compris toutes les écritures, sont envoyées au cluster principal. Vous pouvez modifier le pourcentage aussi souvent que vous le souhaitez. Réglez-le sur 0 pour renvoyer toutes les lectures au cluster principal.

Utiliser OpenSearch Tableaux de bord sur le cluster cloné

Si votre domaine fonctionne OpenSearch, ouvrez le cluster cloné OpenSearch Tableaux de bord sur https://my-domain-endpoint/_dashboards/clone. Pour exécuter les mêmes requêtes sur le cluster principal, utilisez l'URL standard des tableaux de bord, https://my-domain-endpoint/_dashboards.

Le clone L'URL n'est disponible que jusqu'à ce que vous la coupiez. Après le basculement, le cluster cloné remplace le cluster principal et vous utilisez l'URL standard des tableaux de bord.

Comparez CloudWatch indicateurs

Le cluster cloné publie des métriques sur le même CloudWatch namespace comme domaine. Le nom de chaque métrique commence par Clone., par exemple Clone.CPUUtilization. Surveillez ces mesures dans CloudWatch pour comparer les performances de votre charge de travail sur le cluster principal (la version précédente) et le cluster cloné (la version cible) avant de décider de le supprimer. Pour obtenir une liste complète des métriques, consultez Clone-based mesures de mise à niveau.

Passer au cluster cloné

Lorsque vous êtes satisfait du cluster cloné, passez dessus avec UpdateClone et CutoverOptions réglé sur ClonedCluster. OpenSearch Le service effectue ensuite les opérations suivantes :

  1. Vérifie l'état de santé des deux clusters. Si le statut de l'un des clusters est rouge, OpenSearch Le service refuse le transfert.

  2. Bloque les écritures dans le cluster principal afin que le cluster cloné puisse rattraper son retard. Les lectures restent disponibles.

  3. Attend que le cluster cloné rattrape son retard. Si le cluster cloné ne rattrape pas son retard dans les 5 minutes, OpenSearch Le service débloque les écritures et le basculement échoue.

  4. Déplace le trafic vers le cluster cloné. Le point de terminaison de votre domaine ne change pas.

  5. Supprime immédiatement le cluster principal ou le conserve pendant la période de rétention que vous avez définie.

Important

Les écritures sont bloquées jusqu'à la fin du découpage. Interrompez pendant une période de faible trafic d'écriture.

Annuler la mise à niveau avant la mise en service

Vous pouvez annuler à tout moment avant la fin de la période. Appel UpdateClone avec CutoverOptions réglé sur PrimaryCluster. OpenSearch Le service supprime le cluster cloné et votre domaine reste tel quel. Un cluster dont le statut est rouge ne bloque pas une annulation.

Période de conservation

La période de conservation est la durée OpenSearch Le service conserve le cluster principal après le basculement afin que vous puissiez revenir en arrière. Si vous ne définissez pas de période de conservation, OpenSearch Le service supprime le cluster principal immédiatement après le basculement, et le seul moyen de revenir à la version précédente est de restaurer un instantané sur un nouveau domaine.

  • La durée de conservation maximale est de 336 heures (14 jours). Pour demander une période plus longue, contactez AWS soutien.

  • Vous pouvez le configurer lorsque vous démarrez la mise à niveau ou lors d'un appel séparé avant la transition. Le délai commence à courir à compter de la fin de la transition.

  • Après la coupure, vous pouvez raccourcir ou prolonger la période avec RetentionInHours.

  • Pour terminer la période plus tôt, appelez UpdateClone avec RetentionAction. Utiliser RollbackToPrimaryCluster pour revenir au cluster principal et supprimer le cluster cloné. Utiliser DeletePrimaryCluster pour supprimer le cluster principal dès maintenant.

Revenir en arrière

Pendant la période de rétention, vous pouvez revenir au cluster principal. Appel UpdateClone avec RetentionAction réglé sur RollbackToPrimaryCluster. OpenSearch Le service revient au cluster principal et supprime le cluster cloné.

Avertissement

Les données écrites après le découpage seront perdues

Rollback restaure l'ancien environnement conservé. Les données écrites sur le domaine après le découpage ne seront pas présentes à moins que vous ne les relisiez manuellement.

Frais

Pour plus d'informations sur les frais, voir Frais liés aux mises à niveau.

Résolution des problèmes

Problème Description
La création d'un cluster cloné échoue La scène qui a échoué apparaît dans DescribeDomainChangeProgress réponse. Le cluster principal n'est pas affecté.
La copie des données échoue Si la copie vers le cluster cloné est interrompue ou échoue, Replicating data l'étape échoue. Le cluster principal n'est pas affecté.
Le découpage est rejeté Le statut de l'un des clusters est rouge. Corrigez les index rouges et réessayez.
Le cutover échoue après le blocage des écritures Le cluster cloné n'a pas rattrapé son retard en 5 minutes. OpenSearch Le service débloque les écritures automatiquement. Réessayez lorsque le trafic d'écriture est plus faible.