View a markdown version of this page

Mise à niveau d'Amazon OpenSearch Domaines de service - 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.

Mise à niveau d'Amazon OpenSearch Domaines de service

Note

OpenSearch et les mises à niveau des versions d'Elasticsearch sont différentes des mises à jour du logiciel de service. Pour plus d'informations sur la mise à jour du logiciel de service pour votre OpenSearch Domaine de service, voir Mises à jour du logiciel de service dans Amazon OpenSearch Service.

Amazon OpenSearch Le service propose deux méthodes pour mettre à niveau un domaine : une mise à niveau sur place et une mise à niveau basée sur un clone. Si vous utilisez des services tels qu'Amazon Data Firehose ou Amazon CloudWatch Journaux vers lesquels diffuser des données OpenSearch Service, vérifiez que ces services prennent en charge la version la plus récente de OpenSearch avant de migrer.

Méthodes et conditions de mise à niveau

Un mise à niveau sur place met à niveau le cluster existant de votre domaine vers la nouvelle version. Il fonctionne comme blue/green déploiement. Vous ne pouvez pas suspendre, annuler ou annuler une mise à niveau sur place. Il est disponible pour les domaines qui s'exécutent OpenSearch 1.0 ou version ultérieure, ou Elasticsearch 5.1 ou version ultérieure.

UNE mise à niveau basée sur un clone crée un cluster cloné de votre domaine sur la version cible et le synchronise avec vos données pendant que votre domaine continue de gérer le trafic provenant du cluster principal. Il s'agit d'un blue/green déploiement dans lequel le cluster cloné constitue l'environnement vert, isolé afin que vous puissiez le valider avant de le couper. Vous validez le cluster cloné, puis vous y passez lorsque vous êtes prêt. Vous pouvez annuler avant le découpage et revenir en arrière après celui-ci. Une mise à niveau basée sur un clone est disponible pour les domaines qui exécutent Elasticsearch 7.10 ou OpenSearch 1.1 ou version ultérieure en tout AWS Régions commerciales où Amazon OpenSearch Le service est disponible, sauf en Asie-Pacifique (Nouvelle-Zélande), en Asie-Pacifique (Taipei), en Asie-Pacifique (Thaïlande) et au Mexique (Centre). Pour une liste complète des régions, consultez le AWS Tableau des régions.

Les termes suivants décrivent une mise à niveau basée sur un clone.

Cluster principal

Le cluster sur lequel votre domaine s'exécute lorsque la mise à niveau démarre, sur la version précédente. Il continue à gérer le trafic jusqu'à ce que vous coupiez. Après le découpage, OpenSearch Le service ne le conserve que pendant la période de conservation que vous avez définie, afin que vous puissiez revenir en arrière.

Cluster cloné

Le nouveau cluster qui OpenSearch Le service est créé sur la version cible. Il reçoit une copie de vos données et reste synchronisé avec le cluster principal.

Valider

Testez le cluster cloné avec vos propres requêtes de lecture avant de le couper. Vous ne pouvez valider que les lectures.

Basculement

Étape qui déplace le trafic de votre domaine du cluster principal vers le cluster cloné. Les écritures sont bloquées lors du découpage.

Annuler

Arrêtez la mise à niveau avant la mise en service. OpenSearch Le service supprime le cluster cloné et votre domaine reste tel quel.

Revenir en arrière

Revenez au cluster principal après le basculement, pendant la période de rétention.

Période de conservation

Combien de temps OpenSearch Le service conserve le cluster principal après le basculement afin que vous puissiez revenir en arrière. La période commence lorsque le cutover est terminé. Si vous ne définissez pas de période de conservation, OpenSearch Le service supprime le cluster principal immédiatement après le basculement.

Choisissez une méthode de mise à niveau

Le tableau suivant compare les deux types de mise à niveau.

