// Redis Cluster und Sentinel

Eine Redis-Cluster- und Sentinel-GUI, die jeden Knoten erreicht

Cluster leben hinter Bastionen, NAT und Docker-Portzuordnungen, und ihre Knoten geben Adressen bekannt, die dein Laptop nicht erreichen kann. Sentinel verschiebt den Master, wenn er ausfällt. SQLly leitet jeden Befehl an den Knoten, der seinen Slot besitzt, schreibt die Adressen um, die es nicht erreichen kann, verfolgt jeden Knoten Schritt für Schritt und folgt einem Failover, ohne je einen Schreibvorgang doppelt anzuwenden.

Slot-Routing, das dem Cluster folgt

Gib einen oder mehrere Seed-Knoten im Serverfeld an, durch Kommas getrennt, oder füge eine redis:// URL mit mehreren Hosts ein. Clustermodus erkennt einen Cluster bei der ersten Verbindung einer Sitzung, oder du stellst ein, dass immer oder nie nach Slot geroutet wird.

  • Jeder Befehl an den Besitzer seines Slots. Nach einem Failover oder einem Reshard, MOVED und ASK werden die Antworten verfolgt und die Slot-Karte aktualisiert; das Nachrichtenfenster zeigt, wie viele Umleitungen ein Skript gesehen hat.
  • Jedes Tool auf jedem Master. Der Schlüssel-Browser geht jeden Master der Reihe nach durch, der Speicher-Analysator teilt seine Stichprobe nach Schlüsselanzahl, Massenlöschungen UNLINK nach Slot und der Profiler- und Pub/Sub-Viewer fügen eine Knoten Spalte hinzu.
  • Sharded Pub/Sub. Gib einen Kanal mit führendem #, wie zum Beispiel #orders, und es wird mit SSUBSCRIBE auf dem Master überwacht, der es besitzt.
MGET user:{42}:profile user:{42}:cart
SQLLY.KEYS user:* 1000
SQLLY.TOPOLOGY
SQLLY.TRACE

Schlüssel, die sich ein Hash-Tag teilen, teilen sich einen Slot, daher MGET läuft. SQLLY.KEYS geht jeden Master seitenweise mit einem Cursor durch, der über sie hinweg weiterläuft, und SQLLY.TOPOLOGY und SQLLY.TRACE sind die Topologieansicht und ihr Trace als schreibgeschützte Befehle.

Eine Knotenkarte für Adressen, die du nicht direkt anwählen kannst

Cluster-Knoten teilen Clients mit, wo die anderen Knoten sind, und verwenden dafür die Adressen, mit denen sie zur Bekanntgabe konfiguriert wurden. Hinter NAT, einer Docker-Portzuordnung oder einer SSH-Bastion sind diese oft privat. Das Cluster-Knotenkarte nimmt einen announced => dial Paar pro Zeile; die angekündigte Adresse benennt weiterhin den Knoten in der Slot-Karte, in Weiterleitungen und als TLS-Servername, und nur der Socket geht an die Dial-Adresse.

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

Ein Forward pro Knoten über SSH

Bei einer Verbindung mit SSH-Hops oder einem SOCKS- oder HTTP-Proxy öffnet SQLly für jeden Knoten, den der Cluster benennt, eine separate lokale Weiterleitung über dieselben Hops, sodass ein Knoten, den nur die Bastion erreichen kann, weiterhin funktioniert. Die Knotenkarte wird zuerst angewendet, sodass sie auch umschreiben kann, was die Bastion anwählt.

Knotenkarte und SSH →

TLS geprüft gegen den richtigen Namen

Das Zertifikat jedes Knotens wird gegen die Adresse geprüft, die er meldet – nicht gegen die lokale Weiterleitung –, sodass ein korrekt ausgestelltes Zertifikat durch den Tunnel verifiziert wird. Tunnel senden nach 30 Sekunden Funkstille ein Keepalive und öffnen sich nach einem Abbruch wieder.

TLS-Modi →
Screenshot folgtredis-cluster-node-map-editor.webp — der Verbindungseditor für das Cluster-Fixture 7100–7105 mit auf Redis Cluster gesetztem Clustermodus und drei Node-Map-Zeilen, die angekündigte Adressen auf lokale Weiterleitungen umschreiben
Die Cluster-Node-Karte: ein announced => dial-Paar pro Zeile, für Cluster hinter NAT, Docker oder einem Bastion-Host.

Diese gemeldeten Redis-Insight-Issues beschreiben die Situationen, für die die Knotenkarte und die Weiterleitungen pro Knoten gebaut wurden: #6537 (ein Cluster über lokal weitergeleitete SSH-Ports, der mit „Failed to refresh slots cache“ fehlschlägt) und #5722 (eine unvollständige Clustertopologie mit TLS und Hostnamen). Schau in den Tracker, wo jedes davon heute steht.

