Создание инстанса Redis и первое подключение
ВВЕДЕНИЕ
Redis — хранилище данных «ключ — значение», которое держит рабочий набор в оперативной памяти. Его используют как кэш, хранилище сессий, счётчики, лёгкие очереди и механизм распределённых блокировок — везде, где важна скорость чтения и записи, а данные можно восстановить из основной системы.
В DevSpace Redis — управляемый сервис. Вы заполняете одну форму, а платформа разворачивает не одиночный процесс, как при установке на виртуальную машину, а отказоустойчивую связку: несколько экземпляров Redis с репликацией и три процесса Sentinel, которые следят за master и автоматически переключают его роль при сбое. Постоянные диски, пароль, внутренние адреса и сбор метрик создаются автоматически.
Чем это отличается от привычной установки на VM:
• не нужно настраивать репликацию и Sentinel вручную — связка создаётся готовой
• при отказе master реплика повышается автоматически, без ручного SLAVEOF
• пароль генерируется платформой и хранится в секрете, а не в redis.conf
• данные лежат на отдельных постоянных дисках и переживают перезапуск процесса
Redis не стоит использовать как единственное долговременное хранилище критичных данных — управляемого резервного копирования у этого сервиса нет. Подробнее — в разделе "Что дальше".
|
ПЕРЕД НАЧАЛОМ
Понадобятся:
-
доступ к пространству DevSpace и право создавать в нём сервисы
-
утилита redis-cli (или любой Redis-клиент) для проверки подключения
Учитывайте при выборе пресета ресурсов: CPU и память потребуются не только экземплярам Redis, но и трём Sentinel.
ПОШАГОВОЕ РУКОВОДСТВО
Шаг 1. Откройте Marketplace и выберите Redis
Войдите в дашборд DevSpace и откройте раздел Marketplace. Найдите карточку Redis (категория PaaS, подпись «Managed Redis service») и откройте её — появится форма создания нового инстанса. У формы две вкладки: Form (поля) и YAML (та же конфигурация текстом). Под полем имени показан tenant-id вашего пространства.
Перед заполнением проверьте выбранное пространство в шапке (в интерфейсе — Tenant): сервис, его секреты и внутренние адреса будут изолированы внутри этого пространства.

Шаг 2. Заполните форму
Для примера в этой статье используются значения:
|
Поле
|
Значение
|
Зачем
|
|
Name
|
demo1
|
Имя инстанса: строчные латинские буквы, цифры, дефисы. Станет частью имён сервисов и секрета — платформа добавит к нему префикс redis-, получится redis-<name>-…
|
|
replicas
|
2
|
Два экземпляра Redis: master и реплика — минимум для автоматического переключения при сбое.
|
|
resourcesPreset
|
t1.micro
| |
|
size
|
2Gi
|
Постоянный диск каждого экземпляра.
|
|
storageClass
|
local
|
Класс хранилища. Выбор зависит от того, сколько экземпляров у сервиса и реплицирует ли он данные сам — подробнее в разделе «Параметры». После создания изменить нельзя.
|
|
external
|
включено
|
Опубликовать Redis наружу через LoadBalancer. Если клиенты живут в том же пространстве — оставьте выключенным.
|
|
version
|
v8
|
Мажорная ветка Redis.
|
|
authEnabled
|
включено
|
Сгенерировать пароль и требовать аутентификацию. Не выключайте.
|
Дальше в статье <name> — это имя, которое вы задали в поле Name: платформа подставляет его в имена сервисов, секретов и компонентов инстанса.
Подсказка: поля cpu и memory в группе resources позволяют задать ресурсы точнее пресета — заполняйте их, только когда типовых пресетов не хватает: явные значения имеют приоритет. Память указывайте с единицами измерения: 512Mi, 2Gi.
|
Шаг 3. Запустите развёртывание
Нажмите Deploy. Откроется карточка созданного инстанса — дождитесь статуса Ready в шапке.

