View a markdown version of this page

Actualización de Amazon OpenSearch Dominios de servicio - 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.

Actualización de Amazon OpenSearch Dominios de servicio

nota

OpenSearch y las actualizaciones de versión de Elasticsearch difieren de las actualizaciones de software de servicio. Para obtener información sobre cómo actualizar el software de servicio para su OpenSearch Dominio de servicio, consulte Actualizaciones de software de servicio en Amazon OpenSearch Service.

Amazon OpenSearch El servicio ofrece dos formas de actualizar un dominio: una actualización local y una actualización basada en clones. Si utilizas servicios como Amazon Data Firehose o Amazon CloudWatch Registros a los que transmitir datos OpenSearch Servicio, compruebe que estos servicios son compatibles con la versión más reciente de OpenSearch antes de migrar.

Métodos y términos de actualización

¿Un actualización in situ actualiza el clúster existente de su dominio a la nueva versión. Se ejecuta como blue/green despliegue. No puedes pausar, cancelar ni deshacer una actualización existente. Está disponible para los dominios que se ejecutan OpenSearch 1.0 o posterior, o Elasticsearch 5.1 o posterior.

A actualización basada en clones crea un clúster clonado de su dominio en la versión de destino y lo mantiene sincronizado con sus datos mientras su dominio sigue atendiendo el tráfico del clúster principal. Es un blue/green implementación en la que el clúster clonado es el entorno ecológico, mantenido aislado para que pueda validarlo antes de pasar a otro. Usted valida el clúster clonado y, a continuación, pasa a él cuando esté listo. Puedes cancelar antes de la transición y revertirla después. Hay disponible una actualización basada en clones para los dominios que ejecutan Elasticsearch 7.10 o OpenSearch 1.1 o versiones posteriores en total AWS Regiones comerciales en las que se encuentra Amazon OpenSearch El servicio está disponible, excepto Asia Pacífico (Nueva Zelanda), Asia Pacífico (Taipéi), Asia Pacífico (Tailandia) y México (Central). Para obtener una lista completa de las regiones, consulte el AWS Tabla de regiones.

Los siguientes términos describen una actualización basada en clones.

Clúster principal

El clúster en el que se ejecuta su dominio cuando se inicia la actualización, en la versión anterior. Sigue atendiendo el tráfico hasta que te quedes sin tráfico. Tras la transición, OpenSearch El servicio lo conserva solo durante el período de retención que hayas establecido, para que puedas revertirlo.

Clúster clonado

El nuevo clúster que OpenSearch El servicio se crea en la versión de destino. Recibe una copia de sus datos y permanece sincronizado con el clúster principal.

Valide

Pruebe el clúster clonado con sus propias solicitudes de lectura antes de cambiarlo. Solo puede validar las lecturas.

Transición

El paso que mueve el tráfico de tu dominio del clúster principal al clúster clonado. Las escrituras se bloquean durante la transición.

Cancelación

Detenga la actualización antes de la transición. OpenSearch El servicio elimina el clúster clonado y el dominio permanece como estaba.

Revertir

Regrese al clúster principal después de la transición, durante el período de retención.

Periodo de retención

¿Cuánto tiempo OpenSearch El servicio conserva el clúster principal después de la transición para que puedas revertirlo. El período comienza cuando finaliza la transición. Si no estableces un período de retención, OpenSearch El servicio elimina el clúster principal inmediatamente después de la transición.

Elija un método de actualización

En la tabla siguiente se comparan los dos tipos de actualización.

In-place mejorar Clone-based mejorar
Cómo funciona Actualiza el clúster existente. Se ejecuta como blue/green despliegue. UN blue/green implementación en la que el clúster clonado es el entorno ecológico. Se crea en la versión de destino, se mantiene sincronizado con sus datos y se mantiene aislado para que pueda validarlo. Tú decides cuándo cortar.
Disponible para OpenSearch 1.0 o posterior, o Elasticsearch 5.1 o posterior. Elasticsearch 7.10 o OpenSearch 1.1 o posterior.
Pruebe la versión actualizada antes de que entre en vigor No. Se ejecutan las comprobaciones previas a la actualización, pero el clúster actualizado toma el control en cuanto finaliza la actualización. Sí. Prueba el clúster clonado con tus propias solicitudes mientras tu dominio sigue atendiendo el tráfico.
Cancela una actualización No. Sí. Puedes cancelar en cualquier momento antes de la transición.
Retroceder No. Para volver a la versión anterior, restaure una instantánea en un dominio nuevo. Sí. Tras la transición, puedes revertirla durante el período de retención que hayas establecido.
Escribe durante la actualización El rendimiento de escritura puede degradarse durante la actualización. Las escrituras en el clúster principal no se ven afectadas mientras se ejecuta la actualización. Las escrituras se bloquean hasta que se complete la transición.

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

