// redis cluster & sentinel

Una GUI de Redis Cluster y Sentinel que alcanza cada nodo

Los clústeres viven detrás de bastiones, NAT y mapeos de puertos de Docker, y sus nodos anuncian direcciones a las que tu equipo no puede conectarse. Sentinel mueve el maestro cuando falla. SQLly enruta cada comando al nodo dueño de su ranura, reescribe las direcciones que no puede alcanzar, traza cada nodo paso a paso y sigue cada failover sin aplicar nunca una escritura dos veces.

Enrutamiento de slots que sigue al clúster

Enumera uno o más nodos semilla en el campo Server, separados por comas, o pega una redis:// URL con varios hosts. Modo clúster detecta un clúster en la primera conexión de una sesión, o puedes configurarlo para que enrute siempre o nunca por slot.

  • Cada comando, al dueño de su slot. Después de una conmutación por error o de un reshard, MOVED y ASK sigue las respuestas y actualiza el mapa de slots; el panel Mensajes indica cuántas redirecciones vio un script.
  • Cada herramienta en cada maestro. El explorador de claves recorre cada maestro uno a uno, el analizador de memoria divide su muestra por número de claves, el borrado masivo por lotes UNLINK por ranura, y el Profiler y el visor de Pub/Sub añaden un nodo columna.
  • Pub/Sub fragmentado. Introduce un canal que empiece por #, como #orders, y se observa con SSUBSCRIBE en el maestro que lo posee.
MGET user:{42}:profile user:{42}:cart
SQLLY.KEYS user:* 1000
SQLLY.TOPOLOGY
SQLLY.TRACE

Las claves que comparten una etiqueta hash comparten un slot, así que el MGET se ejecuta. SQLLY.KEYS recorre cada maestro por páginas con un cursor que continúa de unas a otras, y SQLLY.TOPOLOGY y SQLLY.TRACE son la vista de topología y su traza como comandos de solo lectura.

Un mapa de nodos para direcciones a las que no puedes conectarte

Los nodos del clúster indican a los clientes dónde están los otros nodos, usando las direcciones que se configuraron para anunciar. Detrás de un NAT, un mapeo de puertos de Docker o un bastión SSH, esas direcciones suelen ser privadas. El Mapa de nodos del clúster toma uno announced => dial par por línea; la dirección anunciada sigue nombrando el nodo en el mapa de slots, en redirecciones y como el nombre del servidor TLS, y solo el socket va a la dirección de conexión.

10.0.0.5:7001 => 127.0.0.1:17001
10.0.0.6:7002 => 127.0.0.1:17002
10.0.0.7:7003 => 127.0.0.1:17003

Un reenvío por nodo a través de SSH

En una conexión con saltos SSH o un proxy SOCKS o HTTP, SQLly abre un reenvío local aparte para cada nodo que nombre el clúster, por los mismos saltos, así que un nodo al que solo llega el bastión sigue funcionando. El mapa de nodos se aplica primero, así que también puede reescribir lo que el bastión marca.

Mapa de nodos y SSH →

TLS verificado contra el nombre correcto

El certificado de cada nodo se comprueba contra la dirección que anuncia, no contra el reenvío local, así que un certificado emitido correctamente valida a través del túnel. Los túneles envían un keepalive tras 30 segundos de silencio y se reabren tras una caída.

Modos TLS →
Captura de pantalla próximamenteredis-cluster-node-map-editor.webp — el editor de conexiones para el entorno de prueba del clúster 7100–7105 con el modo Cluster configurado en Redis Cluster y tres líneas de mapa de nodos reescribiendo las direcciones anunciadas a reenvíos locales
El mapa de nodos del clúster: un par anunciado => destino de conexión por línea, para clústeres detrás de NAT, Docker o un bastión.

Estos problemas reportados en Redis Insight describen las situaciones para las que se construyeron el mapa de nodos y los reenvíos por nodo: #6537 (un clúster a través de puertos SSH reenviados localmente que falla con «Failed to refresh slots cache») y #5722 (una topología de clúster incompleta con TLS y nombres de host). Consulta el tracker para ver en qué punto está cada una hoy.

