View a markdown version of this page

Apporter des modifications de configuration dans Amazon OpenSearch 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.

Apporter des modifications de configuration dans Amazon OpenSearch Service

Amazon OpenSearch Le service utilise un blue/green processus de déploiement lors de la mise à jour des domaines. UNE blue/green le déploiement crée un environnement inactif pour les mises à jour du domaine qui copie l'environnement de production et redirige les utilisateurs vers le nouvel environnement une fois ces mises à jour terminées. Dans un blue/green déploiement, l'environnement bleu est l'environnement de production actuel. L'environnement vert est l'environnement inactif.

Les données sont migrées de l'environnement bleu vers l'environnement vert. Lorsque le nouvel environnement sera prêt, OpenSearch Le service passe d'un environnement à l'autre pour promouvoir l'environnement vert en tant que nouvel environnement de production. Le basculement s'effectue sans perte de données. Cette pratique permet de minimiser les temps d'arrêt et de conserver l'environnement d'origine en cas d'échec du déploiement vers le nouvel environnement.

Changements qui provoquent généralement blue/green déploiements

Les opérations suivantes provoquent blue/green déploiements :

  • Modification du type d'instance

  • Activation du contrôle précis des accès

  • Mises à jour du logiciel de service

  • Activation ou désactivation des nœuds principaux dédiés

  • Activation ou désactivation Multi-AZ sans mode veille

  • Modification du type de stockage, du type de volume ou diminution de la taille du volume

  • Sélection de sous-réseaux VPC différents

  • Ajout ou suppression de groupes de sécurité VPC

  • Ajouter ou supprimer des nœuds de coordination dédiés

  • Activation ou désactivation de l'authentification Amazon Cognito pour OpenSearch Tableaux de bord

  • Sélection d'un groupe d'utilisateurs ou d'un groupe d'identités Amazon Cognito différent

  • Modification des paramètres avancés

  • Mise à niveau vers une nouvelle OpenSearch version (OpenSearch Les tableaux de bord peuvent ne pas être disponibles pendant une partie ou la totalité de la mise à niveau)

  • Activation du chiffrement des données au repos ou du chiffrement nœud à nœud

  • Activation ou désactivation UltraWarm ou chambre froide

  • Désactivation Auto-Tune et annuler ses modifications

  • Associer un plugin optionnel à un domaine et dissocier un plugin optionnel d'un domaine

  • Augmenter le nombre de nœuds maîtres dédiés pour Multi-AZ domaines dotés de deux nœuds principaux dédiés

  • Diminution de la taille du volume EBS

  • Modification de la taille du volume EBS, des IOPS ou du débit, si la dernière modification que vous avez apportée est en cours ou s'est produite il y a moins de 6 heures

  • Activation de la publication des journaux d'audit pour CloudWatch.

Pour Multi-AZ avec les domaines de réserve, vous ne pouvez effectuer qu'une seule demande de modification à la fois. Si une modification est déjà en cours, la nouvelle demande est rejetée. Vous pouvez vérifier l'état de la modification en cours à l'aide du DescribeDomainChangeProgress API.

Changements qui ne provoquent généralement pas blue/green déploiements

Dans le plus dans certains cas, les opérations suivantes ne provoquent pas blue/green déploiements :

  • Modifier la politique d'accès

  • Modification du point de terminaison personnalisé

  • Modification de la politique de sécurité de la couche de transport (TLS)

  • Modification de l'heure de début des instantanés automatiques

  • Activation ou désactivation de l'option Exiger HTTPS

  • Habilitant Auto-Tune ou le désactiver sans annuler ses modifications

  • Modifier le nœud de données ou UltraWarm nombre de nœuds

  • Si votre domaine possède déjà des nœuds coordinateurs dédiés, modifiez le nombre de nœuds coordinateurs dédiés.

  • Si votre domaine possède des nœuds maîtres dédiés, modifier le type ou le nombre d'instances principales dédiées (à l'exception de Multi-AZ domaines (avec deux nœuds principaux dédiés)

  • Activer ou désactiver la publication des journaux d'erreurs ou des journaux lents pour CloudWatch

  • Désactiver la publication des journaux d'audit pour CloudWatch

  • Augmentation de la taille du volume, des IOPS ou du débit pour le type EBS gp3.

    Note

    Avant le 10 mars 2026, les augmentations de volume sur place n'étaient prises en charge que pour les volumes allant jusqu'à 3 TiB pour gp3. Le 10 mars 2026, cette limitation a été supprimée, permettant des augmentations de volume sur place supérieures à 3 TiB. Toutefois, si la taille de volume de votre cluster était supérieure à 3 TiB avant la suppression de cette limitation, la première augmentation de volume nécessitera blue/green déploiement. Toutes les augmentations de volume ultérieures pour ce cluster seront effectuées sous forme de mises à jour sur place et ne nécessiteront pas de blue/green déploiement.

  • Augmenter la taille du volume EBS

  • Ajout ou suppression de balises

Note

Il existe quelques exceptions en fonction de la version de votre logiciel de service. Si vous voulez être sûr qu'un changement ne provoquera pas de blue/green déploiement, effectuer une course à sec avant de mettre à jour votre domaine, si cette option est disponible. Certaines modifications n'offrent pas d'option de fonctionnement à sec. Nous vous recommandons généralement d'apporter des modifications à votre cluster en dehors des heures de pointe.