Antes de la actualización

Antes de iniciar cualquier tipo de actualización:

  1. Tome una instantánea manual de su dominio. Esta instantánea sirve como copia de seguridad de la que puede restaurar en un dominio nuevo si desea volver a utilizar el anterior OpenSearch versión.

  2. Compruebe Rutas de actualización admitidas para sus versiones actuales y de destino. La actualización basada en clones solo está disponible para los dominios que ejecutan Elasticsearch 7.10 o OpenSearch 1.1 o posterior.

  3. Ejecute la comprobación previa a la actualización para encontrar problemas que puedan bloquear la actualización. Se realizan las mismas comprobaciones para ambos tipos de actualización. Para obtener más información, consulte Solución de errores de validación.

  4. Si sus dominios utilizan la recuperación ante desastres gestionada, actualice primero el dominio secundario y, al final, el dominio principal. Antes de realizar una actualización basada en clones, elimine la relación de replicación. Para obtener más información, consulte Actualice los dominios que usan DR.

Rutas de actualización admitidas

En la actualidad, OpenSearch El servicio admite las siguientes rutas de actualización:

Todas las rutas de la tabla siguiente están disponibles para una actualización local.

Desde la versión Hasta la versión
OpenSearch 1.3, 2.x, o 3.x

OpenSearch 3.x

Si estás corriendo OpenSearch 1.3 o 2.x, primero debe actualizar a OpenSearch 2.19 delante de actualizar a OpenSearch 3.x.

Al actualizar desde OpenSearch 2.19 a OpenSearch 3.x, es posible que deba corregir las siguientes configuraciones de índice incompatibles. Quedaron en desuso a principios de la versión 2.x y, si no se eliminan, provocarán un error en la validación de la comprobación de la actualización.

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

Para obtener más información sobre la configuración de índice obsoleta y los pasos para corregirla, consulte Configuración de índices. Para obtener una lista completa de los cambios más importantes para OpenSearch 3.x, consulte 3.0.0.

Si su dominio contiene índices creados en OpenSearch 1.3, Elasticsearch 7.10 o versiones anteriores, debes volver a indexarlos antes de actualizar a OpenSearch 3.x. OpenSearch 3.x no admite estos índices antiguos, independientemente de si están en auge, UltraWarm, o almacenamiento en frío. Para volver a indexar, no es compatible UltraWarm Para índices fríos:

  1. Migre los índices al almacenamiento en caliente.

  2. Vuelva a indexar los datos.

  3. Vuelva a migrar los índices a un almacenamiento en frío o caliente.

También puede eliminar los índices si ya no los necesita.

Instantáneas tomadas OpenSearch 1.x y en Elasticsearch 7.10 y versiones anteriores son incompatibles con OpenSearch 3.x.

En el caso de los repositorios de instantáneas manuales, elimine estas instantáneas incompatibles antes de actualizar a OpenSearch 3.x.

OpenSearch 1.3 o 2.x

OpenSearch 2.x

OpenSearch 2.17 habilitará la búsqueda simultánea de segmentos de forma predeterminada con el modo automático si el dominio cumple las siguientes condiciones:

  • No se ha establecido explícitamente ninguna configuración de búsqueda simultánea previa.

  • Todas las instancias de datos (activas y calientes) son del tipo de instancia .2xl o superior.

  • El uso medio de la CPU p90 en las instancias de datos (calientes y cálidos) durante más de una semana es inferior al 45 %.

    Para obtener más información sobre la configuración de búsqueda de segmentos simultáneos aquí, consulte Búsqueda de segmentos simultáneos.