Topologie und ein Trace für jeden Knoten

Öffnen Cluster-Topologie… aus dem Rechtsklick-Menü einer Datenbank, der Befehlspalette oder dem Server-Dashboard einer Cluster-Verbindung. Es erfasst jeden Knoten von CLUSTER SHARDS (oder CLUSTER NODES vor 7.0) mit seiner Rolle, seinen Slots, seinem Zustand, seinem Replikations-Offset, seinem Link-Status, der Adresse, die er bekannt gibt, der Adresse, die SQLly wählt, und dem TLS-Namen, den er sendet. Die Fußzeile prüft, ob alle 16.384 Slots abgedeckt sind, und nennt jeden Knoten, der nicht gesund oder neu gemappt ist.

Screenshot folgtredis-cluster-topology-trace.webp — Cluster-Topologie auf dem Cluster-Fixture 7100–7105: drei Master und drei Replikate mit Slots, Integrität und kontaktierten Adressen, die Fußzeile bestätigt, dass alle 16.384 Slots abgedeckt sind, und die Trace-Zeilen für einen Knoten
Die Ablaufverfolgung führt die Schritte von „Verbindung testen“ für jeden Knoten aus, sodass die erste fehlgeschlagene Zeile sagt, was zu beheben ist.

Ablaufverfolgung führt dieselbe Schritt-für-Schritt-Prüfung wie Test Connection auf jedem Knoten aus – Namensauflösung, Tunnel oder Proxy mit der Knotenzuordnung, TCP, TLS, Anmeldung, Protokoll und Ping, Datenbank und Cluster-Status – eine Zeile pro Schritt. Ein falscher Eintrag in der Knotenzuordnung, ein blockierter Port, eine TLS-Namensabweichung oder ein ACL-Problem zeigt sich in der ersten fehlerhaften Zeile.

Was ein Cluster ablehnt und warum

Jeder davon wird abgelehnt, bevor er gesendet wird, mit einer Meldung, die die Regel und die Lösung nennt.

Befehle, die SQLly auf einer Redis-Cluster-Verbindung verweigert
BefehlWarum, und was du stattdessen tun kannst
Multi-Key-Befehle über SlotsMGET, MSET, ein Mehrfachschlüssel DEL, SUNION, RENAME und Ähnliches laufen nur, wenn jeder Schlüssel in einem Slot liegt. Gib verwandten Schlüsseln ein gemeinsames Hash-Tag: user:{42}:profile und user:{42}:cart.
SELECT außer 0Ein Cluster hat eine logische Datenbank. In Datenbank kopieren… und MOVE verweist Sie stattdessen auf Auf Verbindung kopieren…
KEYS und SCANKEYS würde jeden Master blockieren und ein SCAN Cursor gehört zu einem Knoten. Benutze den Schlüsselbrowser oder SQLLY.KEYS.
MULTI / EXECJeder Befehl wird einzeln geroutet, daher kann eine Transaktion aus dem Editor heraus nicht auf einem Knoten bleiben.

Sentinel: immer der aktuelle Master

Einschalten Über Sentinel verbinden, gib den Master-Namen und die Sentinels an und ergänze ein Sentinel-Passwort, falls die Sentinels eines verlangen. Bei jeder Verbindung fragt SQLly der Reihe nach die Sentinels nach dem aktuellen Master, prüft, dass der Server wirklich ein Master ist, und verbindet sich dort; Test nennt den Master und den Sentinel, der geantwortet hat.

redis+sentinel://app:[email protected]:26379,10.0.0.2:26379/mymaster/2?sentinelPassword=s3cret
  • Für Lesevorgänge ein Replikat bevorzugen. Skripte, die nur aus Lese-Befehlen bestehen, werden auf einem gesunden Replica ausgeführt; alles, was schreibt, läuft auf dem Master.
  • Lesevorgänge überleben ein Failover. SQLLY fragt die Sentinels erneut ab, einmal pro Skript, und ein lesendes Skript führt den fehlgeschlagenen Befehl erneut aus und macht dann weiter.
  • Schreibvorgänge werden niemals erneut ausgeführt. Ein Skript, das schreibt, stoppt mit Master geändert, erneut ausführen und benennt den neuen Master, weil der Schreibvorgang kurz vor dem Ausfall des alten Masters gelandet sein kann.
Screenshot folgtredis-sentinel-test-result.webp — der Verbindungseditor mit aktiviertem „Durch Sentinel verbinden“, Mastername mymaster und Sentinel 127.0.0.1:26379, und das Testergebnis mit dem Master, der geantwortet hat, und dem Sentinel, der ihn genannt hat
Der Test einer Sentinel-Verbindung nennt den Master und den Sentinel, der darauf verwiesen hat.

