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.

Changement de nom d'Amazon OpenSearch Service : résumé des modifications

Le 8 septembre 2021, notre suite de recherche et d'analyse a été renommé Amazon OpenSearch Service. OpenSearch Service prend en charge OpenSearch ainsi que l'ancien système d'exploitation hérité Elasticsearch. Les sections suivantes décrivent les différentes parties du service qui ont changé avec le nouveau nom et les actions que vous devez effectuer afin de garantir le bon fonctionnement de vos domaines.

Certaines de ces modifications s'appliquent uniquement lorsque vous mettez à niveau vos domaines d'Elasticsearch vers OpenSearch. Dans d'autres cas, par exemple dans la console Billing and Cost Management, l'expérience change immédiatement.

Veuillez noter que cette liste n'est pas exhaustive. Bien que d'autres parties du produit aient également changé, ces mises à jour sont les plus pertinentes.

Nouvelle version d'API

La nouvelle version de l'API de configuration OpenSearch Service (2021-01-01) fonctionne avec OpenSearch ainsi qu'avec le système d'exploitation hérité Elasticsearch. 21 opérations d'API ont été remplacées par des noms plus concis et indépendants du moteur (par exemple, CreateElasticsearchDomain remplacé par CreateDomain), mais OpenSearch Service continue de prendre en charge les deux versions de l'API.

Nous vous recommandons d'utiliser les nouvelles opérations d'API pour créer et gérer des domaines à l'avenir. Notez que lorsque vous utilisez les nouvelles opérations d'API pour créer un domaine, vous devez spécifier le paramètre EngineVersion au format Elasticsearch_X.Y ou OpenSearch_X.Y, plutôt que simplement le numéro de version. Si vous ne spécifiez aucune version, elles utiliseront par défaut la plus récente version d'OpenSearch.

Mettez à niveau AWS CLI vers la version 1.20.40 ou ultérieure afin de pouvoir utiliser aws opensearch ... pour créer et gérer vos domaines. Pour connaître le nouveau format CLI, consultez la Référence de la CLI d'OpenSearch.

Types d'instances renommés

Les types d'instance dans Amazon OpenSearch Service sont désormais au format <type>.<size>.search, par exemple, m6g.large.search plutôt que m6g.large.elasticsearch. Aucune action de votre part n'est requise. Les domaines existants commenceront automatiquement à faire référence aux nouveaux types d'instances dans l'API et dans la console Billing and Cost Management.

Si vous possédez des instances réservées (IR), votre contrat ne sera pas affecté par la modification. L'ancienne version de l'API de configuration est toujours compatible avec l'ancien format de dénomination, mais si vous souhaitez utiliser la nouvelle version de l'API, vous devrez utiliser le nouveau format.

Modifications des stratégies d'accès

Les sections suivantes décrivent les actions que vous devez effectuer pour mettre à jour vos stratégies d'accès.

Politiques IAM

Nous vous recommandons de mettre à jour les politiques IAM afin de pouvoir utiliser les opérations API renommées. Cependant, OpenSearch Service continuera de respecter les politiques existantes en répliquant en interne les anciennes autorisations d'API. Par exemple, si vous disposez actuellement de l'autorisation d'exécuter l'opération CreateElasticsearchDomain, vous pourrez maintenant appeler à la fois CreateElasticsearchDomain (ancienne opération d'API) et CreateDomain (nouvelle opération d'API). Il en va de même pour les refus explicites. Pour obtenir la liste des opérations d'API mises à jour, consultez la référence des éléments de politique.

Politiques SCP

Les politiques de contrôle des services (SCP) introduisent une couche de complexité supplémentaire par rapport à la politique IAM standard. Pour éviter que vos politiques SCP ne soient rompues, vous devez ajouter l'ancienne et la nouvelle opération d'API à chacune de vos politiques SCP. Par exemple, si un utilisateur dispose actuellement d'autorisations pour CreateElasticsearchDomain, vous devez également lui octroyer des autorisations pour CreateDomain afin qu'il puisse conserver la possibilité de créer des domaines. Il en va de même pour les refus explicites.

Par exemple :

"Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "es:CreateElasticsearchDomain",
        "es:CreateDomain"
         ...
      ],
    },
      "Effect": "Deny",
      "Action:" [
        "es:DeleteElasticsearchDomain",
        "es:DeleteDomain"
         ...

Nouveaux types de ressources

OpenSearch Service introduit les nouveaux types de ressources suivants :

Kibana renommé Tableaux de bord OpenSearch

Tableaux de bord OpenSearch, l'alternative AWS à Kibana, est un outil de visualisation open source conçu pour fonctionner avec OpenSearch. Après avoir mis à niveau un domaine d'Elasticsearch vers OpenSearch, le point de terminaison /_plugin/kibana sera remplacé par /_dashboards. OpenSearch Service redirigera toutes les demandes vers le nouveau point de terminaison, mais si vous utilisez le point de terminaison Kibana dans l'une des politiques IAM, mettez à jour ces politiques pour inclure également le nouveau point de terminaison /_dashboards.

Si vous utilisez Authentification SAML pour les tableaux de bord OpenSearch , avant de mettre à niveau votre domaine vers OpenSearch, vous devrez modifier toutes les URL Kibana configurées dans votre fournisseur d'identité (IdP) depuis /_plugin/kibana vers /_dashboards. Les URL les plus courantes sont les URL ACS (Assertion Consumer Service) et les URL des destinataires.

Le rôle par défaut kibana_read_only pour OpenSearch Dashboards a été renommé en opensearch_dashboards_read_only et le rôle kibana_user a été renommé en opensearch_dashboards_user. Ce changement s'applique à tous les domaines OpenSearch 1.x nouvellement créés et exécutant le logiciel de service R20211203 ou une version ultérieure. Si vous mettez à niveau un domaine existant vers le logiciel de service R20211203, les noms des rôles restent les mêmes.

Métriques CloudWatch renommées

Plusieurs métriques CloudWatch changent pour des domaines exécutant OpenSearch. Lorsque vous mettez à niveau un domaine vers OpenSearch, les métriques changent automatiquement et vos alarmes CloudWatch actuelles seront désactivées. Avant de mettre à niveau votre cluster d'une version Elasticsearch vers une version OpenSearch, veillez à mettre à jour vos alarmes CloudWatch afin de pouvoir utiliser les nouvelles métriques.

Les métriques suivantes ont été modifiées :

Pour obtenir la liste complète des métriques envoyées par OpenSearch Service à Amazon CloudWatch, consultez Surveillance des métriques OpenSearch du cluster avec Amazon CloudWatch.

Modifications apportées à la console Billing and Cost Management

Les données historiques contenues dans la console Facturation et gestion des coûts et dans les Rapports d'utilisation et de coût continueront d'utiliser l'ancien nom de service, vous devrez donc commencer à utiliser des filtres pour Amazon OpenSearch Service et pour l'ancien nom Elasticsearch lorsque vous rechercherez des données. Si vous avez déjà enregistré des rapports, mettez les filtres à jour afin de vous assurer qu'ils incluent également OpenSearch Service. Il se peut que vous receviez initialement une alerte lorsque votre utilisation d'Elasticsearch diminuera au profit d'OpenSearch, mais celle-ci disparaîtra après quelques jours.

En plus du nom du service, les champs suivants seront modifiés pour toutes les opérations d'API de rapports, de factures et de tarification :

Nouveau format d'événement

Le format des événements envoyés par OpenSearch Service à Amazon EventBridge et Amazon CloudWatch a changé, plus particulièrement le champ detail-type. Le champ source (aws.es) reste le même. Pour connaître le format complet de chaque type d'événement, consultez Surveillance des événements OpenSearch liés au service avec Amazon EventBridge. Si vous disposez de règles d'événements qui dépendent de l'ancien format, veillez à les mettre à jour pour qu'elles soient conformes au nouveau format.

Qu'est-ce qui demeure identique ?

Les fonctions et fonctionnalités suivantes, ainsi que d'autres non répertoriées ici, demeureront identiques :

Mise en route : mettez à niveau vos domaines vers OpenSearch 1.x

OpenSearch 1.x prend en charge les mises à niveau à partir d'Elasticsearch versions 6.8 et 7.x. Pour obtenir des instructions sur la mise à niveau de votre domaine, consultez Démarrage d'une mise à niveau (console). Si vous utilisez la AWS CLI ou l'API de configuration pour mettre à niveau votre domaine, vous devez indiquer la TargetVersion « OpenSearch_1.x ».

OpenSearch 1.x introduit un paramètre de domaine supplémentaire appelé Enable compatibility mode (Activer le mode compatibilité). Étant donné que certains clients et plugins Elasticsearch OSS vérifient la version du cluster avant de se connecter, le mode de compatibilité définit OpenSearch pour indiquer la version 7.10 afin que ces clients continuent de fonctionner.

Vous pouvez activer le mode de compatibilité lorsque vous créez des domaines OpenSearch pour la première fois ou lorsque vous effectuez une mise à niveau vers OpenSearch à partir d'une version Elasticsearch. S'il n'est pas défini, le paramètre sera défini par défaut sur false lorsque vous créerez un domaine, et sur true lorsque vous mettrez un domaine à niveau.

Pour activer le mode de compatibilité à l'aide de l'API de configuration, définissez override_main_response_version sur true :

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain
{
  "DomainName": "domain-name",
  "TargetVersion": "OpenSearch_1.0",
  "AdvancedOptions": {
    "override_main_response_version": "true"
   }
}

Pour activer ou désactiver le mode de compatibilité sur des domaines OpenSearch existants, vous devrez utiliser l'opération d'API OpenSearch _cluster/settings :

PUT /_cluster/settings
{
  "persistent" : {
    "compatibility.override_main_response_version" : true
  }
}