El control de versiones 2.3 incluye los siguientes cambios importantes:

  • El type el parámetro se eliminó de todos OpenSearch puntos finales de API en la versión 2.0. Para más información, consulte Cambios bruscos.

  • Si tu dominio contiene algún índice (activo, UltraWarm, o en frío) que se crearon originalmente en Elasticsearch 6.8, esos índices no son compatibles con OpenSearch 2.3.

    Antes de actualizar a la versión 2.3, debe volver a indexar los índices incompatibles. Por incompatible UltraWarm o índices fríos, míralos a un almacenamiento activo, vuelve a indexar los datos y, a continuación, vuelve a migrarlos a un almacenamiento frío o caliente. También puede quitar índices si ya no los necesita.

    Si actualiza accidentalmente su dominio al control de versiones 2.3 sin realizar primero estos pasos, no podrá migrar los índices incompatibles fuera de su nivel de almacenamiento actual. La única opción es eliminarlos.

OpenSearch 1.x OpenSearch 1.x
Elasticsearch 7.x

Elasticsearch 7.x o OpenSearch 1.x

importante

OpenSearch 1.x introduce numerosos cambios importantes. Para obtener más información, consulte Cambio OpenSearch de nombre de Amazon Service: resumen de los cambios.

Elasticsearch 6.8

Elasticsearch 7.x o OpenSearch 1.x

importante

Elasticsearch 7.0 y OpenSearch La versión 1.0 incluye numerosos cambios importantes. Antes de iniciar una actualización local, recomendamos tomar una instantánea manual de los 6.x dominio, restaurándolo en una prueba 7.x o OpenSearch 1.x dominio y usar ese dominio de prueba para identificar posibles problemas de actualización. Para cambios importantes en OpenSearch 1.0, consulte Cambio OpenSearch de nombre de Amazon Service: resumen de los cambios.

Al igual que Elasticsearch 6.x, los índices solo pueden contener un tipo de mapeo, pero ese tipo debe denominarse _doc. Como resultado, determinadas API ya no requieren un tipo de mapeo en el cuerpo de la solicitud (como, por ejemplo, la API _bulk).

Para índices nuevos, Elasticsearch 7 autohospedado.x y OpenSearch 1.x tienen un recuento de fragmentos predeterminado de uno. OpenSearch Dominios de servicio en Elasticsearch 7.x y luego conservar el valor predeterminado anterior de cinco.

Elasticsearch 6.x

Elasticsearch 6.x

Elasticsearch 5.6

Elasticsearch 6.x

importante

Los índices creados en la versión 6.x ya no admiten varios tipos de mapeo. Los índices creados en la versión 5.x siguen admitiendo varios tipos de mapeo cuando se restauran en un clúster 6.x. Compruebe que el código de cliente solo cree un único tipo de mapeo por índice.

Para minimizar el tiempo de inactividad durante la actualización de Elasticsearch 5.6 a 6.x, OpenSearch El servicio vuelve a indexar el .kibana indexar a .kibana-6, elimina .kibana, crea un alias denominado .kibana, y asigna el nuevo índice al nuevo alias.

Elasticsearch 5.x Elasticsearch 5.x

Hay disponible una actualización basada en clones para las siguientes rutas de actualización:

  • Elasticsearch 7.10 a OpenSearch 1.3

  • OpenSearch 1.1 a 1.3

  • OpenSearch 1.3 a 2.19

  • OpenSearch 2.x a 2.19

  • OpenSearch 2.19 a 3.x

Para otras rutas de actualización, utilice una actualización local.

Cómo funciona una actualización local

Una actualización local consta de tres pasos:

  1. Pre-upgrade cheques — OpenSearch El servicio comprueba si hay problemas que puedan bloquear una actualización y no pasa al siguiente paso a menos que estas comprobaciones se realicen correctamente.

  2. Captura instantánea — OpenSearch El servicio toma una instantánea del OpenSearch o del clúster de Elasticsearch y no pasa al siguiente paso a menos que la instantánea se realice correctamente. Si la actualización falla, OpenSearch El servicio usa esta instantánea para restaurar el clúster a su estado original. Para obtener más información, consulte No se puede cambiar a una versión anterior después de una actualización.

  3. Actualizar — OpenSearch El servicio inicia la actualización, que puede tardar entre 15 minutos y varias horas en completarse. OpenSearch Es posible que los paneles no estén disponibles durante una parte o la totalidad de la actualización.

Cómo funciona una actualización basada en clones

