Как настроить Redis Cluster
Redis Cluster — nativ horizontal scaling для Redis. Minimum: 3 masters + 3 replicas = 6 nodes (distributed через 16384 slots). Automated failover, client-side sharding, transparent для app (smart clients). Не для small data (<5GB) — просто Redis master+replica достаточно. Alternative: managed Redis (AWS ElastiCache, Redis Cloud, Yandex Managed Redis).
Ниже: пошаговая инструкция, рабочие примеры, типичные ошибки, FAQ.
Бесплатный онлайн-инструмент — проверка HTTP-заголовков: результат мгновенно, без регистрации.
Пошаговая настройка
- Install Redis 7+ на 6 серверах (или 6 containers)
- Config:
cluster-enabled yes,cluster-node-timeout 5000,appendonly yes - Start all 6 instances на разных ports (7000-7005)
- Create cluster:
redis-cli --cluster create ip1:7000 ip2:7001 ... --cluster-replicas 1 - Verify:
redis-cli -p 7000 cluster info→cluster_state:ok - Client setup: use cluster-aware clients (ioredis, lettuce, go-redis) — handle MOVED redirects
- Monitoring: redis-exporter + Prometheus dashboard
Рабочие примеры
| Сценарий | Конфиг |
|---|---|
| redis.conf (per node) | port 7000
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 5000
appendonly yes
protected-mode no # для intra-cluster (использовать firewall + requirepass)
requirepass strongpass |
| Create cluster CLI | redis-cli --cluster create \
10.0.0.1:7000 10.0.0.2:7001 10.0.0.3:7002 \
10.0.0.4:7003 10.0.0.5:7004 10.0.0.6:7005 \
--cluster-replicas 1 -a strongpass |
| ioredis cluster client (Node.js) | const Redis = require('ioredis');
const cluster = new Redis.Cluster([
{ host: '10.0.0.1', port: 7000 },
{ host: '10.0.0.2', port: 7001 },
// only need to provide a few — rest discovered
], { redisOptions: { password: 'strongpass' } });
await cluster.set('key', 'value'); |
| Add new master + resharding | # Add new node to cluster
redis-cli --cluster add-node new:7006 existing:7000
# Reshard slots to new master
redis-cli --cluster reshard existing:7000 |
| Hash tags (keep keys в одном slot) | # Без hash tags — random distribution
SET user:1:name alice
SET user:1:email a@e.com
# С hash tag — оба на одном shard (enabling transactions)
SET {user:1}:name alice
SET {user:1}:email a@e.com |
Типичные ошибки
- Cluster-unaware client → MOVED errors при каждом запросе. Use ioredis-cluster, go-redis, lettuce
- Multi-key transactions (MULTI) работают только для keys в одном hash slot (use {tags})
- Minimum 3 masters — с 1-2 masters нет quorum для leader election
- AOF + RDB backups обязательны — cluster не panacea для data durability
- cross-DC latency — cluster assumes <5ms между nodes. Для multi-region — separate clusters + replication
Как настроить Redis Cluster: краткое руководство
Чтобы настроить Redis Cluster в 2026 году, сначала установите Redis версии 5.0 и выше, так как именно с этой версии поддерживается кластеризация. Затем создайте конфигурационные файлы для каждой ноды, указывая параметры cluster-enabled yes и cluster-config-file nodes.conf. После этого запустите Redis на каждой ноде с использованием команды redis-server /path/to/your/redis.conf. Не забудьте выполнить команду redis-cli --cluster create для создания кластера, указав адреса всех нод.
Подробный процесс настройки Redis Cluster
Настройка Redis Cluster включает несколько этапов, начиная от установки Redis и заканчивая конфигурацией нод. Следуйте этому руководству для успешной настройки:
- Установите Redis: Убедитесь, что у вас установлена последняя версия Redis. Вы можете установить Redis на Ubuntu с помощью команды:
sudo apt-get install redis-server. - Создайте конфигурационные файлы: Для каждой ноды создайте отдельный конфигурационный файл. Например, для ноды 1 создайте файл
redis-node1.confс такими параметрами:
port 7000
cluster-enabled yes
cluster-config-file nodes-7000.conf
- Запустите ноды: Запустите каждую ноду с помощью команды
redis-server /path/to/redis-node1.conf. - Создание кластера: После запуска всех нод используйте следующую команду для создания кластера:
redis-cli --cluster create 127.0.0.1:7000 127.0.0.1:7001 127.0.0.1:7002 --cluster-replicas 1Эта команда создаст кластер с тремя мастер-нодами и одной репликой для каждой. Убедитесь, что вы заменили адреса на свои собственные, если используете другие порты или IP-адреса.
Проверка и управление Redis Cluster
После настройки Redis Cluster важно уметь проверять его состояние и управлять им. Для этого воспользуйтесь следующими командами:
- Проверка состояния кластера: Используйте команду
redis-cli -c -h 127.0.0.1 -p 7000 cluster infoдля получения информации о кластере. Это даст вам представление о статусе, количестве нод и текущем состоянии. - Проверка нод: Для проверки состояния всех нод кластера выполните команду
redis-cli -c -h 127.0.0.1 -p 7000 cluster nodes. Это покажет список всех нод и их статусы. - Добавление новой ноды: Если вам нужно добавить новую ноду в кластер, используйте команду
redis-cli --cluster add-node 127.0.0.1:7003 127.0.0.1:7000, чтобы подключить новую ноду к существующему кластеру.
Не забывайте о мониторинге вашего кластера с помощью инструментов, таких как Redis Sentinel, чтобы обеспечить высокую доступность и отказоустойчивость.
Больше по теме
Часто задаваемые вопросы
Когда нужен Redis Cluster?
Data >5 GB или >100k ops/sec. Меньше — single master + replica + Sentinel достаточно.
Cluster vs Sentinel?
Sentinel — HA (1 master + replicas, automatic failover). Cluster — scaling (sharded across masters). Разные задачи.
Managed alternatives?
AWS ElastiCache (Cluster mode), Redis Cloud (Redis Labs), Yandex Managed Redis. Обычно $50-500/мес vs $0 self-host но 20+ hours/month maintenance.
Migrate from single Redis?
Write dual (old + new), read от single → migrate reads batch → cut write. Или use Redis-shake tool для bulk copy.
Запустить инструмент, который описан в этой статье
Бесплатный тариф — 10 мониторов, проверки каждые 5 мин, без карты. Платные тарифы — интервал от 1 минуты и проверки из нескольких регионов.