Blue/Green Options de déploiement

Sélectionnez une stratégie de déploiement pour contrôler la manière dont votre cluster gère les déploiements lorsqu'une capacité suffisante n'est pas disponible au moment de la mise à jour.

  1. Swap complet Blue/Green — Comportement de déploiement par défaut. Nécessite une capacité d'instance complète dès le départ, ce qui garantit le déploiement le plus rapide lorsque la capacité est disponible. Le déploiement n'aura pas lieu s'il n'est pas possible d'allouer une capacité suffisante.

  2. Capacité optimisée — Recommandé pour les clusters comportant plus de 30 nœuds de données. Tente une pleine blue/green changez d'abord, et si la capacité est insuffisante, procédez au déploiement par lots. Garantit que les déploiements peuvent être effectués même lorsque la capacité est limitée. Le temps de réalisation peut augmenter, car le déploiement sera effectué par lots.

Console

Pour modifier le flux de domaine :

  1. Ouvrez l'Amazon OpenSearch Console de service à https://console.aws.amazon.com/aos/home.

  2. Dans le volet de navigation, sous Domaines, choisissez le nom de domaine pour ouvrir la configuration du cluster.

  3. Cliquez sur Modifier bouton sur le côté droit Configuration du cluster onglet.

  4. À partir de Stratégie de déploiement options : choisissez les configurations requises pour la mise à jour du domaine :

    1. Swap complet Blue/Green — Comportement de déploiement par défaut. Nécessite une capacité d'instance complète dès le départ, ce qui garantit le déploiement le plus rapide lorsque la capacité est disponible. Le déploiement n'aura pas lieu s'il n'est pas possible d'allouer une capacité suffisante.

    2. Capacité optimisée — Recommandé pour les clusters comportant plus de 30 nœuds de données. Tente une pleine blue/green changez d'abord, et si la capacité est insuffisante, procédez au déploiement par lots. Garantit que les déploiements peuvent être effectués même lorsque la capacité est limitée. Le temps de réalisation peut augmenter, car le déploiement sera effectué par lots.

  5. Cliquez sur Enregistrer les modifications.

Pour Create Domain Flow :

  1. Ouvrez l'Amazon OpenSearch Console de service à https://console.aws.amazon.com/aos/home.

  2. Dans le volet de navigation de gauche, choisissez Domaines.

  3. Cliquez sur Créer un domaine bouton.

  4. Sélectionnez toutes les configurations requises pour le domaine.

  5. À partir de Stratégie de déploiement options : choisissez les configurations requises pour la mise à jour du domaine :

    1. Swap complet Blue/Green — Comportement de déploiement par défaut. Nécessite une capacité d'instance complète dès le départ, ce qui garantit le déploiement le plus rapide lorsque la capacité est disponible. Le déploiement n'aura pas lieu s'il n'est pas possible d'allouer une capacité suffisante.

    2. Capacité optimisée — Recommandé pour les clusters comportant plus de 30 nœuds de données. Tente une pleine blue/green changez d'abord, et si la capacité est insuffisante, procédez au déploiement par lots. Garantit que les déploiements peuvent être effectués même lorsque la capacité est limitée. Le temps de réalisation peut augmenter, car le déploiement sera effectué par lots.

  6. Cliquez sur Créez bouton sur Résumé du domaine panneau sur le côté droit.

API

Vous pouvez configurer la stratégie de déploiement à l'aide du UpdateDomainConfig API.

Option d'optimisation de la capacité

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config { "DeploymentStrategyOptions": { "DeploymentStrategy": "CapacityOptimized" } }

Option par défaut

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config { "DeploymentStrategyOptions": { "DeploymentStrategy": "Default" } }

Déterminer si un changement provoquera une blue/green déploiement

Vous pouvez tester certains types de modifications de configuration planifiées afin de déterminer si elles provoqueront une blue/green déploiement, sans avoir à s'engager dans ces changements. Avant de lancer une modification de la configuration, utilisez la console ou une API pour exécuter une vérification de validation afin de vous assurer que votre domaine est éligible à une mise à jour.

Console
Pour valider un changement de configuration
  1. Accédez à Amazon OpenSearch Console de service à https://console.aws.amazon.com/aos/.

  2. Dans le volet de navigation de gauche, choisissez Domaines.

  3. Sélectionnez le domaine pour lequel que vous voluez effectuer une modification de configuration. Cette action ouvre la page des détails du domaine. Sélectionnez le menu déroulant Actions, puis choisissez Edit cluster configuration (Modifier la configuration du cluster).

  4. Apportez des modifications au domaine, par exemple en modifiant le type d'instance ou le nombre de nœuds.

  5. En dessous Analyse du fonctionnement à sec, choisissez Courez. L'exécution à sec valide votre modification de configuration pour détecter les erreurs et détermine si elle nécessite un blue/green déploiement.

  6. Lorsque le cycle à sec est terminé, les résultats apparaissent en bas de la page, accompagnés d'un identifiant de cycle à sec. L'analyse indique si le changement de configuration nécessite ou non un blue/green déploiement.

    Chaque essai à sec remplace le précédent. Pour conserver les détails de chaque essai, enregistrez son identifiant d'essai à sec. Les essais à sec sont disponibles pendant 90 jours ou jusqu'à ce que vous effectuiez une mise à jour de configuration.

  7. Pour procéder à la mise à jour de votre configuration, choisissez Save changes (Enregistrer les modifications). Sinon, sélectionnez Annuler. Chaque option a pour effet de vous ramener à l'onglet Cluster configuration (Configuration du cluster). Dans cet onglet, vous pouvez sélectionner Dry run details (Détails du test à blanc) pour afficher les détails de votre dernier test à blanc. Cette page comprend également une comparaison côte à côte entre la configuration avant le test à blanc et la configuration du test à blanc.