Una actualización basada en clones consta de los siguientes pasos:

  1. Pre-upgrade cheques — OpenSearch El servicio realiza las mismas comprobaciones que en una actualización local y no continúa a menos que se realice correctamente.

  2. Captura instantánea — OpenSearch El servicio toma una instantánea de su dominio y no continúa a menos que la instantánea se realice correctamente.

  3. Creación de clústeres clonados — OpenSearch El servicio crea un clúster clonado de su dominio en la versión de destino y copia sus datos en él. Tu dominio sigue ofreciendo lecturas y escrituras desde el clúster principal, y el clúster clonado permanece sincronizado con tus datos.

  4. Validación — Cuando el clúster clonado esté listo, la actualización lo esperará. Valide el clúster clonado y, si lo desea, envíele una parte del tráfico de lectura.

  5. Traspaso — Cuando cortas, OpenSearch El servicio bloquea las escrituras hasta que se complete la transición. Durante ese tiempo, el clúster clonado se pone al día y, a continuación OpenSearch El servicio mueve el tráfico hacia él. El punto final de tu dominio no cambia.

  6. Período de retención (opcional) — OpenSearch El servicio conserva el clúster principal durante el período de retención que hayas establecido, para que puedas revertirlo. El período comienza cuando se completa la transición. Si no estableces un período de retención, OpenSearch El servicio elimina el clúster principal inmediatamente después de la transición.

Puede cancelar la actualización en cualquier momento antes de la transición. OpenSearch A continuación, el servicio elimina el clúster clonado y el dominio permanece como estaba. Para obtener información sobre cómo validar, cortar, cancelar y deshacer, consulte Validar, cortar y deshacer durante una actualización basada en clones.

Limitaciones de una actualización basada en clones

Una actualización basada en clones tiene las siguientes limitaciones:

  • Su dominio debe ejecutar Elasticsearch 7.10 o OpenSearch 1.1 o una versión posterior. Si tu dominio tiene una versión anterior, utiliza primero una actualización local para llegar primero a una versión compatible.

  • Dominios que utilizan OpenSearch No se admiten las instancias optimizadas (OR1 u OR2).

  • Dominios que usan UltraWarm las instancias no son compatibles.

  • No se admiten los dominios que utilizan la replicación entre clústeres.

  • Si su dominio usa la recuperación ante desastres administrada, elimine la relación de replicación antes de iniciar una actualización basada en clones y vuelva a configurar la recuperación ante desastres después. Para obtener más información, consulte Actualice los dominios que usan DR.

  • No se admiten los dominios con paquetes de complementos personalizados o de terceros asociados.

  • Dominios que utilizan la autenticación SAML para OpenSearch Los paneles no son compatibles.

  • Dominios que utilizan la autenticación de Amazon Cognito para OpenSearch Los paneles no son compatibles.

  • No puede cambiar la configuración del dominio durante la actualización.

Cargos por las actualizaciones

Una mejora in situ no conlleva cargos adicionales. En el caso de una actualización basada en clones, se aplicará el precio estándar a las instancias y el almacenamiento del clon, al igual que a cualquier otro nodo de tu dominio. Mientras validas el clon, se te cobrará tanto por el clúster principal como por el clon. Si te quedas con el clúster principal para revertirlo, se te cobrará por ambos hasta que finalice el período de retención.

Solución de errores de validación

Cuando inicias un OpenSearch o una actualización de la versión de Elasticsearch, OpenSearch El servicio primero realiza una serie de comprobaciones de validación para asegurarse de que su dominio cumple los requisitos para una actualización. Si se produce un error en alguna de estas comprobaciones, recibirá una notificación con los problemas específicos que debe corregir antes de actualizar su dominio. Para obtener una lista de posibles problemas y los pasos para resolverlos, consulte Solución de errores de validación.

Solución de problemas de una actualización

Las actualizaciones requieren dominios en buen estado. Es posible que su dominio no pueda optar por una actualización o que no se actualice por diversas razones. La siguiente tabla muestra los problemas más comunes.

Problema Description (Descripción)
No se admite el complemento opcional

Cuando actualizas un dominio con complementos opcionales, OpenSearch El servicio también actualiza automáticamente los complementos. Por lo tanto, la versión de destino de su dominio también debe admitir estos complementos opcionales. Si el dominio tiene instalado un complemento opcional que no está disponible para la versión de destino, se produce un error en la solicitud de actualización.

