// redis 클러스터 & 센티널

모든 노드에 접속할 수 있는 Redis 클러스터 및 Sentinel GUI

클러스터는 배스천, NAT, Docker 포트 매핑 뒤에 있고, 노드들은 노트북에서 연결할 수 없는 주소를 알립니다. Sentinel은 마스터가 실패하면 다른 노드로 전환합니다. SQLly는 모든 명령을 해당 슬롯을 가진 노드로 라우팅하고, 도달할 수 없는 주소를 다시 쓰고, 각 노드를 단계별로 추적하며, 쓰기를 두 번 적용하는 일 없이 장애 조치를 따라갑니다.

클러스터를 따르는 슬롯 라우팅

서버 필드에 하나 이상의 시드 노드를 쉼표로 구분하여 나열하거나, redis:// URL에 호스트를 여러 개 담아 붙여넣어도 됩니다. 클러스터 모드 세션의 첫 연결에서 클러스터를 감지하거나, 항상 또는 절대 슬롯 단위로 라우팅하도록 설정할 수 있습니다.

  • 모든 명령은 해당 슬롯의 소유 노드로 갑니다. 장애 조치(failover)나 리샤딩 후에는, 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 배스천 뒤에서는 이 주소가 종종 사설 주소입니다. 클러스터 노드 맵 하나를 받습니다 announced => dial 쌍을 한 줄에 하나씩 받습니다. 공표된 주소는 슬롯 맵, 리디렉션, 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초간 소식이 없으면 keepalive를 보내고, 끊기면 다시 열립니다.

TLS 모드 →
스크린샷 추후 제공redis-cluster-node-map-editor.webp — 7100–7105 클러스터 픽스처의 연결 편집기: Cluster mode가 Redis Cluster로 설정되어 있고, 노드가 알리는 주소를 로컬 포워드로 다시 쓰는 노드 맵 세 줄이 있음
클러스터 노드 맵: announced => dial 쌍을 한 줄에 하나씩. NAT, Docker 또는 배스천 뒤의 클러스터용.

아래는 Redis Insight에 보고된 이슈들로, 노드 맵과 노드별 포워딩이 만들어진 배경이 된 상황들입니다: #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개 슬롯 전체가 커버되었음을 확인해 주는 푸터, 그리고 한 노드의 추적(Trace) 행
트레이스는 각 노드에 대해 테스트 연결의 단계를 실행하므로, 처음 실패하는 행이 무엇을 고쳐야 하는지 알려줍니다.

트레이스 각 노드에 대해 Test Connection과 같은 단계별 검사를 실행합니다 - 이름 조회, (노드 맵을 쓰는) 터널 또는 프록시, TCP, TLS, 로그인, 프로토콜과 핑, 데이터베이스, 클러스터 상태 - 단계마다 한 행씩 표시됩니다. 잘못된 노드 맵 항목, 막힌 포트, TLS 이름 불일치, ACL 문제는 가장 먼저 실패한 행으로 나타납니다.

클러스터가 거부하는 것과 그 이유

이 각각은 전송되기 전에 거부되며, 규칙과 수정 사항을 명시한 메시지가 표시됩니다.

Redis 클러스터 연결에서 SQLly가 거부하는 명령
명령이유와 대신 해야 할 일
슬롯 간 다중 키 명령MGET, MSET, 다중 키 DEL, SUNION, RENAME 등은 모든 키가 하나의 슬롯에 있을 때만 실행됩니다. 관련 키에는 공통 해시 태그를 지정하세요: user:{42}:profile 그리고 user:{42}:cart.
SELECT 0이 아닌클러스터에는 논리 데이터베이스가 하나뿐입니다. Copy to Database…와 MOVE 는 대신 연결로 복사…를 쓰라고 안내합니다.
KEYS 그리고 SCANKEYS 모든 마스터를 차단하고 SCAN 커서는 하나의 노드에 속합니다. 키 브라우저를 사용하거나 SQLLY.KEYS.
MULTI / EXEC각 명령은 개별적으로 라우팅되므로, 트랜잭션은 편집기에서 하나의 노드에 머무를 수 없습니다.

Sentinel: 언제나 현재 마스터

켜기 Sentinel을 통해 연결, 마스터 이름과 센티넬을 지정하고, 센티넬이 필요로 하면 센티넬 비밀번호를 추가하세요. 매 연결 시 SQLly는 순서대로 센티넬에게 현재 마스터가 누구인지 묻고, 서버가 실제로 마스터인지 확인한 후 그곳에 연결합니다; Test는 마스터와 응답한 센티넬을 표시합니다.

redis+sentinel://app:[email protected]:26379,10.0.0.2:26379/mymaster/2?sentinelPassword=s3cret
  • 읽기에는 복제본 사용. 읽기 전용 명령으로만 이루어진 스크립트는 정상 상태의 복제본에서 실행되고, 쓰기가 포함된 것은 마스터에서 실행됩니다.
  • 읽기는 장애 조치(failover) 중에도 계속됩니다. SQLly는 스크립트마다 한 번씩 다시 센티넬에게 물어보고, 읽기 전용 스크립트는 실패한 명령을 다시 실행하고 계속 진행합니다.
  • 쓰기는 절대 다시 실행되지 않습니다. 쓰기를 담은 스크립트는 마스터 변경됨, 다시 실행 그리고 새 마스터가 무엇인지 알려줍니다. 쓰기가 예전 마스터가 내려가기 직전에 기록되었을 수도 있기 때문입니다.
