View a markdown version of this page

Validar, cortar y deshacer durante una actualización basada en clones - Amazon OpenSearch Servicio

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.

Validar, cortar y deshacer durante una actualización basada en clones

Tras iniciar una actualización basada en clones, OpenSearch El servicio crea un clúster clonado de su dominio y copia sus datos en él. Cuando el clúster clonado esté listo, la actualización lo esperará. En esta página se explica cómo validar el clúster clonado, cambiarlo, cancelar la actualización y revertirlo. Para obtener información sobre las solicitudes que realizan cada acción, consulte Actualización de un dominio (CLI) y Actualización de un dominio (SDK).

Monitorear el progreso

Para realizar un seguimiento de una actualización basada en clones, llame DescribeDomainChangeProgress. La respuesta enumera las siguientes etapas. Las etapas se refieren al clúster clonado como nuevo entorno y al clúster principal como entorno antiguo.

Etapa Qué significa
Inicializando OpenSearch El servicio inicializa la actualización.
Validación OpenSearch El servicio comprueba que tu dominio cumple los requisitos para la actualización.
Creación de un nuevo entorno OpenSearch El servicio crea el clúster clonado.
Provisión de nuevos nodos OpenSearch El servicio crea los nodos del clúster clonado.
Replicación de los datos OpenSearch El servicio replica sus datos en el clúster clonado.
Validación de la aplicación del cliente El clúster clonado está listo. Tras la preparación, pruebe la aplicación en la nueva versión antes de decidir si desea cambiarla. La actualización le espera.
Cambio de tráfico OpenSearch El servicio envía la parte del tráfico de lectura que usted eligió al clúster clonado.
Cut-over al nuevo entorno OpenSearch El servicio pasa al clúster clonado.
Actualización completa OpenSearch El servicio finaliza la actualización.
Eliminación de recursos más antiguos OpenSearch El servicio elimina los recursos asociados al entorno anterior.

Mientras el clúster clonado lo espera, ConfigChangeStatus es PendingUserInput. La respuesta también incluye TrafficSplit, que muestra la proporción del tráfico de lectura que va al clúster principal y al clúster clonado.

Valide el clúster clonado

Mientras la actualización esté en espera, su dominio seguirá distribuyendo el tráfico del clúster principal. Las escrituras siempre van al clúster principal, por lo que solo puedes validar las lecturas. Utilice cualquiera de los métodos siguientes.

Envíe una parte del tráfico de lectura al clúster clonado

Utilice UpdateClone con TrafficSplitOptions para enviar un porcentaje de solicitudes de lectura, de 0 a 100, al clúster clonado. El porcentaje se aplica a las solicitudes de búsqueda, como _search, _msearch, _count, y _mget. Otras solicitudes, incluidas todas las escrituras, van al clúster principal. Puedes cambiar el porcentaje tantas veces como quieras. Establézcalo en 0 para enviar todas las lecturas al clúster principal.

Utilice OpenSearch Paneles del clúster clonado

Si su dominio se ejecuta OpenSearch, abre el clúster clonado OpenSearch Tableros en https://my-domain-endpoint/_dashboards/clone. Para ejecutar las mismas consultas en el clúster principal, utilice la URL estándar de los paneles, https://my-domain-endpoint/_dashboards.

El clone La URL solo está disponible hasta que cortes. Tras la transición, el clúster clonado ocupa el lugar del clúster principal y se utiliza la URL estándar de los paneles.

Compara CloudWatch métricas

El clúster clonado publica las métricas en el mismo CloudWatch espacio de nombres como su dominio. Cada nombre de métrica comienza por Clone., por ejemplo Clone.CPUUtilization. Supervise estas métricas en CloudWatch para comparar el rendimiento de su carga de trabajo en el clúster principal (la versión anterior) y en el clúster clonado (la versión de destino) antes de tomar la decisión de realizar la transición. Para obtener una lista completa de métricas, consulte Clone-based actualizar métricas.

Pase al clúster clonado

Cuando esté satisfecho con el clúster clonado, recórtelo con UpdateClone y CutoverOptions establecido en ClonedCluster. OpenSearch A continuación, el servicio hace lo siguiente:

  1. Comprueba el estado de ambos clústeres. Si alguno de los clústeres tiene el estado rojo, OpenSearch El servicio rechaza la transición.

  2. Bloquea las escrituras en el clúster principal para que el clúster clonado pueda ponerse al día. Las lecturas permanecen disponibles.

  3. Espera a que el clúster clonado se ponga al día. Si el clúster clonado no se pone al día en 5 minutos, OpenSearch El servicio desbloquea las escrituras y se produce un error en la transición.

  4. Mueve el tráfico al clúster clonado. El punto final de tu dominio no cambia.

  5. Elimina el clúster principal inmediatamente o lo conserva durante el período de retención que hayas establecido.

importante

Las escrituras se bloquean hasta que se complete la transición. Se interrumpe durante un período de poco tráfico de escritura.

Cancele la actualización antes de la transición

Puedes cancelarla en cualquier momento antes de la finalización. Llama UpdateClone con CutoverOptions establecido en PrimaryCluster. OpenSearch El servicio elimina el clúster clonado y su dominio permanece como estaba. Un clúster con un estado rojo no bloquea una cancelación.

Periodo de retención

El período de retención es la duración OpenSearch El servicio conserva el clúster principal después de la transición para que puedas revertirlo. Si no estableces un período de retención, OpenSearch El servicio elimina el clúster principal inmediatamente después de la transición y la única forma de volver a la versión anterior es restaurar una instantánea en un dominio nuevo.

  • El período máximo de retención es de 336 horas (14 días). Para solicitar un período más largo, póngase en contacto con AWS Soporte.

  • Puede configurarlo al iniciar la actualización o en una llamada separada antes de la transición. El período cuenta a partir del momento en que se completa la transición.

  • Tras la transición, puede acortar o extender el período con RetentionInHours.

  • Para finalizar el período antes de tiempo, llame UpdateClone con RetentionAction. Usa RollbackToPrimaryCluster para volver al clúster principal y eliminar el clúster clonado. Utilice DeletePrimaryCluster para eliminar el clúster principal ahora.

Revertir

Durante el período de retención, puede volver al clúster principal. Llama UpdateClone con RetentionAction establecido en RollbackToPrimaryCluster. OpenSearch El servicio vuelve al clúster principal y elimina el clúster clonado.

aviso

Los datos escritos después de la transición se perderán

La reversión restaura el entorno antiguo conservado. Los datos escritos en el dominio después de la transferencia no estarán presentes a menos que los vuelva a reproducir manualmente.

Cargos

Para obtener información sobre los cargos, consulte Cargos por las actualizaciones.

Resolución de problemas

Problema Description (Descripción)
La creación de clústeres clonados falla La etapa que falló se muestra en DescribeDomainChangeProgress respuesta. El clúster principal no se ve afectado.
La copia de datos falla Si la copia al clúster clonado se detiene o falla, Replicating data la etapa falla. El clúster principal no se ve afectado.
Se rechaza la transición Uno de los clústeres tiene el estado rojo. Corrija los índices rojos e inténtelo de nuevo.
La transición falla después de bloquear las escrituras El clúster clonado no se puso al día en 5 minutos. OpenSearch El servicio desbloquea las escrituras automáticamente. Vuelva a intentarlo cuando el tráfico de escritura sea menor.