// Redis Cluster и Sentinel

GUI для Redis Cluster и Sentinel с доступом к каждому узлу

Кластеры живут за бастионами, NAT и пробросами портов Docker, а их узлы объявляют адреса, до которых вашему ноутбуку не добраться. Sentinel переносит мастер при сбое. SQLly направляет каждую команду узлу-владельцу слота, подменяет недостижимые адреса, пошагово трассирует каждый узел и проходит переключение при отказе так, что ни одна запись не применяется дважды.

Маршрутизация по слотам, которая следует за кластером

Укажите один или несколько начальных узлов в поле Server, через запятую, или вставьте 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-бастионом это часто приватные адреса. Поле Карта узлов кластера принимает один 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 проверяется на соответствие нужному имени

Сертификат каждого узла проверяется по адресу, который он объявляет, а не по локальной переадресации, поэтому правильно выданный сертификат проходит проверку через туннель. Туннели отправляют keepalive после 30 секунд тишины и переоткрываются после обрыва.

Режимы TLS →
Скриншот появится позжеredis-cluster-node-map-editor.webp — редактор соединений для кластерного стенда 7100–7105 с режимом Redis Cluster и тремя строками карты узлов, переписывающими объявленные адреса на локальные перенаправления
Карта узлов кластера: одна пара «объявлено => подключение» на строку, для кластеров за NAT, Docker или бастионом.

Эти задачи из трекера Redis Insight описывают ситуации, для которых и делались карта узлов и перенаправления для каждого узла: #6537 (кластер через локально проброшенные SSH-порты с ошибкой «Не удалось обновить кэш слотов») и #5722 (неполная топология кластера с TLS и именами хостов). Проверьте трекер, чтобы узнать текущее состояние каждого.

Топология и трассировка для каждого узла

Открыть Топология кластера… из контекстного меню базы данных, палитры команд или панели управления сервером подключения к кластеру. Она перечисляет каждый узел из CLUSTER SHARDS (или CLUSTER NODES до версии 7.0) с его ролью, слотами, здоровьем, смещением репликации, состоянием связи, адресом, который он анонсирует, адресом, по которому SQLly подключается, и TLS-именем, которое он передаёт. Футер проверяет, что все 16 384 слота покрыты, и называет узлы, которые нездоровы или переназначены.

Скриншот появится позжеredis-cluster-topology-trace.webp — Топология кластера на стенде 7100–7105: три мастера и три реплики со слотами, состоянием и адресами подключения, нижняя строка с подтверждением покрытия всех 16 384 слотов и строки Trace для одного узла
Трассировка выполняет шаги «Проверки подключения» для каждого узла, поэтому первая строка с ошибкой говорит, что именно исправить.

Трассировка выполняет ту же пошаговую проверку, что и Проверка соединения, для каждого узла — поиск имени, туннель или прокси с картой узлов, TCP, TLS, вход, протокол и ping, база данных, состояние кластера — по строке на шаг. Неправильная запись в карте узлов, заблокированный порт, несоответствие имени TLS или проблема с ACL проявятся в первой не прошедшей проверку строке.

Что кластер отклоняет и почему

Каждое из этих действий отклоняется до отправки с сообщением, которое называет правило и исправление.

Команды, которые SQLly отклоняет при подключении к Redis Cluster
КомандаПочему — и что делать вместо этого
Команды с несколькими ключами в разных слотахMGET, MSET, мультключ DEL, SUNION, RENAME и подобные команды работают только тогда, когда все ключи попадают в один слот. Дайте связанным ключам общий хэш-тег: user:{42}:profile и user:{42}:cart.
SELECT с номером, отличным от 0У кластера есть одна логическая база данных. Копировать в базу данных… и MOVE предложит вместо этого «Копировать в соединение…».
KEYS и SCANKEYS блокировал бы каждого мастера и SCAN курсор принадлежит одному узлу. Используйте просмотрщик ключей или SQLLY.KEYS.
MULTI / EXECКаждая команда маршрутизируется независимо, поэтому из редактора транзакция не может привязаться к одному узлу.

Sentinel: всегда текущий мастер