스크린샷 추후 제공redis-sentinel-test-result.webp — Connect through Sentinel을 켜고 마스터 이름은 mymaster, 센티넬은 127.0.0.1:26379로 넣은 연결 편집기, 그리고 응답한 마스터와 그 마스터를 알려 준 센티넬을 표시하는 테스트 결과
Sentinel 연결을 테스트하면 마스터와, 마스터를 가리켰던 센티넬의 이름이 표시됩니다.

Sentinel과 Cluster 연결이 아직 지원하지 않는 것

  • Sentinel 연결은 Sentinel 노드, 마스터, 복제본에 직접 접속하므로 SSH 터널, 프록시, Kubernetes 포트 포워드는 거부되고, 릴레이 경로는 아직 Sentinel을 지원하지 않습니다. 프로파일러와 Pub/Sub 뷰어는 현재 마스터에 연결됩니다.
  • 클러스터에서 Kubernetes 포트 포워드는 시드 노드에만 도달하며, 릴레이 브리지를 통한 연결은 아직 클러스터 모드를 지원하지 않습니다.
  • ElastiCache 클러스터 모드와 MemoryDB는 라이브 AWS 인스턴스에서 테스트되지 않았습니다.

ElastiCache 클러스터 모드와 MemoryDB

클러스터 모드의 ElastiCache에서는 클러스터의 구성 엔드포인트를 대상으로 연결하고 전송 중 암호화가 활성화된 경우 TLS Require 또는 Verify full을 사용합니다. MemoryDB는 항상 클러스터이며 항상 TLS를 사용하고, ACL 사용자 이름을 Username 필드에 입력하며, 클러스터 토폴로지 뷰에서 샤드를 나열합니다. 둘 다 각 명령을 위에서 설명한 규칙과 동일하게 소유 슬롯을 가진 샤드로 라우팅합니다. AWS가 사용자 관리를 수행하므로 ACL 페이지는 제공되지 않습니다.

클러스터 및 센티넬에 대한 질문

SQLly가 SSH 배스천 뒤에 있는 Redis 클러스터에 연결할 수 있나요?

예. SSH 홉이나 SOCKS/HTTP 프록시가 있는 연결에서는 SQLly가 같은 경로로 클러스터가 알려 주는 각 노드에 별도 포워딩을 열고, 클러스터 노드 맵은 배스천이나 이 컴퓨터가 직접 접속할 수 없는 알려진 주소를 다시 씁니다. Kubernetes 포트 포워딩은 포트 하나만 전달하므로 시드 노드에만 닿습니다.

클러스터 노드 맵은 무엇을 하나요?

클러스터 노드는 자신이 구성된 주소를 알리며, NAT 뒤나 Docker 포트 매핑 환경에서는 그 주소가 사설 주소인 경우가 많습니다. 노드마다 한 줄씩, 예컨대 10.0.0.5:7001 => 127.0.0.1:17001 같은 줄이 SQLly가 대신 접속할 주소를 알려 주고, 노드가 알리는 주소는 리디렉션과 TLS 서버 이름을 지정할 때 계속 그대로 쓰입니다.

왜 SQLly가 클러스터에서 KEYS, SCAN 또는 MGET 명령을 거부하나요?

클러스터는 이 명령들을 입력한 그대로 실행할 수 없습니다. KEYS는 모든 마스터를 막고, SCAN 커서는 한 노드에 속하고, 멀티 키 명령은 모든 키가 한 슬롯에 있어야 하고, 클러스터에는 데이터베이스 0만 있고, MULTI/EXEC는 에디터에서 한 노드에 머물 수 없습니다. SQLly는 보내기 전에 거부하고 규칙 이름을 밝히는 메시지를 보여 줍니다. 관련 키에는 {42} 같은 공통 해시 태그를 달거나 키 브라우저를 쓰세요.

Sentinel이 장애 조치를 수행하면 쓰기 작업은 어떻게 되나요?

SQLly가 알아서 다시 실행하지는 않습니다. 새 마스터를 센티널에 한 번 물어보고 연결을 그쪽으로 옮깁니다. 읽기 전용 스크립트는 계속 진행되지만, 쓰기를 하는 스크립트는 “마스터가 바뀌었으니 다시 실행하세요”라는 안내와 함께 멈춥니다. 쓰기가 이미 이전 마스터에 기록됐을 수도 있기 때문입니다. 확인하고 다시 실행하세요.

Sentinel 연결이 복제본에서 읽을 수 있나요?

네. 읽기에 복제본 우선 사용이 켜져 있으면 읽기 전용 명령으로만 이루어진 스크립트는 Sentinel이 정상이라고 보고한 복제본에서 실행되고, 정상인 복제본이 없으면 마스터가 응답합니다. 쓰기를 하거나, SELECT를 쓰거나, 서버 전체 정보를 읽는 것은 모두 마스터에서 실행됩니다. 복제본은 비동기이므로 읽은 값이 잠깐 마스터 값보다 오래될 수 있습니다.

SQLly는 ElastiCache 클러스터 모드와 MemoryDB에서 작동하나요?

예, 설계상 그렇습니다. ElastiCache 연결은 클러스터 구성 엔드포인트를 가리키면 되고, MemoryDB는 항상 클러스터이며 클러스터 토폴로지 뷰에 샤드가 나열됩니다. 둘 다 아직 실제 AWS 인스턴스로는 테스트해 보지 않았습니다.

// 내 클러스터에서 직접

모든 노드, 한 창

macOS, Windows, Linux에서 무료로 시작할 수 있고 계정도 필요 없습니다.