In-place mettre à niveau Clone-based mettre à niveau
Fonctionnement Met à niveau le cluster existant. Il fonctionne comme blue/green déploiement. UNE blue/green déploiement dans lequel le cluster cloné constitue l'environnement vert. Il est créé sur la version cible, synchronisé avec vos données et isolé afin que vous puissiez le valider. C'est vous qui décidez quand vous voulez couper.
Disponible pour OpenSearch 1.0 ou version ultérieure, ou Elasticsearch 5.1 ou version ultérieure. Elasticsearch 7.10 ou OpenSearch 1.1 ou version ultérieure.
Essayez la version améliorée avant qu'elle ne prenne effet Non Les vérifications préalables à la mise à niveau sont exécutées, mais le cluster mis à niveau prend le relais dès que la mise à niveau est terminée. Oui. Essayez le cluster cloné avec vos propres requêtes pendant que votre domaine continue de gérer le trafic.
Annuler une mise à niveau Non. Oui. Vous pouvez annuler à tout moment avant la coupure.
Revenir en arrière Non Pour revenir à la version précédente, restaurez un instantané sur un nouveau domaine. Oui. Après le basculement, vous pouvez revenir en arrière pendant la période de rétention que vous avez définie.
Écrit pendant la mise à niveau Les performances d'écriture peuvent se dégrader pendant la mise à niveau. Les écritures sur le cluster principal ne sont pas affectées pendant l'exécution de la mise à niveau. Les écritures sont bloquées jusqu'à la fin du découpage.

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

Avant la mise à niveau

Avant de commencer l'un ou l'autre type de mise à niveau :

  1. Prenez un instantané manuel de votre domaine. Cet instantané sert de sauvegarde que vous pouvez restauration sur un nouveau domaine si vous souhaitez revenir à l'utilisation de l'ancien OpenSearch version.

  2. Chèque Chemins de mise à niveau pris en charge pour vos versions actuelles et cibles. Une mise à niveau basée sur un clone est disponible uniquement pour les domaines qui exécutent Elasticsearch 7.10 ou OpenSearch 1.1 ou version ultérieure.

  3. Exécutez la vérification préalable à la mise à niveau pour détecter les problèmes susceptibles de bloquer la mise à niveau. Les mêmes vérifications sont effectuées pour les deux types de mise à niveau. Pour plus d’informations, consultez Résolution des problèmes liés aux échecs de validation.

  4. Si vos domaines utilisent la gestion de la reprise après sinistre, mettez d'abord à niveau le domaine secondaire et le domaine principal en dernier. Avant une mise à niveau basée sur un clone, supprimez la relation de réplication. Pour plus d’informations, consultez Mettre à niveau les domaines qui utilisent DR.

Chemins de mise à niveau pris en charge

À l'heure actuelle, OpenSearch Le service prend en charge les chemins de mise à niveau suivants :

Tous les chemins du tableau suivant sont disponibles pour une mise à niveau sur place.

De la version Vers la version
OpenSearch 1,3 et 2.x, ou 3.x

OpenSearch 3.x

Si tu cours OpenSearch 1.3 ou 2.x, vous devez d'abord effectuer la mise à niveau vers OpenSearch 2,19 avant mise à niveau vers OpenSearch 3.x.

Lors de la mise à niveau depuis OpenSearch 2,19 jusqu'à OpenSearch 3.x, vous devrez peut-être corriger les paramètres d'index incompatibles suivants. Ils étaient obsolètes plus tôt dans la version 2.x et entraîneront un échec de validation du contrôle de mise à niveau s'ils ne sont pas supprimés.

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

Pour plus d'informations sur les paramètres d'index obsolètes et les étapes à suivre pour y remédier, consultez Paramètres de l'index. Pour une liste complète des modifications majeures apportées à OpenSearch 3.x, voir 3,0,0.

Si votre domaine contient des index créés dans OpenSearch Versions 1.3, Elasticsearch 7.10 ou antérieures, vous devez les réindexer avant de passer à OpenSearch 3.x. OpenSearch 3.x ne prend pas en charge ces anciens index, qu'ils soient en mode chaud ou non, UltraWarm, ou chambre froide. Pour réindexer : incompatible UltraWarm pour les index froids :

  1. Migrez les index vers le stockage à chaud.

  2. Réindexez les données.

  3. Faites migrer les index vers un stockage à chaud ou à froid.