Was Sentinel- und Clusterverbindungen noch nicht tun

  • Sentinel-Verbindungen wählen die Sentinels, den Master und die Replikate direkt an, daher werden SSH-Tunnel, Proxys und Kubernetes-Port-Weiterleitungen abgelehnt, und Relay-Routen unterstützen Sentinel noch nicht. Der Profiler und der Pub/Sub-Viewer verbinden sich mit dem aktuellen Master.
  • In einem Cluster erreicht ein Kubernetes-Port-Forward nur den Seed-Knoten, und Verbindungen über eine Relay-Bridge unterstützen den Clustermodus noch nicht.
  • ElastiCache-Cluster-Modus und MemoryDB wurden nicht gegen eine echte AWS-Instanz getestet.

ElastiCache-Cluster-Modus und MemoryDB

Zeige bei ElastiCache im Cluster-Modus mit der Verbindung auf den Konfigurationsendpunkt des Clusters und verwende TLS Require oder Verify full, wenn die Verschlüsselung während der Übertragung aktiviert ist. MemoryDB ist immer ein Cluster und immer TLS, übernimmt den ACL-Benutzernamen im Feld Benutzername, und die Cluster-Topologie-Ansicht listet seine Shards auf. Beide leiten jeden Befehl nach denselben Regeln wie oben an den Shard weiter, dem der Slot gehört. AWS verwaltet die Benutzer, daher wird die ACL-Seite nicht angeboten.

Fragen zu Cluster und Sentinel

Kann SQLly eine Verbindung zu einem Redis-Cluster hinter einer SSH-Bastion herstellen?

Ja. Bei einer Verbindung mit SSH-Hops oder einem SOCKS- oder HTTP-Proxy öffnet SQLly für jeden Knoten, den der Cluster nennt, ein eigenes Forward über dieselbe Route, und die Cluster-Knotenkarte schreibt angekündigte Adressen um, die der Bastion-Host oder dein Rechner nicht erreichen kann. Ein Kubernetes-Port-Forward trägt nur einen Port und erreicht daher nur den Seed-Knoten.

Was macht die Cluster-Knotenkarte?

Cluster-Knoten geben die Adressen bekannt, mit denen sie konfiguriert wurden, die hinter NAT oder einer Docker-Portzuordnung oft privat sind. Eine Zeile pro Knoten, wie 10.0.0.5:7001 => 127.0.0.1:17001, teilt SQLly mit, wohin stattdessen verbunden werden soll, während die angegebene Adresse den Knoten für Weiterleitungen und als TLS-Servernamen benennt.

Warum lehnt SQLly KEYS, SCAN oder MGET auf einem Cluster ab?

Ein Cluster kann sie nicht wie eingegeben ausführen: KEYS würde jeden Master blockieren, ein SCAN-Cursor gehört zu einem Knoten, Multi-Key-Befehle brauchen alle Schlüssel in einem Slot, ein Cluster hat nur Datenbank 0, und MULTI/EXEC kann aus dem Editor heraus nicht auf einem Knoten bleiben. SQLly lehnt sie vor dem Senden ab, mit einer Meldung, die die Regel nennt; gib verwandten Schlüsseln ein gemeinsames Hash-Tag wie {42}, oder benutze den Schlüsselbrowser.

Was passiert mit einem Schreibvorgang, wenn Sentinel ein Failover durchführt?

Er wird nie für dich erneut ausgeführt. SQLly fragt die Sentinels einmal nach dem neuen Master und lenkt die Verbindung dorthin; ein rein lesendes Skript läuft weiter, aber ein Skript, das schreibt, stoppt mit „Master geändert, erneut ausführen“, weil der Schreibvorgang vielleicht schon auf dem alten Master gelandet ist. Prüfe es, und führe es dann erneut aus.

Kann eine Sentinel-Verbindung von einer Replica lesen?

Ja. Mit „Replica für Lesevorgänge bevorzugen“ läuft ein Skript, das nur aus Lesebefehlen besteht, auf einem Replica, das die Sentinels als gesund melden, und sonst auf dem Master, wenn keines gesund ist. Alles, was schreibt, SELECT verwendet oder serverweite Informationen liest, läuft auf dem Master. Replicas sind asynchron, daher kann ein Lesevorgang kurzzeitig älter sein als der Wert des Masters.

Funktioniert SQLly mit ElastiCache Cluster-Modus und MemoryDB?

Ja, genau dafür gedacht: Zeige mit einer ElastiCache-Verbindung auf den Konfigurationsendpunkt des Clusters, und MemoryDB ist immer ein Cluster, dessen Shards die Cluster-Topologie-Ansicht auflistet. Gegen eine echte AWS-Instanz wurde beides noch nicht getestet.

// mit deinem eigenen cluster ausprobieren

Jeder Knoten, ein Fenster

Kostenlos loslegen auf macOS, Windows und Linux, kein Konto nötig.