API

Vous pouvez également effectuer une validation du test à blanc via l'API de configuration. Pour tester vos modifications avec l'API, définissez DryRun sur true et DryRunMode surVerbose. Le mode Verbose exécute un contrôle de validation en plus de déterminer si la modification provoquera une blue/green déploiement. Par exemple, ceci UpdateDomainConfig la demande teste le type de déploiement qui résulte de l'activation UltraWarm:

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config { "ClusterConfig": { "WarmCount": 3, "WarmEnabled": true, "WarmType": "ultrawarm1.large.search" }, "DryRun": true, "DryRunMode": "Verbose" }

La demande effectue une vérification de validation et renvoie le type de déploiement que la modification entraînera, mais n'effectue pas réellement la mise à jour :

{ "ClusterConfig": { ... }, "DryRunResults": { "DeploymentType": "Blue/Green", "Message": "This change will require a blue/green deployment." } }

Les types de déploiement possibles sont les suivants :

  • Blue/Green — Le changement provoquera une blue/green déploiement.

  • DynamicUpdate — Le changement ne provoquera pas de blue/green déploiement.

  • Undetermined : le domaine est toujours en traitement, de sorte que le type de déploiement ne peut pas être déterminé.

  • None : aucune modification de configuration.

Si la validation échoue, elle renvoie une liste des échecs de validation.

{ "ClusterConfig":{ "..." }, "DryRunProgressStatus":{ "CreationDate":"2023-01-12T01:14:33.847Z", "DryRunId":"db00ca39-48b2-4774-bbd3-252cf094d205", "DryRunStatus":"failed", "UpdateDate":"2023-01-12T01:14:33.847Z", "ValidationFailures":[ { "Code":"Cluster.Index.WriteBlock", "Message":"Cluster has index write blocks." } ] } }

Si le statut est toujours pending, vous pouvez utiliser l'identifiant de fonctionnement à sec de votre UpdateDomainConfig réponse dans la suite DescribeDryRunProgress appels pour vérifier l'état de la validation.

GET https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/dryRun?dryRunId=my-dry-run-id { "DryRunConfig": null, "DryRunProgressStatus": { "CreationDate": "2023-01-12T01:14:42.998Z", "DryRunId": "db00ca39-48b2-4774-bbd3-252cf094d205", "DryRunStatus": "succeeded", "UpdateDate": "2023-01-12T01:14:49.334Z", "ValidationFailures": null }, "DryRunResults": { "DeploymentType": "Blue/Green", "Message": "This change will require a blue/green deployment." } }

Pour exécuter une analyse de test à blanc sans vérification de validation, définissez DryRunMode surBasic lorsque vous utilisez l'API de configuration.

Python

Le code Python suivant utilise le UpdateDomainConfig API pour effectuer un contrôle de validation à sec et, si le contrôle réussit, appelle la même API sans lancer de test pour démarrer la mise à jour. Si la vérification échoue, le script affiche l'erreur et s'arrête.

import time import boto3 client = boto3.client('opensearch') response = client.update_domain_config( ClusterConfig={ 'WarmCount': 3, 'WarmEnabled': True, 'WarmType': 'ultrawarm1.large.search', }, DomainName='test-domain', DryRun=True, DryRunMode='Verbose' ) dry_run_id = response.get("DryRunProgressStatus").get("DryRunId") retry_count = 0 while True: if retry_count == 5: print('An error occured') break dry_run_progress_response = client.describe_dry_run_progress( DomainName='test-domain', DryRunId=dry_run_id) dry_run_status = dry_run_progress_response.get("DryRunProgressStatus").get("DryRunStatus") if dry_run_status == 'succeeded': client.update_domain_config( ClusterConfig={ 'WarmCount': 3, 'WarmEnabled': True, 'WarmType': 'ultrawarm1.large.search', }, DomainName='test-domain') print("Success!") break elif dry_run_status == 'failed': validation_failures_list = dry_run_progress_response.get("DryRunProgressStatus").get("ValidationFailures") for item in validation_failures_list: print(f"Code: {item['Code']}, Message: {item['Message']}") break retry_count += 1 time.sleep(30)

Validation d'une mise à jour de domaine

Avant Amazon OpenSearch Le service applique un changement de configuration de domaine, il valide le changement demandé par rapport à l'état actuel de votre domaine. Chaque résultat de validation est classé par niveau de gravité :

  • Critique — Un échec de blocage. La modification ne peut pas être effectuée tant que vous n'avez pas résolu le problème sous-jacent. Les défaillances critiques ne peuvent être acceptées.

  • Avertissement — Des conseils sur un changement susceptible de réussir mais comportant des risques. Par exemple, des nœuds de coordination dédiés qui peuvent être sous-dimensionnés pour la configuration de votre nœud de données. Vous pouvez accepter un avertissement pour laisser la modification se poursuivre.

