Создание инстанса RabbitMQ и первое подключение
ВВЕДЕНИЕ
RabbitMQ — брокер сообщений: производители отправляют сообщения в обменники (exchange), брокер маршрутизирует их в очереди, потребители забирают по протоколу AMQP. Классический выбор для очередей задач, асинхронной интеграции сервисов и фоновой обработки.
В DevSpace RabbitMQ — управляемый сервис: вы заполняете одну форму, а платформа разворачивает кластер RabbitMQ с постоянными дисками, пользователями и виртуальными хостами из конфигурации.
Чем это отличается от привычной установки на VM:
-
кластеризация узлов настраивается автоматически
-
пользователи и виртуальные хосты задаются декларативно, а не через rabbitmqctl
-
пароли генерируются платформой и хранятся в секретах
-
данные очередей лежат на отдельных постоянных дисках
ПЕРЕД НАЧАЛОМ
Понадобятся:
-
доступ к пространству DevSpace и право создавать в нём сервисы
-
любой AMQP-клиент для проверки — например, библиотека pika для Python или rabbitmqadmin
ПОШАГОВОЕ РУКОВОДСТВО
Шаг 1. Откройте Marketplace и выберите RabbitMQ
Войдите в дашборд DevSpace и откройте раздел Marketplace. Найдите карточку RabbitMQ (категория PaaS, подпись «Managed RabbitMQ service») и откройте её. У формы две вкладки: Form (поля) и YAML (та же конфигурация текстом). Под полем имени показан tenant-id вашего пространства.
Шаг 2. Заполните основные поля
Для примера в этой статье используются значения:
|
Поле
|
Значение
|
Зачем
|
|
Name
|
smtest
|
Имя инстанса: строчные латинские буквы, цифры, дефисы. Станет частью имён сервиса и секретов (rabbitmq-<name>-…).
|
|
replicas
|
3
|
Три узла кластера — устойчивость к отказу одного узла.
|
|
resourcesPreset
|
s1.small
| |
|
size
|
10Gi
|
Постоянный диск каждого узла.
|
|
storageClass
|
local
|
Класс хранилища. Выбор зависит от того, сколько экземпляров у сервиса и реплицирует ли он данные сам — подробнее в разделе «Параметры». После создания изменить нельзя.
|
|
external
|
включено
|
Опубликовать брокер наружу через LoadBalancer. Если клиенты живут в том же пространстве — оставьте выключенным.
|
|
version
|
v4.2
|
Ветка RabbitMQ.
|
Дальше в статье <name> — это имя, которое вы задали в поле Name: платформа подставляет его в имена сервисов, секретов и компонентов инстанса.

Шаг 3. Опишите пользователя и виртуальный хост
В группе users добавьте пользователя user01. Пароль можно задать явно, а можно оставить пустым — платформа сгенерирует его и положит в секрет rabbitmq-<name>-user01-credentials.

В группе vhosts добавьте виртуальный хост vh01 и в roles.admin укажите user01 — пользователь получит полные права в этом vhost. Для доступа только на чтение есть roles.readonly.

Виртуальные хосты изолируют очереди и права разных приложений внутри одного брокера.
Шаг 4. Запустите развёртывание
Нажмите Deploy. Откроется карточка созданного инстанса — дождитесь статуса Ready в шапке.

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