Vous pouvez également supprimer les index si vous n'en avez plus besoin.

Instantanés pris sur OpenSearch 1.x et sur Elasticsearch 7.10 et les versions antérieures sont incompatibles avec OpenSearch 3.x.

Pour les référentiels de snapshots manuels, supprimez ces snapshots incompatibles avant de passer à OpenSearch 3.x.

OpenSearch 1.3 ou 2.x

OpenSearch 2.x

OpenSearch 2.17 activera la recherche de segments simultanés par défaut avec le mode automatique si le domaine répond aux conditions suivantes :

  • Aucun paramètre de recherche simultané précédent n'est défini explicitement.

  • Toutes les instances de données (chaudes et chaudes) sont du type d'instance .2xl ou supérieur.

  • L'utilisation moyenne du processeur p90 sur les instances de données (chaudes et chaudes) pendant plus d'une semaine est inférieure à 45 %.

    Pour plus de détails sur les paramètres de recherche de segments simultanés ici, voir Recherche de segments simultanés.

La version 2.3 comporte les modifications majeures suivantes :

  • Le type le paramètre a été supprimé de tous OpenSearch Points de terminaison de l'API dans la version 2.0. Pour plus d'informations, veuillez consulter la rubrique Modifications majeures (langue française non garantie).

  • Si votre domaine contient des index (hot, UltraWarm, ou cold) créés à l'origine dans Elasticsearch 6.8, ces index ne sont pas compatibles avec OpenSearch 2.3.

    Avant de passer à la version 2.3, vous devez réindexer les index incompatibles. Pour incompatible UltraWarm ou des index froids, faites-les migrer vers un stockage chaud, réindexez les données, puis refaites-les migrer vers un stockage chaud ou froid. Vous pouvez également supprimer les index si vous n'en avez plus besoin.

    Si vous mettez accidentellement à niveau votre domaine vers la version 2.3 sans effectuer ces étapes au préalable, vous ne pourrez pas migrer les index incompatibles hors de leur niveau de stockage actuel. Votre seule option est de les supprimer.

OpenSearch 1.x OpenSearch 1.x
Elasticsearch 7.x

Elasticsearch 7.x ou OpenSearch 1.x

Important

OpenSearch 1.x introduit de nombreux changements de rupture. Pour plus de détails, consultez Changement de nom d'Amazon OpenSearch Service - Résumé des modifications.

Elasticsearch 6.8

Elasticsearch 7.x ou OpenSearch 1.x

Important

Elasticsearch 7.0 et OpenSearch La version 1.0 inclut de nombreux changements majeurs. Avant de lancer une mise à niveau sur place, nous vous recommandons prise d'un instantané manuel des 6.x domaine, en le restaurant lors d'un test 7.x ou OpenSearch 1.x domaine, et en utilisant ce domaine de test pour identifier les problèmes de mise à niveau potentiels. Pour modifier en profondeur OpenSearch 1.0, voir Changement de nom d'Amazon OpenSearch Service - Résumé des modifications.

Comme Elasticsearch 6.x, les index ne peuvent contenir qu'un seul type de mappage, mais celui-ci doit désormais être nommé _doc. Par conséquent, certaines API n'ont plus besoin d'un type de mappage dans le corps de la demande (comme l'API _bulk).

Pour les nouveaux index, Elasticsearch 7 auto-hébergé.x et OpenSearch 1.x ont un nombre de partitions par défaut de un. OpenSearch Domaines de service sur Elasticsearch 7.x et conservez ensuite la valeur par défaut précédente de cinq.

Elasticsearch 6.x

Elasticsearch 6.x

Elasticsearch 5.6

Elasticsearch 6.x

Important