Par défaut, tout avertissement bloque la modification. Pour continuer, acceptez l'avertissement en incluant son code dans le AcceptedWarnings paramètre de votre demande de mise à jour. L'avis de validation est disponible pour tous les sites Amazon OpenSearch Domaines de service, dans les deux cas OpenSearch et les versions Elasticsearch.

Révision des résultats de validation

Faites une course à sec avec DryRunMode réglé sur Verbose pour consulter les résultats de validation avant d'appliquer une modification. Chaque résultat apparaît dans ValidationFailures liste renvoyée par DescribeDryRunProgress (pour les courses à sec) et DescribeDomainChangeProgress (pour les modifications soumises), avec son code, son message et sa gravité. La gravité est également incluse dans Amazon EventBridge notifications.

Pour la liste complète des codes de validation, si chacun d'entre eux peut être accepté (Peut être annulé ?) et les étapes de dépannage, voir Résolution des erreurs de validation.

Accepter un avertissement

API

Incluez le code de chaque avertissement que vous souhaitez accepter dans le AcceptedWarnings paramètre de UpdateDomainConfig. Ce paramètre s'applique uniquement à la mise à jour en cours et n'est pas conservé sur le domaine. Les avertissements acceptés pour la modification la plus récente sont renvoyés dans le AcceptedWarnings domaine de DescribeDomainChangeProgress et DescribeDryRunProgress.

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/domain/my-domain/config { "ClusterConfig": { ... }, "AcceptedWarnings": ["CoordinatorNodeUndersized"] }
CloudFormation

Réglez le AcceptedWarnings propriété sur la ressource de votre domaine pour accepter les avertissements directement dans votre modèle. Incluez le code de chaque avertissement que vous souhaitez accepter. Comme pour l'API, cette propriété s'applique uniquement à la mise à jour dans laquelle elle est incluse et n'est pas conservée sur le domaine.

Resources: MyDomain: Type: AWS::OpenSearchService::Domain Properties: DomainName: my-domain ClusterConfig: ... AcceptedWarnings: - CoordinatorNodeUndersized
Console