Включите Подключение через Sentinel, укажите имя мастера и адреса Sentinel-узлов, а также пароль Sentinel, если он требуется. При каждом подключении SQLly по очереди спрашивает Sentinel-узлы о текущем мастере, проверяет, что сервер действительно мастер, и подключается к нему; кнопка Test показывает мастера и ответивший Sentinel-узел.

redis+sentinel://app:[email protected]:26379,10.0.0.2:26379/mymaster/2?sentinelPassword=s3cret
  • Предпочитать реплику для чтения. Скрипты, состоящие исключительно из команд чтения, выполняются на исправной реплике; всё, что выполняет запись, идёт на мастер.
  • Чтения не прерываются при failover. SQLly снова опрашивает Sentinel-узлы, один раз на скрипт, а скрипт только для чтения повторно выполняет команду, которая не удалась, и продолжает.
  • Операции записи никогда не выполняются повторно. Скрипт, который выполняет запись, останавливается с мастер изменился, повторите выполнение и указывает нового мастера, потому что запись могла дойти как раз перед тем, как старый мастер пропал.
Скриншот появится позжеredis-sentinel-test-result.webp — редактор соединений с включённой опцией «Connect through Sentinel», именем мастера mymaster и sentinel 127.0.0.1:26379, а также результат проверки, называющий ответившего мастера и sentinel, который его назвал
Проверка на подключении Sentinel сообщает имя мастера и sentinel, который на него указал.

Чего пока не умеют подключения к Sentinel и Cluster

  • Подключения через Sentinel напрямую обращаются к узлам Sentinel, мастеру и репликам, поэтому SSH-туннели, прокси и переадресация портов Kubernetes отклоняются, а маршруты через ретранслятор пока не поддерживают Sentinel. Профайлер и просмотрщик Pub/Sub подключаются к текущему мастеру.
  • В кластере проброс портов Kubernetes достаёт только до seed-узла, а подключения через релейный мост пока не поддерживают режим кластера.
  • Режим кластера ElastiCache и MemoryDB не были протестированы на живом экземпляре AWS.

Режим кластера ElastiCache и MemoryDB

Для ElastiCache в режиме кластера укажите в подключении конечную точку конфигурации кластера и используйте TLS Require или Verify full при включённом шифровании при передаче. MemoryDB всегда является кластером и всегда использует TLS, принимает имя пользователя ACL в поле Username, а в представлении Cluster Topology отображаются его шарды. Оба направляют каждую команду на шард, которому принадлежит её слот, по тем же правилам, что и выше. Пользователями управляет AWS, поэтому страница ACL не предлагается.

Вопросы о Cluster и Sentinel

Может ли SQLly подключаться к Redis Cluster через SSH-бастион?

Да. При подключении с SSH-прыжками или через SOCKS- либо HTTP-прокси SQLly открывает отдельный туннель для каждого узла, названного кластером, по тому же маршруту, а карта узлов кластера переписывает объявленные адреса, до которых бастион или ваша машина не могут дотянуться. Проброс порта Kubernetes несёт один порт, поэтому достаёт только до seed-узла.

Что делает карта узлов кластера?

Узлы кластера объявляют те адреса, с которыми были настроены, — за 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 выполнять чтение с реплики?

Да. Если включена опция Prefer replica for reads, скрипт из одних только команд чтения выполняется на реплике, которую Sentinel-процессы считают исправной, а если такой нет — отвечает мастер. Всё, что пишет, использует SELECT или читает общесерверную информацию, выполняется на мастере. Реплики асинхронны, поэтому чтение может на миг вернуть более старое значение, чем на мастере.

Работает ли SQLly с кластерным режимом ElastiCache и MemoryDB?

Да, так и задумано: укажите подключению ElastiCache конфигурационную точку кластера, а MemoryDB — это всегда кластер, и просмотр «Топологии кластера» показывает его шарды. Пока ни одна из них не проверялась на живом инстансе AWS.

// попробуйте на своём libSQL / Turso

Все узлы в одном окне

Начать бесплатно на macOS, Windows и Linux, аккаунт не нужен.