Les index créés dans la version 6.x ne prennent plus en charge plusieurs types de mappages. Les index créés dans la version 5.x prennent toujours en charge plusieurs types de mappages lors de leur restauration dans un cluster 6.x. Vérifiez que votre code client ne crée qu'un seul type de mappage par index.

Pour minimiser les temps d'arrêt lors de la mise à niveau d'Elasticsearch 5.6 vers la version 6.x, OpenSearch Le service réindexe le .kibana index vers .kibana-6, supprime .kibana, crée un alias nommé .kibana, et fait correspondre le nouvel index au nouvel alias.

Elasticsearch 5.x Elasticsearch 5.x

Une mise à niveau basée sur un clone est disponible pour les chemins de mise à niveau suivants :

  • Elasticsearch 7.10 à OpenSearch 1,3

  • OpenSearch 1,1 et 1,3

  • OpenSearch 1,3 et 2,19

  • OpenSearch 2.x jusqu'à 2,19

  • OpenSearch 2,19 à 3.x

Pour les autres voies de mise à niveau, utilisez une mise à niveau sur place.

Comment fonctionne une mise à niveau sur place

Une mise à niveau sur place comprend trois étapes :

  1. Pre-upgrade chèques — OpenSearch Le service recherche les problèmes susceptibles de bloquer une mise à niveau et ne passe pas à l'étape suivante tant que ces vérifications n'aboutissent pas.

  2. Instantané — OpenSearch Le service prend un instantané de OpenSearch ou un cluster Elasticsearch et ne passe pas à l'étape suivante tant que la capture d'écran n'est pas réussie. Si la mise à niveau échoue, OpenSearch Le service utilise cet instantané pour restaurer l'état d'origine du cluster. Pour plus d’informations, consultez Impossible de revenir à une version plus ancienne après la mise à niveau.

  3. Mettre à niveau — OpenSearch Le service lance la mise à niveau, qui peut prendre de 15 minutes à plusieurs heures. OpenSearch Les tableaux de bord peuvent ne pas être disponibles pendant une partie ou la totalité de la mise à niveau.

Comment fonctionne une mise à niveau basée sur un clone

Une mise à niveau basée sur un clone comprend les étapes suivantes :

  1. Pre-upgrade chèques — OpenSearch Le service exécute les mêmes vérifications que pour une mise à niveau sur place et ne poursuit pas sans succès.

  2. Instantané — OpenSearch Le service prend un instantané de votre domaine et ne démarre que si l'instantané est réussi.

  3. Création de clusters clonés — OpenSearch Le service crée un cluster cloné de votre domaine sur la version cible et y copie vos données. Votre domaine continue de proposer des lectures et des écritures depuis le cluster principal, et le cluster cloné reste synchronisé avec vos données.

  4. Validation — Lorsque le cluster cloné est prêt, la mise à niveau vous attend. Validez le cluster cloné et envoyez-lui éventuellement une part du trafic de lecture.

  5. Découpe — Lorsque vous coupez, OpenSearch Le service bloque les écritures jusqu'à la fin du basculement. Pendant ce temps, le cluster cloné rattrape son retard, puis OpenSearch Le service y transfère le trafic. Le point de terminaison de votre domaine ne change pas.

  6. Période de conservation (facultatif) — OpenSearch Le service conserve le cluster principal pendant la période de rétention que vous avez définie, afin que vous puissiez revenir en arrière. La période commence lorsque le cutover est terminé. Si vous ne définissez pas de période de conservation, OpenSearch Le service supprime le cluster principal immédiatement après le basculement.

Vous pouvez annuler la mise à niveau à tout moment avant la mise en service. OpenSearch Le service supprime ensuite le cluster cloné et votre domaine reste tel quel. Pour plus d'informations sur la validation, le découpage, l'annulation et la restauration, voir Validation, découpage et restauration lors d'une mise à niveau basée sur un clone.

Limites d'une mise à niveau basée sur un clone

