// redis cluster と sentinel

すべてのノードに接続できる Redis Cluster と Sentinel の GUI

クラスターは踏み台サーバー、NAT、Docker のポートマッピングの内側にあり、そのノードはノートパソコンから接続できないアドレスを通知してきます。Sentinel は、マスターが障害を起こすとマスターを切り替えます。SQLly は、すべてのコマンドを、そのスロットを持つノードへルーティングし、到達できないアドレスを書き換え、各ノードを段階的にトレースし、書き込みを二重に適用することなくフェイルオーバーに追従します。

クラスターに追従するスロットルーティング

サーバーフィールドにシードノードをカンマ区切りで 1 つ以上指定するか、次を貼り付けます redis:// 複数のホストを含む URL。 クラスターモード セッションの最初の接続時にクラスターを検出します。スロットによるルーティングを常に有効/常に無効に設定することもできます。

  • すべてのコマンドは、そのスロットを所有するノードに送られます。 フェイルオーバーまたはリシャーディングの後、 MOVED そして ASK 応答を追跡してスロットマップを更新し、メッセージペインにはスクリプトが受けたリダイレクトの回数が表示されます。
  • すべてのマスターを横断して、すべてのツールが使えます。 キーブラウザーは各マスターを順番にたどり、メモリアナライザーはそのサンプルをキー数で分割し、一括削除はバッチで UNLINK をスロット単位でバッチ化し、プロファイラーとPub/Subビューアーには ノード 列。
  • シャード Pub/Sub。 先頭に次を付けてチャンネルを入力 #、たとえば #orders、次で監視されます SSUBSCRIBE それを所有するマスター上で行われます。
MGET user:{42}:profile user:{42}:cart
SQLLY.KEYS user:* 1000
SQLLY.TOPOLOGY
SQLLY.TRACE

同じハッシュタグを持つキーは同じスロットに属するため、 MGET 実行します。 SQLLY.KEYS キースペースを同じ上限付きの SQLLY.TOPOLOGY そして SQLLY.TRACE は、トポロジービューとそのトレースを読み取り専用コマンドにしたものです。

ダイヤルできないアドレスのためのノードマップ

クラスターノードは、他のノードがどこにあるかを、通知するよう設定されたアドレスを使ってクライアントに伝えます。NAT、Docker のポートマッピング、または SSH 踏み台サーバーの内側では、それらはプライベートアドレスであることがよくあります。次の クラスターノードマップ 受け取るのは 1 つの announced => dial 1 行に 1 組。アナウンスされたアドレスは、スロットマップ、リダイレクト、TLS サーバー名ではノードの名前として使われ、ソケットだけが接続用アドレスに接続します。

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

SSH によるノードごとの転送

SSH ホップや SOCKS または HTTP プロキシを使う接続では、SQLly はクラスターが示すノードごとに、同じホップを経由する個別のローカルフォワードを開くため、踏み台サーバーからしか到達できないノードでも動作します。ノードマップが最初に適用されるので、踏み台サーバーが接続する先も書き換えられます。

ノードマップと SSH →

TLS を正しい名前に対して検証

各ノードの証明書は、ローカルフォワードではなく、そのノードが通知するアドレスに対して検証されるため、正しく発行された証明書はトンネル越しでも検証されます。トンネルは 30 秒間無通信が続くとキープアライブを送信し、切断後は再接続します。

TLSモード →
スクリーンショットは近日追加予定redis-cluster-node-map-editor.webp — 7100–7105 クラスターフィクスチャーの接続エディター。Cluster mode は Redis Cluster に設定され、通知されたアドレスをローカル転送に書き換える 3 行のノードマップが入っています
クラスターノードマップ: NAT、Docker、踏み台(bastion)の背後にあるクラスター向けに、1 行につき通知アドレス => 接続先アドレスのペアを 1 組記述します。

報告された次の Redis Insight の issue は、ノードマップとノードごとの転送が作られた状況を説明しています: #6537 (ローカルに転送した SSH ポート経由のクラスターが「Failed to refresh slots cache」で失敗する問題)および #5722 (TLS とホスト名を伴う不完全なクラスタートポロジ)。それぞれの現状は、トラッカーで確認してください。