Topología y una traza para cada nodo

Abierto Topología del clúster… desde el menú contextual de una base de datos, la paleta de comandos o el Panel del Servidor de una conexión de clúster. Enumera cada nodo de CLUSTER SHARDS (o CLUSTER NODES antes de 7.0) con su rol, sus ranuras, su estado, su desplazamiento de replicación, el estado del enlace, la dirección que anuncia, la dirección a la que SQLly se conecta y el nombre TLS que envía. El pie de página verifica que las 16,384 ranuras estén cubiertas e indica los nodos que estén en mal estado o hayan sido remapeados.

Captura de pantalla próximamenteredis-cluster-topology-trace.webp — Topología del clúster en el entorno de prueba del clúster 7100–7105: tres maestros y tres réplicas con ranuras, estado de salud y direcciones contactadas, el pie de página que confirma que se cubren las 16.384 ranuras, y las filas de rastreo de un nodo
La traza ejecuta los pasos de Probar conexión en cada nodo, así que la primera fila que falla te dice qué corregir.

Trazar ejecuta la misma verificación paso a paso que Test Connection contra cada nodo: búsqueda de nombres, túnel o proxy con el mapa de nodos, TCP, TLS, inicio de sesión, protocolo y ping, base de datos y estado del clúster - una fila por paso. Una entrada incorrecta en el mapa de nodos, un puerto bloqueado, un nombre TLS que no coincide o un problema de ACL aparece como la primera fila en fallar.

Qué rechaza un clúster y por qué

Cada uno de estos se rechaza antes de enviarse, con un mensaje que nombra la regla y la solución.

Comandos que SQLly rechaza en una conexión de Redis Cluster
ComandoPor qué, y qué hacer en su lugar
Comandos de varias claves entre ranurasMGET, MSET, un comando multiclave DEL, SUNION, RENAME y similares solo se ejecutan cuando todas las claves están en la misma ranura. Da a las claves relacionadas una etiqueta hash común: user:{42}:profile y user:{42}:cart.
SELECT distintas de 0Un clúster tiene una base de datos lógica. Copiar a base de datos… y MOVE te llevará a Copiar a Conexión…
KEYS y SCANKEYS bloquearía cada maestro y un SCAN el cursor pertenece a un solo nodo. Usa el explorador de claves o SQLLY.KEYS.
MULTI / EXECCada comando se enruta por separado, así que desde el editor una transacción no puede quedarse en un solo nodo.

Sentinel: el maestro actual, siempre

Activar Conectar a través de Sentinel, indica el nombre del maestro y los centinelas, y añade una contraseña de centinela si los centinelas la piden. En cada conexión, SQLly pregunta a los centinelas por turno cuál es el maestro actual, comprueba que el servidor es realmente un maestro y se conecta allí; Test indica el maestro y el centinela que respondió.

redis+sentinel://app:[email protected]:26379,10.0.0.2:26379/mymaster/2?sentinelPassword=s3cret
  • Preferir réplica para lecturas. Los scripts formados únicamente por comandos de solo lectura se ejecutan en una réplica en buen estado; cualquier cosa que escriba se ejecuta en el maestro.
  • Las lecturas sobreviven a un failover. SQLly vuelve a preguntar a los Sentinel, una vez por script, y un script de solo lectura vuelve a ejecutar el comando que falló y continúa.
  • Las escrituras nunca se vuelven a ejecutar. Un script que escribe se detiene con maestro cambiado, vuelve a ejecutar y nombra al nuevo maestro, porque la escritura puede haber llegado justo antes de que el maestro anterior desapareciera.
Captura de pantalla próximamenteredis-sentinel-test-result.webp — el editor de conexiones con Conectar a través de Sentinel activado, nombre del maestro mymaster y sentinel 127.0.0.1:26379, y el resultado de la prueba nombrando al maestro que respondió y al sentinel que lo identificó
La prueba en una conexión Sentinel muestra el nombre del maestro y del sentinel que lo señaló.