Une mise à niveau basée sur un clone présente les limites suivantes :

  • Votre domaine doit exécuter Elasticsearch 7.10 ou OpenSearch 1.1 ou version ultérieure. Si votre domaine utilise une version antérieure, utilisez une mise à niveau sur place pour accéder d'abord à une version prise en charge.

  • Domaines qui utilisent OpenSearch Les instances optimisées (OR1 ou OR2) ne sont pas prises en charge.

  • Domaines qui utilisent UltraWarm les instances ne sont pas prises en charge.

  • Les domaines qui utilisent la réplication entre clusters ne sont pas pris en charge.

  • Si votre domaine utilise la reprise après sinistre gérée, supprimez la relation de réplication avant de commencer une mise à niveau basée sur un clone, puis reconfigurez la reprise après sinistre. Pour plus d’informations, consultez Mettre à niveau les domaines qui utilisent DR.

  • Les domaines auxquels sont associés des packages de plugins personnalisés ou tiers ne sont pas pris en charge.

  • Domaines qui utilisent l'authentification SAML pour OpenSearch Les tableaux de bord ne sont pas pris en charge.

  • Domaines qui utilisent l'authentification Amazon Cognito pour OpenSearch Les tableaux de bord ne sont pas pris en charge.

  • Vous ne pouvez pas modifier la configuration du domaine pendant la mise à niveau.

Frais liés aux mises à niveau

Une mise à niveau sur place n'entraîne pas de frais supplémentaires. Dans le cas d'une mise à niveau basée sur un clone, la tarification standard s'appliquera aux instances et au stockage du clone, comme pour tous les autres nœuds de votre domaine. Le cluster principal et le clone vous sont facturés pendant que vous validez le clone. Si vous conservez le cluster principal à des fins de restauration, les deux frais vous seront facturés jusqu'à la fin de la période de rétention.

Résolution des problèmes liés aux échecs de validation

Lorsque vous lancez un OpenSearch ou mise à niveau de la version d'Elasticsearch, OpenSearch Le service effectue d'abord une série de contrôles de validation pour s'assurer que votre domaine est éligible à une mise à niveau. Si l'un de ces contrôles échoue, vous recevez une notification contenant les problèmes spécifiques que vous devez résoudre avant de mettre à niveau votre domaine. Pour obtenir la liste des problèmes potentiels et les étapes à suivre pour les résoudre, consultez Résolution des erreurs de validation.

Dépannage d'une mise à niveau

Les mises à niveau nécessitent des domaines sains. Votre domaine peut être inéligible pour une mise à niveau ou peut échouer à effectuer une mise à niveau pour une multitude de raisons. Le tableau suivant indique les problèmes les plus courants.

Problème Description
Plugin optionnel non pris en charge

Lorsque vous mettez à niveau un domaine avec des plugins facultatifs, OpenSearch Le service met également automatiquement à jour les plugins. Par conséquent, la version cible de votre domaine doit également prendre en charge ces plugins facultatifs. Si un plug-in optionnel installé sur le domaine n'est pas disponible pour la version cible, la demande de mise à niveau échoue.

