Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Tutorial: Migración a Amazon OpenSearch Service

Las instantáneas de índice son una forma popular de migrar desde un clúster de OpenSearch autoadministrado o Elasticsearch heredado a Amazon OpenSearch Service. En términos generales, el proceso consta de los siguientes pasos:

Este tutorial proporciona pasos más detallados y opciones alternativas, cuando corresponda.

Tomar y cargar la instantánea

Aunque puede utilizar el complemento repository-s3 para tomar instantáneas directamente a S3, tiene que instalar el complemento en cada nodo, ajustar opensearch.yml (o elasticsearch.yml si usa un clúster Elasticsearch), reiniciar cada nodo, agregar sus credenciales de AWS y, finalmente, tomar la instantánea. El complemento es una gran opción para uso continuo o para migrar clústeres más grandes.

En clústeres más pequeños, un enfoque único consiste en tomar una instantánea del sistema de archivos compartida y, luego, utilizar la AWS CLI para cargarla a S3. Si ya tiene una instantánea, vaya al paso 4.

Crear un dominio

Aunque la consola es la forma más fácil de crear un dominio, en este caso, ya tiene el terminal abierto y la AWS CLI instalada. Modifique el siguiente comando para crear un dominio que se ajuste a sus necesidades:

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

Tal como está, el comando crea un dominio accesible a Internet con dos nodos de datos, cada uno con 100 GiB de almacenamiento. También habilita el control de acceso detallado con autenticación básica HTTP y toda la configuración de cifrado. Utilice la consola de OpenSearch Service si necesita una configuración de seguridad más avanzada, como una VPC.

Antes de ejecutar el comando, cambie el nombre de dominio, las credenciales del usuario maestro y el número de cuenta. Especifique la misma Región de AWS que utilizó para el bucket de S3 y una versión de OpenSearch/Elasticsearch que sea compatible con la instantánea.

Conceda permisos al bucket de S3.

En la consola AWS Identity and Access Management (IAM), cree un rol con los siguientes permisos y relación de confianza. Al crear un rol, elija S3 como el Servicio de AWS. Asigne al rol el nombre OpenSearchSnapshotRole para que sea fácil de encontrar.

Permisos

{
  "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/*"
      ]
    }
  ]
}

Relación de confianza

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

Después, conceda permisos a su rol de IAM personal para asumir OpenSearchSnapshotRole. Cree la siguiente política y adjúntela a su identidad.

Permisos

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

Asigne el rol de instantánea en OpenSearch Dashboards (si utiliza el control de acceso detallado)

Si ha habilitado el control de acceso detallado, incluso si utiliza autenticación HTTP básica para todos los demás fines, debe asignar el rol manage_snapshots al rol de IAM para poder trabajar con instantáneas.

Restaurar la instantánea

En este punto, tiene dos formas de acceder a su dominio de OpenSearch Service: la autenticación básica HTTP con sus credenciales de usuario maestro o la autenticación de AWS con las credenciales de IAM. Dado que las instantáneas utilizan Amazon S3, que no tiene un concepto de usuario maestro, debe utilizar sus credenciales de IAM para registrar el repositorio de instantáneas en su dominio de OpenSearch Service.

La mayoría de los lenguajes de programación tienen bibliotecas para ayudar con las solicitudes de firma, pero el enfoque más simple es utilizar una herramienta como Postman y poner sus credenciales de IAM en la sección Autorización.

En este punto, la migración está completa. Puede configurar sus clientes para que utilicen el nuevo punto de conexión de OpenSearch Service, cambiar el tamaño del dominio para adaptarse a su carga de trabajo, comprobar el recuento de particiones de sus índices, cambiar a un usuario maestro de IAM o comenzar a crear visualizaciones en OpenSearch Dashboards.