Acceptez un avertissement après un essai à sec (avant d'appliquer le changement)

  1. Dans le OpenSearch Console de service, choisissez votre domaine, puis choisissez Configuration du cluster, puis Modifier.

  2. Apportez les modifications nécessaires à votre configuration. Faites un essai à sec avant d'économiser reste sélectionnée par défaut.

  3. Choisissez Courez pour démarrer la course à sec.

  4. Lorsque le tirage à sec se termine avec des résultats de validation, une alerte apparaît au-dessus du formulaire, divisée en Problèmes critiques (N) et Avertissements (N). Chaque entrée affiche le code d'émission et son message.

  5. Choisissez Reconnaître les avertissements.

  6. Dans la boîte de dialogue, sélectionnez chaque avertissement que vous souhaitez accepter. Les défaillances critiques sont répertoriées mais ne peuvent pas être sélectionnées.

  7. Choisissez Reconnaissez et courez à sec pour revalider avec les avertissements acceptés.

  8. Lorsqu'aucun échec de blocage ne persiste, choisissez Enregistrer les modifications pour appliquer la mise à jour. Les avertissements que vous avez acceptés figurent dans cette soumission.

Accepter un avertissement en cas d'échec de validation d'une modification

  1. Sur la page détaillée du domaine, recherchez la modification en cours et choisissez Afficher les détails dans le panneau de progression des modifications.

  2. Le Validation des spectacles sur scène comme un échec, avec Problèmes critiques (N) et Avertissements (N) sections.

  3. Résolvez toutes les défaillances critiques. Elles ne peuvent pas être acceptées. Certains sont environnementaux (par exemple, la libération d'adresses IP dans un sous-réseau) et ne nécessitent pas de modifier la configuration demandée.

  4. Sélectionnez chaque avertissement que vous souhaitez accepter dans le Avertissements table.

  5. Choisissez Confirmez et réessayez pour soumettre à nouveau la modification avec ces avertissements acceptés.

  6. Si vous avez résolu une panne critique en dehors de la console et que vous n'avez aucun avertissement à accepter, choisissez Réessayez pour soumettre à nouveau la modification sans modification.

Suivi d'un changement de configuration

Vous pouvez demander une modification de configuration à la fois ou regrouper plusieurs modifications dans une seule demande. Utilisez le État du traitement du domaine et État du changement de configuration champs de la console pour suivre les modifications de configuration. Attendez que le statut du domaine devienne Active avant de demander des modifications supplémentaires.

Un domaine peut avoir les caractéristiques suivantes états de traitement:

  • Active — Aucune modification de configuration n'est en cours. Vous pouvez soumettre une nouvelle demande de modification de configuration.

  • Creating — Le domaine est en cours de création.

  • Modifying — Des modifications de configuration, telles que l'ajout de nouveaux nœuds de données, EBS, gp3, le provisionnement IOPS ou la configuration de clés KMS, sont en cours.

  • Upgrading engine version — Une mise à niveau de la version du moteur est en cours.

  • Updating service software — Une mise à jour du logiciel de service est en cours.

  • Deleting — Le domaine est en cours de suppression.

  • Isolated — Le domaine est suspendu.

Un domaine peut avoir les caractéristiques suivantes états des modifications de configuration:

  • Pending — Une demande de modification de configuration a été soumise.

  • Initializing — Le service initialise une modification de configuration.

  • Validating — Le service valide les modifications demandées et les ressources requises.

  • Awaiting user inputs — Le service s'attend à ce que les modifications de configuration, telles qu'un changement de type d'instance, se poursuivent. Vous pouvez modifier les modifications de configuration.

  • Applying changes — Le service applique les modifications de configuration demandées.

  • Cancelled — La modification de configuration est annulée. Choisissez Annuler annuler toutes les modifications.

  • Completed — Les modifications de configuration demandées ont été effectuées avec succès.

  • Validation failed — Les modifications de configuration demandées n'ont pas été effectuées. Aucune modification de configuration n'a été appliquée.

    Note

    Les échecs de validation peuvent être dus à la présence d'index rouges dans votre domaine, à l'indisponibilité d'un type d'instance choisi ou à un espace disque insuffisant. Pour obtenir la liste des erreurs de validation, voir Résolution des erreurs de validation. Lors d'un échec de validation, vous pouvez annuler, réessayer ou modifier les modifications de configuration.

Lorsque les modifications de configuration sont terminées, le statut du domaine revient à Active.

Vous pouvez vérifier l'état du cluster et Amazon CloudWatch métriques et constatez que le nombre de nœuds du cluster augmente temporairement, voire double, pendant la mise à jour du domaine. Dans l'illustration suivante, vous pouvez voir le nombre de nœuds passer de 11 à 22 pendant la modification de la configuration et revenir à 11 une fois la mise à jour terminée.

Nombre de nœuds passant de 11 à 22 au cours d'une modification de la configuration du domaine.

Cette augmentation temporaire peut faire peser davantage de contraintes sur les nœuds principaux dédiés du cluster, ce dernier ayant soudainement beaucoup plus de nœuds à gérer. Il peut également augmenter les latences de recherche et d'indexation car OpenSearch Le service copie les données de l'ancien cluster vers le nouveau. Il est important de maintenir une capacité suffisante sur le cluster pour gérer les frais généraux qui y sont associés. blue/green déploiements.

Important

Vous ne paierez aucuns frais supplémentaires pendant les changements de configuration et de maintenance. Des frais vous sont facturés uniquement pour le nombre de nœuds demandé pour votre cluster. Pour plus de détails, reportez-vous à la section Frais associés aux modifications de la configuration.

Pour éviter de surcharger les nœuds maîtres dédiés, vous pouvez surveiller l'utilisation avec Amazon CloudWatch indicateurs. Pour connaître les valeurs maximales recommandées, consultez Recommandé CloudWatch alarmes pour Amazon OpenSearch Service.

Étapes d'un changement de configuration

Après avoir initié une modification de configuration, OpenSearch Le service passe par une série d'étapes pour mettre à jour votre domaine. Vous pouvez consulter la progression du changement de configuration sous État du changement de configuration dans la console. Les étapes exactes par lesquelles passe une mise à jour dépendent du type de changement que vous effectuez. Vous pouvez également surveiller un changement de configuration à l'aide de l'opération d'API DescribeDomainChangeProgress.

Voici les étapes possibles par lesquelles une mise à jour peut passer lors d'un changement de configuration :

Nom de l’environnement Description

Validation

Validation de l'éligibilité du domaine à une mise à jour et mise en évidence des problèmes de validation si nécessaire.

Création d'un nouvel environnement

Remplir les prérequis nécessaires et créer les ressources nécessaires pour démarrer le blue/green déploiement.

Approvisionnement de nouveaux nœuds

Création d'un nouvel ensemble d'instances dans le nouvel environnement.

Routage du trafic sur les nouveaux nœuds

Redirection du trafic vers les nœuds de données nouvellement créés.

Routage du trafic sur les anciens nœuds

Désactivation du trafic sur les anciens nœuds de données.

Préparation des nœuds à la suppression

Préparation de la suppression des nœuds. Cette étape ne se produit que lorsque vous réduisez la taille de votre domaine (par exemple, de 8 nœuds à 6 nœuds).

Copie des partitions vers les nouveaux nœuds

Déplacement des partitions des anciens nœuds vers les nouveaux nœuds.

Résiliation des nœuds

Résiliation et suppression des anciens nœuds après la suppression des partitions.

Suppression des anciennes ressources

Suppression des ressources associées à l'ancien environnement (par exemple, l'équilibreur de charge).

Mise à jour dynamique

S'affiche lorsque la mise à jour ne nécessite pas de blue/green déploiement et peut être appliqué de manière dynamique.

Appliquer les modifications liées au master dédié

S'affiche lorsque le type ou le nombre d'instances principales dédiées sont modifiés.

Appliquer les modifications liées au volume

S'affiche lorsque la taille, le type, les IOPS et le débit du volume sont modifiés.

Impact sur les performances de blue/green déploiements

Pendant blue/green déploiement de votre Amazon OpenSearch Le cluster de services est disponible pour les demandes de recherche et d'indexation entrantes. Cependant, vous pouvez rencontrer les problèmes de performances suivants :

  • Augmentation temporaire de l'utilisation des nœuds leaders car les clusters ont plus de nœuds à gérer.

  • Latence de recherche et d'indexation accrue car OpenSearch Le service copie les données des anciens nœuds vers les nouveaux nœuds.

  • Augmentation du nombre de rejets pour les demandes entrantes à mesure que la charge du cluster augmente pendant blue/green déploiements.

  • Pour éviter les problèmes de latence et les rejets de demandes, vous devez exécuter blue/green déploiements lorsque le cluster est en bon état et que le trafic réseau est faible.

Frais associés aux modifications de la configuration

Si vous modifiez la configuration d'un domaine, OpenSearch Le service crée un nouveau cluster comme décrit dans Apporter des modifications de configuration dans Amazon OpenSearch Service. Lors de la migration de l'ancien cluster vers le nouveau, les frais suivants vous incombent :

  • Si vous modifiez le type d'instance, les deux clusters vous sont facturés pendant la première heure. À l'issue de la première heure, seul le nouveau cluster vous est facturé. Les volumes EBS ne sont pas facturés deux fois car ils font partie de votre cluster. Leur facturation suit donc celle des instances.

    Exemple : Vous modifiez la configuration pour la faire passer de trois instances m3.xlarge à quatre instances m4.large. Pour la première heure, vous êtes facturé pour les deux clusters (3 * m3.xlarge + 4 * m4.large). Après la première heure, seul le nouveau cluster vous est facturé (4 * m4.large).

  • Si vous ne modifiez pas le type d'instance, seul le plus grand cluster vous est facturé pour la première heure. À l'issue de la première heure, seul le nouveau cluster vous est facturé.

    Exemple : Vous modifiez la configuration pour la faire passer de six instances m3.xlarge à trois instances m3.xlarge. Pendant la première heure, le plus grand cluster vous est facturé (6 * m3.xlarge). Après la première heure, seul le nouveau cluster vous est facturé (3 * m3.xlarge).

Résolution des erreurs de validation

Lorsque vous initiez un changement de configuration ou que vous effectuez une 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 à jour. Si l'un de ces contrôles échoue, vous recevez une notification dans la console contenant les problèmes spécifiques que vous devez résoudre avant de mettre à jour votre domaine.

OpenSearch Le service isole votre domaine s'il reste inutilisable pendant plus de 60 jours. Nous vous enverrons des notifications de rappel pour résoudre ces problèmes. Si vous ne résolvez pas les problèmes dans ce délai, OpenSearch Le service supprime votre domaine et ses données.

Le tableau suivant répertorie les problèmes de domaine possibles qui OpenSearch Un service peut faire surface et des mesures pour les résoudre.

Problème Code d’erreur Peut être annulé ? Étapes de résolution des problèmes
Groupe de sécurité introuvable SecurityGroupNotFound

Non

Le groupe de sécurité associé à votre OpenSearch Le domaine de service n'existe pas. Pour résoudre ce problème, créez un groupe de sécurité avec le nom spécifié.

Sous-réseau introuvable SubnetNotFound

Non

Le sous-réseau associé à votre OpenSearch Le domaine de service n'existe pas. Pour résoudre ce problème, créer un sous-réseau dans votre VPC.

Service-linked rôle non configuré SLRNotConfigured

Non

Le rôle lié à un service pour OpenSearch Le service n'est pas configuré. Le rôle lié à un service est prédéfini par OpenSearch Service et inclut toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom. Si le rôle n'existe pas, vous devrez peut-être le créer manuellement.
Pas assez d'adresses IP InsufficientFreeIPsForSubnets

Non

Un ou plusieurs de vos sous-réseaux VPC ne disposent pas de suffisamment d'adresses IP pour mettre à jour votre domaine. Pour calculer le nombre d'adresses IP dont vous avez besoin, consultez Réservation d'adresses IP dans un sous-réseau VPC.

Le groupe d'utilisateurs Cognito n'existe pas CognitoUserPoolNotFound

Non

OpenSearch Le service ne trouve pas le groupe d'utilisateurs Amazon Cognito. Vérifiez que vous en avez créé un et qu'il a l'ID correct. Pour rechercher l'ID, vous pouvez utiliser la console Amazon Cognito ou la commande AWS CLI suivante :

aws cognito-idp list-user-pools --max-results 60 --region us-east-1
Le groupe d'identités Cognito n'existe pas CognitoIdentityPoolNotFound

Non

OpenSearch Le service ne trouve pas le pool d'identités Cognito. Vérifiez que vous en avez créé un et qu'il a l'ID correct. Pour rechercher l'ID, vous pouvez utiliser la console Amazon Cognito ou la commande AWS CLI suivante :

aws cognito-identity list-identity-pools --max-results 60 --region us-east-1
Domaine Cognito introuvable pour le groupe d'utilisateurs CognitoDomainNotFound

Non

Le groupe d'utilisateurs n'a pas de nom de domaine. Vous pouvez en configurer un à l'aide de la console Amazon Cognito ou des outils suivants AWS CLI commande :

aws cognito-idp create-user-pool-domain --domain my-domain --user-pool-id id
Le rôle Cognito n'est pas configuré CognitoRoleNotConfigured

Non

Le rôle de l'IAM qui octroie OpenSearch L'autorisation de service permettant de configurer les groupes d'utilisateurs et d'identités Amazon Cognito, et de les utiliser pour l'authentification, n'est pas configurée. Configurez le rôle avec un jeu d'autorisations et une relation d'approbation appropriés. Vous pouvez utiliser la console, qui crée la valeur par défaut CognitoAccessForAmazonOpenSearch rôle pour vous, ou vous pouvez configurer manuellement un rôle à l'aide du AWS CLI ou le AWS SDK.

Impossible de décrire le groupe d'utilisateurs UserPoolNotDescribable

Non

Le rôle Amazon Cognito spécifié n'a pas l'autorisation de décrire le groupe d'utilisateurs associé à votre domaine. Assurez-vous que la politique d'autorisation du rôle autorise l'action cognito-identity:DescribeUserPool. Consultez À propos du CognitoAccessForAmazonOpenSearch rôle pour connaître la politique d'autorisation complète.
Impossible de décrire le groupe d'identités IdentityPoolNotDescribable

Non

Le rôle Amazon Cognito spécifié n'a pas l'autorisation de décrire le groupe d'identités associé à votre domaine. Assurez-vous que la politique d'autorisation du rôle autorise l'action cognito-identity:DescribeIdentityPool. Consultez À propos du CognitoAccessForAmazonOpenSearch rôle pour connaître la politique d'autorisation complète.
Impossible de décrire le groupe d'utilisateurs et d'identités CognitoPoolsNotDescribable

Non

Le rôle Amazon Cognito spécifié n'a pas l'autorisation de décrire les groupes d'utilisateurs et d'identités associés à votre domaine. Assurez-vous que la politique d'autorisation du rôle autorise les actions cognito-identity:DescribeIdentityPool et cognito-identity:DescribeUserPool. Consultez À propos du CognitoAccessForAmazonOpenSearch rôle pour connaître la politique d'autorisation complète.
La clé KMS n'est pas activée KMSKeyNotEnabled

Non

Le AWS Key Management Service (AWS KMS) la clé utilisée pour chiffrer votre domaine est désactivée. Re-enable la clé immédiatement.

Le certificat personnalisé n'est pas dans l'état ISSUED (ÉMIS) InvalidCertificate

Non

Si votre domaine utilise un point de terminaison personnalisé, vous pouvez le sécuriser en générant un certificat SSL dans AWS Certificate Manager (ACM) ou en important l'un des vôtres. L'état du certificat doit être Issued (Émis). Si vous recevez cette erreur, vérifiez le statut de votre certificat dans la console ACM. Si le statut est Expired (Expiré), Failed (Échec), Inactive (Inactif) ou Pending validation (En attente de validation), consultez la documentation de résolution des problèmes ACM pour résoudre le problème.

Pas assez de capacité pour lancer le type d'instance choisi InsufficientInstanceCapacity

Non

La capacité du type d'instance demandé n'est pas disponible. Par exemple, vous avez peut-être demandé cinq i3.16xlarge.search nœuds, mais OpenSearch Le service ne suffit pas i3.16xlarge.search hôtes disponibles, la demande ne peut donc pas être satisfaite. Vérifiez le types d'instances pris en charge dans OpenSearch Effectuez le service et choisissez un autre type d'instance.

Index rouges dans le cluster RedCluster

Non

Un ou plusieurs index de votre cluster ont un statut rouge, ce qui entraîne un statut rouge global du cluster. Pour résoudre ce problème et y remédier, consultez Statut de cluster rouge.

Disjoncteur de mémoire, trop de demandes TooManyRequests

Non

Il y a trop de demandes de recherche et d'écriture pour votre domaine, donc OpenSearch Le service ne peut pas mettre à jour sa configuration. Vous pouvez réduire le nombre de demandes, mettre à l'échelle les instances verticalement jusqu'à 64 GiB de RAM, ou mettre à l'échelle horizontalement en ajoutant des instances.

La nouvelle configuration ne peut pas contenir de données (faible espace disque) InsufficientStorageCapacity

Non

La taille de stockage configurée ne peut pas contenir toutes les données de votre domaine. Pour résoudre ce problème, choisissez un volume plus grand, supprimez les index inutilisés ou augmentez le nombre de nœuds dans le cluster pour libérer immédiatement de l'espace disque.

Partitions épinglées à des nœuds spécifiques ShardMovementBlocked

Non

Un ou plusieurs index de votre domaine sont attachés à des nœuds spécifiques et ne peuvent pas être réaffectés. Cela s'est très probablement produit parce que vous avez configuré le filtrage d'allocation des partitions, qui vous permet de spécifier les nœuds autorisés à héberger les partitions d'un index particulier.

Pour résoudre ce problème, supprimez les filtres d'allocation de partitions de tous les index concernés :

PUT my-index/_settings { "settings": { "index.routing.allocation.require._name": null } }
La nouvelle configuration ne peut pas contenir toutes les partitions (nombre de partitions) TooManyShards

Oui

Le nombre de fragments sur votre domaine est trop élevé, ce qui empêche OpenSearch Service allant de leur déplacement vers la nouvelle configuration. Pour résoudre ce problème, mettez à l'échelle horizontalement votre domaine en ajoutant des nœuds du même type de configuration que vos nœuds de cluster actuels. Notez que la taille maximale des volumes EBS dépend du type d'instance du nœud. Il s'agit d'un avertissement. Si vous comprenez l'impact et que vous souhaitez continuer quand même, acceptez-le en incluant TooManyShards dans le AcceptedWarnings paramètre de votre demande de mise à jour.

Pour éviter ce problème à l'avenir, consultez Choix du nombre de partitions et définissez une stratégie de partitionnement adaptée à votre cas d'utilisation.

La nouvelle configuration dépasse le nombre maximum de partitions par nœud MaxShardCountExceeded

Oui

Le nombre de partitions qui seraient placées sur chaque nœud dans la nouvelle configuration dépasse le maximum autorisé par nœud. Pour résoudre ce problème, ajoutez d'autres nœuds du même type de configuration à votre domaine, ou supprimer les index non utilisés pour réduire le nombre total de fragments, puis réessayez. Il s'agit d'un avertissement. Si vous comprenez l'impact et que vous souhaitez continuer quand même, acceptez-le en incluant MaxShardCountExceeded dans le AcceptedWarnings paramètre de votre demande de mise à jour. Pour éviter ce problème à l'avenir, consultez Choix du nombre de partitions et définissez une stratégie de partitionnement adaptée à votre cas d'utilisation.

Cross-cluster la connexion dépasse la limite de partition RemoteClusterTooManyShards

Non

Le nombre total de fragments sur votre recherche entre clusters les connexions dépassent la limite autorisée, donc OpenSearch Le service ne peut pas déplacer les partitions vers la nouvelle configuration. Pour résoudre ce problème, réduisez le nombre de partitions sur les domaines connectés en ajoutant des nœuds du même type de configuration ou suppression des index non utilisés, puis réessayez.

La nouvelle configuration dépasse le nombre maximum de fragments par nœud pour Multi-AZ avec domaine de secours HAMaxShardCountExceeded

Non

Domaines qui utilisent Multi-AZ avec Standby appliquez une limite de partition par nœud plus stricte, et la nouvelle configuration la dépasserait. Pour résoudre ce problème, ajoutez d'autres nœuds du même type de configuration, ou supprimer les index non utilisés pour réduire le nombre total de fragments, puis réessayez. Pour éviter que ce problème ne se reproduise à l'avenir, consultez Choix du nombre de partitions.

Le nœud coordinateur dédié est inférieur à la taille de mémoire recommandée CoordinatorNodeUndersized

Oui

Chaque nœud coordinateur dédié doit disposer d'au moins autant de mémoire qu'un nœud de données, jusqu'à un maximum de 64 Go. Pour résoudre ce problème, choisissez un type d'instance de nœud coordinateur plus important. Il s'agit d'un avertissement. Si vous comprenez l'impact et que vous souhaitez continuer quand même, acceptez-le en incluant CoordinatorNodeUndersized dans le AcceptedWarnings paramètre de votre demande de mise à jour. Pour obtenir des conseils sur les tailles, voir Nœuds de coordination dédiés dans Amazon OpenSearch Service.

La taille totale du processeur virtuel des nœuds coordinateurs dédiés est inférieure à la taille recommandée CoordinatorVCpuRatioTooLow

Oui

Le nombre total de processeurs virtuels de vos nœuds coordinateurs dédiés est inférieur au minimum recommandé de 10 % du nombre total de processeurs virtuels de vos nœuds de données, ce qui peut laisser une capacité de coordination insuffisante pour votre cluster. Pour résoudre ce problème, augmentez le nombre de nœuds coordinateurs ou choisissez un type d'instance de coordinateur plus important. Il s'agit d'un avertissement. Pour continuer sans modifications, incluez CoordinatorVCpuRatioTooLow dans le AcceptedWarnings paramètre de votre demande de mise à jour. Pour obtenir des conseils sur les tailles, voir Nœuds de coordination dédiés dans Amazon OpenSearch Service.

Le sous-réseau associé à votre domaine ne prend pas en charge les adresses IPv4

ResultCodeIPv4BlockNotExists

Non

Pour résoudre ce problème, créer un sous-réseau ou mettre à jour le sous-réseau existant dans votre VPC en fonction du type d'adresse IP configuré pour le domaine. Si votre domaine utilise un IPv4 uniquement type d'adresse, utilisez un IPv4-only sous-réseau. Si votre domaine utilise Dual-stack mode, utilisez un sous-réseau à double pile.

Le sous-réseau associé à votre domaine ne prend pas en charge les adresses IPv6

ResultCodeIPv6BlockNotExists

Non

Pour résoudre ce problème, créer un sous-réseau ou mettre à jour le sous-réseau existant dans votre VPC en fonction du type d'adresse IP configuré pour le domaine. Si votre domaine utilise un IPv4 uniquement type d'adresse, utilisez un IPv4-only sous-réseau. Si votre domaine utilise Dual-stack mode, utilisez un sous-réseau à double pile.