Если строка со статусом Running показывает 0/1, 1/2, 1/3, развёртывание ещё не завершилось — даже если в шапке уже Ready. Сразу после создания это нормально: компонентам нужно время на запуск. Если картина долго не меняется, откройте вкладку Events: там отображаются события запуска компонентов, по ним обычно видно, на чём запуск остановился. Если причина непонятна, обратитесь в поддержку и укажите имя инстанса. Возвращайтесь к вкладке Workloads и после изменений конфигурации: если изменение перезапускает компоненты, часть строк какое-то время будет не готова.
|
Шаг 6. Получите адрес и учётные данные
На вкладке Services карточки инстанса найдите сервис rabbitmq-<name> — при включённом external это LoadBalancer с внешним IP (колонка External IP) и портами:
-
5672— AMQP для приложений
-
15672— веб-консоль управления RabbitMQ (откройте http://<внешний-IP>:15672 в браузере и войдите под пользователем из конфигурации)
Учётные данные — на вкладке Secrets: rabbitmq-<name>-default-user — служебная учётная запись, rabbitmq-<name>-user01-credentials — пароль пользователя user01 (значения раскрываются кнопкой с иконкой глаза).
ПАРАМЕТРЫ
|
Параметр
|
Что делает
|
Значение по умолчанию
|
Когда менять
|
|
replicas
|
Число узлов кластера RabbitMQ.
|
3
|
1 — только для сред без требований к доступности.
|
|
resourcesPreset
|
s1.nano
|
По потоку сообщений и числу очередей.
| |
|
resources.cpu / resources.memory
|
Явные ресурсы вместо пресета. Незаданные значения берутся из пресета.
|
не заданы
|
Когда пресетов не хватает. Память указывайте с единицами измерения: 512Mi, 2Gi.
|
|
size
|
Постоянный диск каждого узла.
|
10Gi
|
Под объём сообщений, задерживающихся в очередях.
|
|
storageClass
|
Класс постоянного хранилища.
|
local — копии тома только на одном сервере
|
При одном экземпляре — replicated, при двух и больше обычно local, потому что ввод-вывод у replicated медленнее. Параметр неизменяемый — смена потребует нового инстанса и переноса данных. Разбор — в подсказке в конце раздела.
|
|
external
|
Публикует брокер наружу: LoadBalancer с внешним IP.
|
false
|
Включайте, только если клиенты работают вне пространства через публичные сети.
|
|
version
|
Ветка RabbitMQ: v4.2, v4.1, v4.0, v3.13.
|
v4.2
|
Под совместимость клиентов.
|
|
users
|
Карта пользователей. password можно не задавать — сгенерируется в секрет.
|
{}
|
Отдельный пользователь на приложение.
|
|
vhosts
|
Карта виртуальных хостов. roles.admin и roles.readonly — списки пользователей.
|
{}
|
Изоляция приложений и выдача прав декларативно.
|
Как выбрать класс хранилища. replicated держит копии тома на нескольких серверах платформы и переживает потерю сервера, но пишет синхронно в несколько мест, поэтому ввод-вывод у него всегда медленнее, чем у local. Критерий выбора — сколько экземпляров у сервиса и реплицирует ли он данные сам между репликами:
-
один экземпляр — берите replicated: другой копии данных нет, и потеря сервера означает потерю тома
-
два и больше — подходит local: копия данных уже есть на других экземплярах, а replicated под таким сервисом только замедлит запись, дублируя то, что и так продублировано
Важная оговорка: число узлов кластера само по себе копий сообщений не делает. Между узлами реплицируются только quorum-очереди, классическая очередь целиком лежит на одном узле. Если очереди у вас классические, берите replicated независимо от числа узлов.
|
ПРИМЕР КОНФИГУРАЦИИ
Итоговый ресурс, соответствующий шагам выше. Вкладка YAML формы показывает и принимает ту же конфигурацию.
apiVersion: apps.cozystack.io/v1alpha1
kind: RabbitMQ
metadata:
name: smtest
spec:
# Три узла кластера.
replicas: 3
# Типовой пресет CPU/памяти узла.
resourcesPreset: s1.small
# Постоянный диск каждого узла.
size: 10Gi
# Неизменяемый параметр: выбирайте отказоустойчивый класс сразу.
storageClass: replicated
# Внешний LoadBalancer (AMQP 5672).
external: true
# Ветка RabbitMQ.
version: v4.2
# Пользователь приложения; пароль сгенерируется в секрет.
users:
user01: {}
# Виртуальный хост и права.
vhosts:
vh01:
roles:
admin:
- user01
|
Производные ресурсы получают префикс rabbitmq-: сервис rabbitmq-<name>, секрет служебного пользователя rabbitmq-<name>-default-user и секреты пользователей из конфигурации.
|
ПРОВЕРКА
Отправьте и получите сообщение на Python (pip install pika):
import pika
params = pika.URLParameters("amqp://user01:<пароль>@<адрес>:5672/vh01")
conn = pika.BlockingConnection(params)
ch = conn.channel()
ch.queue_declare(queue="greetings")
ch.basic_publish(exchange="", routing_key="greetings", body=b"hello")
print(ch.basic_get(queue="greetings", auto_ack=True)[2])
conn.close()
|
Скрипт должен напечатать b'hello'.
Типовые ошибки подключения: ACCESS_REFUSED — неверные учётные данные или у пользователя нет прав в vhost (проверьте vhosts.*.roles). Таймаут — внешний IP ещё не выдан или нет маршрута.
ЧТО ДАЛЬШЕ
-
Очереди и обменники — создаются самими приложениями через AMQP (queue_declare, exchange_declare). В конфигурации сервиса описываются только пользователи и vhost'ы
-
Масштабирование — replicas и пресет ресурсов меняются в той же форме. Диск можно только увеличивать, storageClass неизменяем
-
Обновление версии — смена version обновляет узлы кластера. Сверьте совместимость клиентских библиотек
-
Удаление — удаление инстанса удаляет и диски с сообщениями. Убедитесь, что очереди пусты или содержимое воспроизводимо