Lo que las conexiones Sentinel y Cluster aún no hacen

  • Las conexiones de Sentinel se dirigen directamente a los Sentinel, al maestro y a las réplicas, por lo que se rechazan los túneles SSH, los proxies y los reenvíos de puertos de Kubernetes, y las rutas de relé aún no admiten Sentinel. El Profiler y el visor de Pub/Sub se conectan al maestro actual.
  • En un clúster, un reenvío de puerto de Kubernetes solo llega al nodo semilla, y las conexiones a través de un puente de retransmisión aún no son compatibles con el modo clúster.
  • El modo clúster de ElastiCache y MemoryDB no se han probado contra una instancia real de AWS.

Modo clúster de ElastiCache y MemoryDB

Para ElastiCache en modo clúster, apunta la conexión al endpoint de configuración del clúster y usa TLS Requerido o Verificar completo cuando el cifrado en tránsito esté activado. MemoryDB siempre es un clúster y siempre usa TLS: toma su nombre de usuario ACL en el campo Username, y la vista de topología del clúster muestra sus shards. Ambos enrutan cada comando al shard dueño de su slot con las mismas reglas de arriba. AWS gestiona sus usuarios, así que la página de ACL no se ofrece.

Preguntas sobre Cluster y Sentinel

¿Puede SQLly conectarse a un Redis Cluster detrás de un bastión SSH?

Sí. En una conexión con saltos SSH o un proxy SOCKS o HTTP, SQLly abre un reenvío separado por cada nodo que nombra el clúster, por la misma ruta, y el mapa de nodos del clúster reescribe las direcciones anunciadas que el bastión o tu máquina no pueden alcanzar. Un reenvío de puerto de Kubernetes solo lleva un puerto, así que llega únicamente al nodo semilla.

¿Qué hace el mapa de nodos del clúster?

Los nodos del clúster anuncian las direcciones con las que fueron configurados, que detrás de NAT o un mapeo de puertos de Docker a menudo son privadas. Una línea por nodo, como 10.0.0.5:7001 => 127.0.0.1:17001, le indica a SQLly dónde conectarse en su lugar, mientras que la dirección anunciada sigue nombrando al nodo para redirecciones y como el nombre del servidor TLS.

¿Por qué SQLly rechaza KEYS, SCAN o MGET en un clúster?

Un clúster no puede ejecutarlos tal como están escritos: KEYS bloquearía todos los maestros, un cursor SCAN pertenece a un nodo, los comandos multiclave necesitan que todas las claves estén en el mismo slot, un clúster solo tiene la base de datos 0, y MULTI/EXEC no puede mantenerse en un solo nodo desde el editor. SQLly los rechaza antes de enviarlos, con un mensaje que indica la regla; da a las claves relacionadas una etiqueta hash común como {42}, o usa el explorador de claves.

¿Qué pasa con una escritura cuando Sentinel hace failover?

Nunca se vuelve a ejecutar por ti. SQLly pregunta a los centinelas por el nuevo maestro una vez y mueve la conexión allí; un script de solo lectura continúa, pero un script que escribe se detiene con "master changed, re-run", porque la escritura puede que ya se haya aplicado al maestro antiguo. Compruébalo y vuelve a ejecutarlo.

¿Puede una conexión Sentinel leer de una réplica?

Sí. Con la opción Preferir réplica para lecturas activada, un script formado solo por comandos de solo lectura se ejecuta en una réplica que los sentinelas reportan como sana, y el maestro responde cuando no hay ninguna. Todo lo que escriba, use SELECT o lea información global del servidor va al maestro. Las réplicas son asíncronas, así que una lectura puede quedar brevemente desfasada respecto al valor del maestro.

¿SQLly funciona con ElastiCache en modo clúster y MemoryDB?

Sí, por diseño: apunta una conexión de ElastiCache al endpoint de configuración del clúster, y MemoryDB siempre es un clúster, con la vista Topología del clúster que muestra sus fragmentos. Ninguno se ha probado aún contra una instancia real de AWS.

// pruébalo en tu propio clúster

Cada nodo, una ventana

Empieza gratis en macOS, Windows y Linux, sin necesidad de cuenta.