Trop de partitions par nœud OpenSearch, ainsi que 7.x versions d'Elasticsearch, ont un paramètre par défaut ne dépassant pas 1 000 partitions par nœud. Si un nœud de votre cluster actuel dépasse ce paramètre, OpenSearch Le service ne vous permet pas de procéder à une mise à niveau. Consultez Limite maximale de partitions dépassée pour les options de dépannage.
Domaine en cours de traitement Un changement de configuration est actuellement en cours pour le domaine. Une fois l'opération terminée, vérifiez l'éligibilité pour la mise à niveau.
Statut de cluster rouge Un ou plusieurs index dans le cluster sont rouges. Pour obtenir les étapes de dépannage, consultez Statut de cluster rouge.
Taux d'erreur élevé Le cluster renvoie un grand nombre d'erreurs 5xx lors de sa tentative de traitement des demandes. Ce problème est généralement dû à un trop grand nombre de demandes simultanées de lecture ou d'écriture. Envisagez de réduire le trafic vers le cluster ou de redimensionner votre domaine.
Split-Brain Split-Brain signifie que votre cluster possède plusieurs nœuds principaux et s'est scindé en deux clusters qui ne refusionneront jamais d'eux-mêmes. Vous pouvez éviter le problème Split-Brain en utilisant le nombre recommandé de nœuds principaux dédiés. Pour obtenir de l'aide afin de résoudre le problème Split-Brain, contactez Support.
Nœud principal introuvable OpenSearch Le service ne trouve pas le nœud principal du cluster. Si votre domaine utilise multi-AZ, il se peut qu'un échec de zones de disponibilité ait entraîné la perte du quorum par le cluster, empêchant ainsi ce dernier de choisir un nouveau nœud principal. Si le problème ne se résout pas automatiquement, contactez Support.
Trop de tâches en attente Le nœud principal est soumis à une charge importante et a de nombreuses tâches en attente. Envisagez de réduire le trafic vers le cluster ou de redimensionner votre domaine.
Volume de stockage défaillant Le volume de disque d'un ou plusieurs nœuds ne fonctionne pas correctement. Ce problème se produit souvent parallèlement à d'autres problèmes, comme un taux d'erreur élevé ou un trop grand nombre de tâches en attente. Si ce problème est isolé et ne se résout pas automatiquement, contactez Support.
Problème lié à la clé KMS La clé KMS utilisée pour chiffrer le domaine est inaccessible ou manquante. Pour plus d'informations, consultez Surveillance des domaines qui chiffrent les données au repos.
Instantané en cours Le domaine prend actuellement un instantané. Une fois l'instantané pris, vérifiez l'éligibilité pour la mise à niveau. Vérifiez également que vous pouvez lister les référentiels d'instantanés manuels, lister les instantanés dans ces référentiels et prendre des instantanés manuels. Si OpenSearch Le service n'est pas en mesure de vérifier si un snapshot est en cours, les mises à niveau peuvent échouer.
Délai d'expiration ou échec de l'instantané La création de l'instantané avant la mise à niveau a été trop longue ou a échoué. Vérifiez l'état du cluster et réessayez. Si le problème persiste, contactez Support.
Index incompatibles Une ou plusieurs index sont incompatibles avec la version cible. Ce problème peut survenir si vous avez migré les index à partir d'une ancienne version de OpenSearch ou Elasticsearch. Réindexez les index et réessayez.
Utilisation du disque élevée L'utilisation du disque pour le cluster est supérieure à 90 %. Supprimez des données ou redimensionnez le domaine, puis réessayez.
Utilisation JVM élevée La sollicitation de mémoire JVM est supérieure à 75 %. Réduisez le trafic vers le cluster ou redimensionnez le domaine, puis réessayez.
OpenSearch Problème d'alias dans les tableaux de bord .dashboards est déjà configuré en tant qu'alias et correspond à un index incompatible, probablement un index provenant d'une version antérieure de OpenSearch Tableaux de bord. Réindexez et réessayez.
Statut de Dashboards rouge OpenSearch L'état des tableaux de bord est rouge. Essayez d'utiliser Dashboards une fois la mise à niveau terminée. Si le statut rouge persiste, résolvez-le manuellement, puis réessayez.
Cross-cluster compatibilité

Vous pouvez uniquement effectuer la mise à niveau si, après cette dernière, la compatibilité inter-clusters est maintenue entre les domaines source et destination. Au cours du processus de mise à niveau, toutes les connexions incompatibles sont identifiées. Ensuite, mettez à niveau le domaine distant ou supprimez les connexions incompatibles. Notez que si la réplication est active sur le domaine, vous ne pouvez pas la reprendre une fois la connexion supprimée.

Autres OpenSearch Problème de service Problèmes avec OpenSearch Le service lui-même peut entraîner l'affichage de votre domaine comme non éligible à une mise à niveau. Si aucune des conditions précédentes ne s'applique à votre domaine et que le problème persiste pendant plus d'une journée, contactez Support.