Шаг 4. Убедитесь, что все компоненты запущены
Статус Ready означает, что платформа применила конфигурацию сервиса, но сами компоненты после этого ещё могут запускаться. Поэтому, прежде чем подключаться, проверьте фактическое состояние развёртывания на вкладке Workloads карточки — по смыслу это аналог systemctl status на сервере: видно, что реально запущено и готово к работе.
В разделе Pods этой вкладки — по строке на каждый запущенный экземпляр компонента, справа в строке — статус и счётчик готовности в формате «готово/всего». Состав строк зависит от конфигурации. Для примера из этой статьи их пять:
-
rfr-redis-<name>-0и rfr-redis-<name>-1 — экземпляры Redis (master и реплика), по одному на replicas
-
три строки rfs-redis-<name>-… — процессы Sentinel. Их всегда три, независимо от replicas
Сервис готов к работе, когда в каждой строке статус Running, а числа в счётчике совпадают: 1/1, 2/2, 3/3. Значение «всего» у разных компонентов своё — важно только, чтобы числа были равны.
Строки со статусом Succeeded и счётчиком 0/1 — это нормально: разовая задача автоматики отработала и завершилась.

Если строка со статусом Running показывает 0/1, 1/2, 1/3, развёртывание ещё не завершилось — даже если в шапке уже Ready. Сразу после создания это нормально: компонентам нужно время на запуск. Если картина долго не меняется, откройте вкладку Events: там отображаются события запуска компонентов, по ним обычно видно, на чём запуск остановился. Если причина непонятна, обратитесь в поддержку и укажите имя инстанса. Возвращайтесь к вкладке Workloads и после изменений конфигурации: если изменение перезапускает компоненты, часть строк какое-то время будет не готова.
|
Шаг 5. Получите адрес подключения
Для внешнего подключения откройте вкладку Services карточки инстанса и найдите сервис redis-<name>-external-lb (тип LoadBalancer, порт 6379/TCP) — выданный адрес показан в колонке External IP. Сразу после создания он может ещё отсутствовать — дождитесь его появления.
Если External выключен, внешний адрес не создаётся, а Redis остаётся доступен только внутри пространства. На вкладке Services видны внутренние адреса связки:
-
rfrm-redis-<name>— текущий master (запись и чтение)
-
rfrs-redis-<name>— реплики (чтение)
-
rfs-redis-<name>— Sentinel (порт 26379), через который клиенты с его поддержкой сами находят master
Шаг 6. Получите пароль
-
Откройте вкладку Secrets карточки инстанса.
-
Выберите секрет redis-<name>-auth.
-
Раскройте значение password кнопкой с иконкой глаза и скопируйте его.
Рекомендуем передавать пароль приложению через хранилище секретов, а не хранить его в коде или репозитории.

