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.

Tutoriel : Migration vers AmazonOpenSearchService

Les instantanés d'index constituent un moyen courant de migrer depuis un système autogéréOpenSearchou un ancien cluster Elasticsearch vers AmazonOpenSearchUn service. Voici les grandes étapes de ce processus :

Cette démonstration fournit des étapes plus détaillées et d'autres options, le cas échéant.

Création et chargement de l'instantané

Bien que vous puissiez utiliser le plugin repository-s3 pour créer des instantanés directement sur S3, vous devez l'installer sur chaque nœud, modifier opensearch.yml (ou elasticsearch.yml si vous utilisez un cluster Elasticsearch), redémarrer chaque nœud et ajouter vos informations d'identification AWS avant de pouvoir créer l'instantané. Le plug-in est une excellente option pour une utilisation continue ou pour la migration de clusters plus volumineux.

Pour les clusters de petite taille, une approche ponctuelle consiste à créer un instantané du système de fichiers partagé puis à utiliser l'AWS CLI pour le charger sur S3. Si vous avez déjà créé l'instantané, passez directement à l'étape 4.

Création d'un domaine

Bien que la console soit le moyen le plus simple de créer un domaine, dans ce cas, le terminal est déjà ouvert et l'AWS CLI est déjà installée. Modifiez la commande suivante pour créer un domaine qui correspond à vos besoins :

aws opensearch create-domain \
  --domain-name migration-domain \
  --engine-version OpenSearch_1.0 \
  --cluster-config InstanceType=c5.large.search,InstanceCount=2 \
  --ebs-options EBSEnabled=true,VolumeType=gp2,VolumeSize=100 \
  --node-to-node-encryption-options Enabled=true \
  --encryption-at-rest-options Enabled=true \
  --domain-endpoint-options EnforceHTTPS=true,TLSSecurityPolicy=Policy-Min-TLS-1-2-2019-07 \
  --advanced-security-options Enabled=true,InternalUserDatabaseEnabled=true,MasterUserOptions='{MasterUserName=master-user,MasterUserPassword=master-user-password}' \
  --access-policies '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":["*"]},"Action":["es:ESHttp*"],"Resource":"arn:aws:es:us-west-2:123456789012:domain/migration-domain/*"}]}' \
  --region us-west-2

En l'état, la commande crée un domaine accessible à Internet avec deux nœuds de données, chacun avec 100 Gio de stockage. Il permet également un contrôle d'accès précis avec l'authentification de base HTTP et tous les paramètres de chiffrement. Utilisez leOpenSearchConsole de service si vous avez besoin d'une configuration de sécurité plus avancée, telle qu'un VPC.

Avant d'exécuter la commande, modifiez le nom de domaine, les informations d'identification de l'utilisateur principal et le numéro de compte. Spécifiez la même choseRégion AWSque vous avez utilisé pour le compartiment S3 et unOpenSearch/Version d'Elasticsearch compatible avec votre instantané.

Accordez des autorisations d'accès au compartiment S3.

Dans la console AWS Identity and Access Management (IAM), créez un rôle avec les autorisations et la relation d'approbation suivantes. Lors de la création du rôle, choisissez S3 en tant que Service AWS. Nommez le rôle OpenSearchSnapshotRole pour qu'il soit facile à identifier.

Autorisations

{
  "Version": "2012-10-17",
  "Statement": [{
      "Action": [
        "s3:ListBucket"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:s3:::bucket-name"
      ]
    },
    {
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:s3:::bucket-name/*"
      ]
    }
  ]
}

Relation d'approbation

{
  "Version": "2012-10-17",
  "Statement": [{
      "Effect": "Allow",
      "Principal": {
        "Service": "es.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Ensuite, accordez à votre rôle IAM personnel les autorisations de prendre en charge OpenSearchSnapshotRole. Créez la stratégie suivante et attachez-la à votre identité :

Autorisations

{
  "Version": "2012-10-17",
  "Statement": [{
      "Effect": "Allow",
      "Action": "iam:PassRole",
      "Resource": "arn:aws:iam::123456789012:role/OpenSearchSnapshotRole"
    }
  ]
}

Mappez le rôle du snapshot dansOpenSearchTableaux de bord (si vous utilisez un contrôle d'accès détaillé)

Si vous avez activé le contrôle d'accès précis, même si vous utilisez l'authentification de base HTTP à toutes les autres fins, vous devez mapper le rôle manage_snapshots à votre rôle IAM afin d'utiliser des instantanés.

Restaurer l'instantané.

À ce stade, vous pouvez accéder à votreOpenSearchDomaine de service : authentification de base HTTP avec vos informations d'identification d'utilisateur principal ouAWSauthentification à l'aide de vos informations d'identification IAM. Étant donné que les instantanés utilisent Amazon S3, qui ne définit pas l'utilisateur principal, vous devez utiliser vos informations d'identification IAM pour enregistrer le référentiel d'instantanés auprès de votreOpenSearchDomaine du service.

La plupart des langages de programmation disposent de bibliothèques pour faciliter les demandes de signature, mais l'approche la plus simple consiste à utiliser un outil tel quepostieret saisissez vos informations d'identification IAM dansAutorisationsection.

À ce stade, la migration est terminée. Vous pouvez configurer vos clients pour qu'ils utilisent le nouveauOpenSearchPoint de terminaison du service,redimensionner le domaineen fonction de votre charge de travail, vérifiez le nombre de partitions pour vos index, passez à unUtilisateur principal IAM, ou commencez à créer des visualisations dansOpenSearchTableaux de bord.