トポロジーと、すべてのノードのトレース

開く クラスタートポロジ… データベースの右クリックメニュー、コマンドパレット、またはクラスター接続のサーバーダッシュボードから開きます。次のすべてのノードを一覧表示します CLUSTER SHARDS (または CLUSTER NODES 7.0より前)について、ロール、スロット、健全性、レプリケーションオフセット、リンク状態、アナウンスしているアドレス、SQLlyが実際に接続するアドレス、送信するTLS名を表示します。フッターは16,384個すべてのスロットがカバーされていることを確認し、異常があるノードや再マップされたノードをその名前とともに示します。

スクリーンショットは近日追加予定redis-cluster-topology-trace.webp — 7100–7105 クラスターフィクスチャーのクラスタートポロジー: スロット、ヘルス、接続先アドレスを備えた 3 つのマスターと 3 つのレプリカ、16,384 スロットすべてがカバーされていることを確認するフッター、1 つのノードのトレース行
トレースは、テスト接続の手順を各ノードに対して実行するため、最初に失敗した行を見れば何を修正すべきかが分かります。

トレース 各ノードに対して、テスト接続と同じ段階的なチェックを実行します(名前解決、ノードマップを使ったトンネルまたはプロキシ、TCP、TLS、サインイン、プロトコルと ping、データベース、クラスターの状態)。1 ステップにつき 1 行です。ノードマップのエントリの誤り、ブロックされたポート、TLS 名の不一致、ACL の問題は、最初の失敗行として表示されます。

クラスターが拒否するものと、その理由

これらはいずれも送信前に拒否され、ルールと対処方法を示すメッセージが表示されます。

Redis Cluster 接続で SQLly が拒否するコマンド
コマンド理由と、代わりにすべきこと
スロットをまたぐ複数キーのコマンドMGET, MSET、マルチキーの DEL, SUNION, RENAME などの操作は、すべてのキーが同じスロットにあるときにだけ実行できます。関連するキーには共通のハッシュタグを付けてください: user:{42}:profile そして user:{42}:cart.
SELECT 0 以外のクラスターには論理データベースが 1 つあります。Copy to Database… と MOVE 代わりに「Copy to Connection…」を案内します。
KEYS そして SCANKEYS すべてのマスターをブロックし、さらに SCAN カーソルは 1 つのノードに属します。キーブラウザー、または SQLLY.KEYS.
MULTI / EXEC各コマンドは個別にルーティングされるため、エディタからトランザクションを 1 つのノードに留めておくことはできません。

Sentinel: 常に現在のマスター

オンにする Sentinel 経由で接続、マスター名と Sentinel を指定し、Sentinel がパスワードを要求する場合は Sentinel のパスワードも追加します。接続のたびに、SQLly は Sentinel に順番に現在のマスターを問い合わせ、そのサーバーが本当にマスターであることを確認して、そこに接続します。「Test」では、マスター名と、応答した Sentinel が表示されます。

redis+sentinel://app:[email protected]:26379,10.0.0.2:26379/mymaster/2?sentinelPassword=s3cret
  • 読み取りにはレプリカを優先。 読み取り専用のコマンドだけで構成されたスクリプトは正常なレプリカで実行され、書き込みを行うスクリプトはマスターで実行されます。
  • フェールオーバー後も読み取りは生き残ります。 SQLly は、スクリプトごとに 1 回、センチネルに再度問い合わせます。読み取り専用のスクリプトでは、失敗したコマンドを再実行して処理を続行します。
  • 書き込みが再実行されることはありません。 書き込みを行うスクリプトは次で停止します master が変更されました。再実行してください 新しいマスターの名前も表示されます。書き込みが、古いマスターが消える直前に反映されていた可能性があるためです。
スクリーンショットは近日追加予定redis-sentinel-test-result.webp — 「Sentinel 経由で接続」をオンにし、マスター名 mymaster、Sentinel 127.0.0.1:26379 を指定した接続エディターと、応答したマスターとその名前を返した Sentinel を示すテスト結果
Sentinel 接続でテストすると、マスターと、そのマスターを指していた Sentinel の名前が表示されます。