ПАРАМЕТРЫ
Все поля формы соответствуют параметрам ресурса Redis. Если параметр не задан явно, платформа применит значение по умолчанию.
|
Параметр
|
Что делает
|
Значение по умолчанию
|
Когда менять
|
|
replicas
|
Число экземпляров Redis: один master, остальные — реплики.
|
2
|
1 — только для сред без требований к доступности: автопереключение станет невозможным. 3 — для критичных нагрузок.
|
|
resourcesPreset
|
t1.nano
|
Подбирайте по объёму рабочего набора данных с запасом: нехватка памяти приводит к OOM-перезапускам.
| |
|
resources.cpu
|
Явный CPU вместо пресета.
|
не задан
|
Когда типовых пресетов не хватает. Явные значения имеют приоритет над resourcesPreset.
|
|
resources.memory
|
Явная память вместо пресета.
|
не задана
|
То же: лимит должен превышать рабочий набор с учётом буферов репликации и фонового сохранения. Память указывайте с единицами измерения: 512Mi, 2Gi.
|
|
size
|
Размер постоянного диска каждого экземпляра.
|
1Gi
|
Увеличивайте под пиковый объём данных с запасом. Уменьшить том позже нельзя.
|
|
storageClass
|
Класс постоянного хранилища.
|
local — копии тома только на одном сервере
|
При одном экземпляре — replicated, при двух и больше обычно local, потому что ввод-вывод у replicated медленнее. Параметр неизменяемый — смена потребует нового инстанса и переноса данных. Разбор — в подсказке в конце раздела.
|
|
external
|
Создаёт LoadBalancer с внешним IP на порту 6379.
|
false
|
Включайте, только если клиенты работают вне пространства: публичный Redis — расширение поверхности атаки.
|
|
version
|
Мажорная ветка Redis.
|
v8
|
v7 — если приложение ещё не проверено на совместимость с Redis 8. Откат после обновления не гарантируется.
|
|
authEnabled
|
Генерирует пароль (секрет redis-<name>-auth) и включает аутентификацию.
|
true
|
Не выключайте: без пароля любой клиент с сетевым доступом прочитает данные.
|
Сервис не шифрует трафик Redis — TLS в нём не предусмотрен. Не передавайте пароль и данные через недоверенную сеть без защищённого канала — VPN или закрытого сетевого контура.
|
Как выбрать класс хранилища. replicated держит копии тома на нескольких серверах платформы и переживает потерю сервера, но пишет синхронно в несколько мест, поэтому ввод-вывод у него всегда медленнее, чем у local. Критерий выбора — сколько экземпляров у сервиса и реплицирует ли он данные сам между репликами:
-
один экземпляр — берите replicated: другой копии данных нет, и потеря сервера означает потерю тома
-
два и больше — подходит local: копия данных уже есть на других экземплярах, а replicated под таким сервисом только замедлит запись, дублируя то, что и так продублировано
Master и реплики Redis синхронизируются между собой сами, поэтому при replicas: 2 и больше обычный выбор — local. Для одиночного экземпляра берите replicated.
ПРИМЕР КОНФИГУРАЦИИ
Итоговый ресурс, соответствующий шагам выше. Вкладка YAML формы показывает и принимает ту же конфигурацию.
apiVersion: apps.cozystack.io/v1alpha1
kind: Redis
metadata:
name: demo1
spec:
# Master и одна реплика — минимум для автоматического failover.
replicas: 2
# Типовой пресет CPU/памяти каждого Redis и Sentinel.
resourcesPreset: t1.micro
# Постоянный диск каждого экземпляра.
size: 2Gi
# Неизменяемый параметр. В примере local: копия данных есть на второй реплике.
storageClass: local
# Внешний LoadBalancer на порту 6379.
external: true
# Мажорная ветка Redis.
version: v8
# Пароль в секрете redis-<name>-auth, аутентификация включена.
authEnabled: true
|
Производные ресурсы получают префикс redis-: секрет redis-<name>-auth, внешний сервис redis-<name>-external-lb, внутренние rfrm-redis-<name>, rfrs-redis-<name>, rfs-redis-<name>.
|
ПРОВЕРКА
Подключитесь к выданному адресу и выполните PING:
REDISCLI_AUTH='<пароль>' redis-cli -h <внешний-IP> -p 6379 PING
|
Ожидаемый ответ:
PONG
|
Строка подключения для клиентов с поддержкой URI:
redis://:<пароль>@<адрес>:6379/0
|
Если пароль содержит специальные символы, в URI он должен быть percent-encoded. Надёжнее передавать host, port и password библиотеке отдельными параметрами.
Типовые ошибки подключения: NOAUTH Authentication required — клиент не передал пароль. WRONGPASS — пароль от другого инстанса (сверьте секрет redis-<name>-auth). Таймаут — внешний IP ещё не выдан или нет маршрута до него.
Подключение из приложения — передайте адрес и пароль клиентской библиотеке. Например, на Python:
import redis
r = redis.Redis(host="<адрес>", port=6379, password="<пароль>")
r.set("greeting", "hello")
print(r.get("greeting"))
|
Клиенты с поддержкой Sentinel могут вместо фиксированного адреса использовать rfs-redis-<name> и находить master автоматически.
-
Масштабирование — число реплик (replicas) и пресет ресурсов меняются в той же форме. Диск можно только увеличивать, storageClass неизменяем
-
Обновление версии — смена version перезапускает компоненты. Перед обновлением проверьте совместимость клиентов и не рассчитывайте на откат
-
Удаление — удаление инстанса удаляет и его диски с данными. Выгрузите нужные данные заранее
