¿Cómo cambio el modo de clúster de mi clúster de ElastiCache para Valkey o ElastiCache para Redis OSS?

Descripción breve

Nota: Solo puedes cambiar la configuración del modo de clúster de deshabilitado a habilitado. Después de realizar este cambio en el modo de clúster, no podrás revertir la configuración.

Requisitos previos:

• El clúster solo debe tener claves en la base de datos 0.
• Las aplicaciones deben usar un cliente de Valkey o Redis OSS que pueda usar el protocolo de clúster y un punto de enlace de configuración.
• Para el clúster, debes activar la conmutación por error automática y tener al menos 1 réplica.
• Para la migración, el clúster debe tener una versión de motor de Valkey 7.2 y posterior o Redis OSS 7.0 y posterior. Para obtener más información, consulta Modificación del modo de clúster.

Para actualizar el modo de clúster de deshabilitado a habilitado, realiza las siguientes tareas:

1. Actualiza el modo de clúster de deshabilitado a Compatible.
2. Actualiza el modo de clúster de compatible a modo de clúster habilitado.

Nota: Durante este proceso de migración, el clúster permanece disponible.

Resolución

Antes de pasar al modo compatible, debes establecer el parámetro cluster-enabled en sí. Si usas un grupo de parámetros predeterminado, ElastiCache para Valkey y ElastiCache para Redis OSS eligen el grupo de parámetros predeterminado. Este grupo de parámetros predeterminado tiene la configuración cluster-enabled establecida en sí y no es necesario realizar ninguna acción.

Nota: Si usas un grupo de parámetros personalizado, elige un nuevo grupo de parámetros cuando modifiques el clúster. O bien, crea un nuevo grupo de parámetros para la misma familia de motores con el parámetro cluster-enabled establecido en sí.

Actualización del modo de clúster de deshabilitado a compatible

Nota: Si se muestran errores al ejecutar comandos de la Interfaz de la línea de comandos de AWS (AWS CLI), consulta Solución de problemas de AWS CLI. Además, asegúrate de utilizar la versión más reciente de la AWS CLI.

En el modo compatible, ElastiCache despliega una única partición para trabajar con el nodo. Con esta configuración, la aplicación cliente puede usar cualquiera de los protocolos para comunicarse con el clúster.

Sigue estos pasos:

1. Abre la consola de ElastiCache.
2. En el panel de navegación, elige el tipo de recurso y, a continuación, selecciona tu clúster.
3. Selecciona Modificar.
4. En Modo de clúster, selecciona Compatible.
5. (Opcional) Elige un grupo de parámetros personalizado con el parámetro cluster-enabled establecido en sí.
   Nota: Si utilizas un grupo de parámetros predeterminado, no es necesario realizar ninguna acción.
6. Selecciona Vista previa de los cambios y, a continuación, selecciona Guardar cambios.

Para usar la AWS CLI para modificar el clúster, ejecuta el comando modify-replication-group y actualiza el parámetro cluster-mode para que sea compatible.

Ejemplo:

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode compatible  \
    --apply-immediately

Nota: En el ejemplo anterior, sustituye test-cluster por el nombre de tu clúster. Para obtener más información, consulta Modificación de un grupo de replicación.

Cuando el modo de clúster cambie a Compatible, puedes usar el punto de enlace de configuración recién creado para probar la conectividad habilitada para el modo de clúster desde la aplicación. También puedes usar los puntos de enlace principales y de lectura para dar servicio a la conectividad deshabilitada del modo de clúster existente para el clúster.

Desde el modo compatible, también puedes volver al modo de clúster deshabilitado y conservar las configuraciones originales.

Actualización del modo de clúster de compatible a modo de clúster habilitado

Después de migrar todos los clientes de Valkey o Redis OSS al modo de clúster habilitado, la aplicación cliente pasa a ser con reconocimiento de clúster. A partir de este estado, puedes establecer el parámetro del modo de clúster como habilitado.

Sigue estos pasos:

1. Abre la consola de ElastiCache.
2. En el panel de navegación, elige el tipo de recurso y, a continuación, selecciona tu clúster.
3. Selecciona Modificar.
4. En Modo de clúster, elige Habilitado.
5. Selecciona Vista previa de los cambios y, a continuación, selecciona Guardar cambios.

Para usar la AWS CLI para modificar el clúster, ejecuta el comando modify-replication-group y actualiza el parámetro cluster-mode para que esté habilitado.

Ejemplo:

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode enabled  \
    --apply-immediately

Nota: En el ejemplo anterior, sustituye test-cluster por el nombre de tu clúster.

Una vez finalizados los cambios en el modo de clúster, los puntos de enlace del clúster también cambian. Como ya no hay un punto de enlace principal o de lector, asegúrate de actualizar las aplicaciones con el nuevo punto de enlace de configuración.

Nota: Se recomienda revisar la documentación de tu cliente para configurarlo de modo que admita la interacción con un clúster (modo de clúster habilitado). Para obtener más información, consulta la especificación del clúster en el sitio web de Valkey.

Información relacionada

Replicación: modo de clúster de Valkey y Redis OSS deshabilitado frente a habilitado

Prácticas recomendadas: clientes de Redis y Amazon ElastiCache para Redis