Demasiadas particiones por nodo OpenSearch, así como 7.x las versiones de Elasticsearch tienen una configuración predeterminada de no más de 1000 fragmentos por nodo. Si un nodo de tu clúster actual supera esta configuración, OpenSearch El servicio no te permite realizar la actualización. Consulte Límite máximo de fragmentos superado para obtener opciones de solución de problemas.
Dominio en procesamiento El dominio está en medio de un cambio de configuración. Compruebe si es posible optar a la actualización una vez que se complete la operación.
Estado rojo del clúster Uno o varios índices en el clúster aparecen en rojo. Para ver los pasos de solución de problemas, consulte Estado rojo del clúster.
Tasa de errores alta El clúster devuelve un gran número de errores 5xx al intentar procesar solicitudes. Este problema suele ser el resultado de demasiadas solicitudes de lectura o escritura simultáneas. Considere la posibilidad de reducir el tráfico hacia el clúster o el escalado del dominio.
Cerebro dividido Cerebro dividido significa que el clúster tiene más de un nodo maestro y se ha dividido en dos clústeres que nunca se volverán a unir por sí mismos. Puede evitar un cerebro dividido con el número recomendado de nodos maestros dedicados. Para obtener ayuda a fin de recuperar un cerebro dividido, póngase en contacto con Soporte.
Nodo maestro no encontrado OpenSearch El servicio no puede encontrar el nodo principal del clúster. Si el dominio utiliza Multi-AZ, es posible que un error de una zona de disponibilidad haya hecho que el clúster pierda el quorum y no pueda elegir un nuevo nodo maestro. Si el problema no se resuelve por sí solo, póngase en contacto con Soporte.
Demasiadas tareas pendientes El nodo maestro está bajo una gran carga y tiene muchas tareas pendientes. Considere la posibilidad de reducir el tráfico hacia el clúster o el escalado del dominio.
Volumen de almacenamiento dañado El volumen de disco de uno o más nodos no funciona correctamente. Este problema a menudo ocurre junto con otros problemas, como una alta tasa de error o demasiadas tareas pendientes. Si se produce aisladamente y no se resuelve por sí solo, póngase en contacto con Soporte.
Problema de clave de KMS La clave de KMS que se utiliza para cifrar el dominio está inaccesible o no está. Para más información, consulte Monitorear dominios que cifran los datos en reposo.
Snapshot en proceso de creación El dominio está tomando una instantánea en este momento. Compruebe si es posible optar a la actualización una vez que se complete la instantánea. Compruebe también si puede hacer una lista de los repositorios de instantáneas manuales, una lista de instantáneas dentro de dichos repositorios y tomar instantáneas manuales. Si OpenSearch El servicio no puede comprobar si hay una instantánea en curso, las actualizaciones pueden fallar.
Error en instantánea o tiempo de espera agotado La instantánea previa a la actualización ha tardado demasiado tiempo en completarse o ha generado un error. Compruebe el estado del clúster y vuelva a intentarlo. Si el problema sigue sin resolverse, póngase en contacto con Soporte.
Índices incompatibles Uno o varios índices son incompatibles con la versión de destino. Este problema puede producirse si migró los índices desde una versión anterior de OpenSearch o Elasticsearch. Reindexe los índices e inténtelo de nuevo.
Alto uso del disco El uso del disco para el clúster es superior al 90 %. Elimine los datos o escale el dominio, e inténtelo de nuevo.
Alto uso de JVM La presión de memoria de JVM es superior al 75 %. Reduzca el tráfico hacia el clúster o amplíe el dominio, e inténtelo de nuevo.
OpenSearch Problema con el alias de los paneles .dashboards ya está configurado como alias y se asigna a un índice incompatible, probablemente uno de una versión anterior de OpenSearch Paneles. Reindexe e inténtelo de nuevo.
Estado rojo de Dashboards OpenSearch El estado de los paneles es rojo. Intente utilizar Dashboards cuando se complete la actualización. Si el estado rojo persiste, resuélvalo manualmente, e inténtelo de nuevo.
Cross-cluster compatibilidad

Solo puede actualizar si se mantiene la compatibilidad entre clústeres entre los dominios de origen y destino después de la actualización. Durante el proceso de actualización, se identifican las conexiones incompatibles. Para continuar, actualice el dominio remoto o elimine las conexiones incompatibles. Tenga en cuenta que si la replicación está activa en el dominio, no podrá reanudarla una vez que elimine la conexión.

Otros OpenSearch Problema de servicio Problemas con OpenSearch El propio servicio puede hacer que tu dominio aparezca como no apto para una actualización. Si a su dominio no se aplica ninguna de las condiciones anteriores y el problema persiste durante más de un día, póngase en contacto con Soporte.