Sentinel 接続とクラスター接続がまだ対応していないこと

  • Sentinel 接続は、Sentinel、マスター、レプリカへ直接接続するため、SSH トンネル、プロキシ、Kubernetes のポートフォワードは拒否され、リレー経路はまだ Sentinel に対応していません。プロファイラーと Pub/Sub ビューアは現在のマスターに接続します。
  • クラスターでは、Kubernetes のポートフォワードはシードノードにしか到達できず、リレーブリッジ経由の接続はまだクラスターモードをサポートしていません。
  • ElastiCache クラスターモードと MemoryDB は、ライブの AWS インスタンスに対してテストされていません。

ElastiCache クラスターモードと MemoryDB

クラスターモードの ElastiCache では、接続先にクラスターの構成エンドポイントを指定し、転送中の暗号化が有効な場合は TLS を Require または Verify full にします。MemoryDB は常にクラスターで、常に TLS を使用し、ACL ユーザー名は「ユーザー名」欄に入力し、クラスタートポロジビューでそのシャードを一覧表示します。どちらも、上記と同じルールで、各コマンドをそのスロットを所有するシャードにルーティングします。ユーザーは AWS が管理するため、ACL ページは提供されません。

Cluster と Sentinel に関する質問

SQLly は SSH 踏み台の向こうにある Redis Cluster に接続できますか?

はい。SSHホップ、またはSOCKSやHTTPプロキシ経由の接続では、SQLlyはクラスターが示すすべてのノードに対して、同じ経路で個別のフォワードを開き、踏み台サーバーやお使いのマシンからダイヤルできない通知アドレスは、クラスターのノードマップで書き換えられます。Kubernetesのポートフォワードは1つのポートしか通さないため、シードノードにしか到達しません。

クラスターノードマップにはどのような役割がありますか?

クラスターノードは、設定されたアドレスをそのまま通知しますが、NAT や Docker のポートマッピングの内側では、それらはプライベートアドレスであることがよくあります。10.0.0.5:7001 => 127.0.0.1:17001 のようにノードごとに 1 行指定すると、SQLly が代わりに接続するアドレスを指示できます。通知されたアドレスは、リダイレクトや TLS サーバー名としてノードを示す名前のままです。

SQLly がクラスターで KEYS、SCAN、MGET を拒否するのはなぜですか?

クラスターでは、入力されたとおりにはこれらを実行できません。KEYS はすべてのマスターをブロックし、SCAN カーソルは 1 つのノードに属し、複数キーのコマンドはすべてのキーが同じスロットにある必要があり、クラスターにはデータベース 0 しかなく、MULTI/EXEC はエディタから 1 つのノードにとどまれません。SQLly は、ルール名を示すメッセージとともに、送信前にそれらを拒否します。関連するキーには {42} のような共通のハッシュタグを付けるか、キーブラウザを使ってください。

Sentinel のフェイルオーバー時、書き込みはどうなりますか?

自動で再実行されることはありません。SQLly はセンチネルに新しいマスターを一度だけ問い合わせ、接続をそこへ移します。読み取り専用のスクリプトはそのまま続行されますが、書き込みを行うスクリプトは、書き込みが旧マスターにすでに反映されている可能性があるため「master changed, re-run」で停止します。確認してから、もう一度実行してください。

Sentinel 接続でレプリカから読み取れますか?

はい。「読み取りにレプリカを優先」をオンにすると、読み取り専用コマンドだけで構成されたスクリプトは、Sentinelが正常と報告するレプリカで実行され、正常なレプリカがない場合はマスターが応答します。書き込みを行うもの、SELECTを使うもの、サーバー全体の情報を読み取るものは、マスターで実行されます。レプリカは非同期のため、読み取り結果がマスターの値より少し古くなることがあります。

SQLly は ElastiCache クラスターモードと MemoryDB で使えますか?

はい、その前提で動くようになっています。ElastiCache 接続はクラスターの構成エンドポイントに向けてください。MemoryDB は常にクラスターとして動作し、クラスタートポロジービューにシャードが一覧表示されます。どちらも実際の AWS インスタンスに対してはまだテストしていません。

// 自分のクラスターで試してみる

すべてのノードを 1 つのウィンドウに

macOS、Windows、Linux で無料で始められます。アカウントは不要です。