# RabbitMQ

Некоторая функциональность Global ERP требует брокера сообщений, поддерживающего протокол AMQP. Очевидным кандидатом является RabbitMQ.

Вы можете выбрать один из двух вариантов развертывания RabbitMQ:

- Книга ресурсов [одноименного](./resbooks/060_rabbitmq.md) класса. Этот вариант позволит вам без дополнительных усилий настроить RabbitMQ на основе уже развернутого кластера gs-ctk с минимальной потребностью в администрировании.
- Самостоятельно развернуть и администрировать RabbitMQ-кластер или использовать сервис вашего облачного провайдера. Этот вариант подойдет, если вы готовы взять на себя больше ответственности в администрировании RabbitMQ.

## Настройка кластера

1. Подготовьте RabbitMQ.

   Если вы решили использовать встроенный под с RabbitMQ, то добавьте, настройте и включите книгу ресурсов.

   Если вы решили развернуть RabbitMQ без использования gs-ctk, то вам потребуется создать в RabbitMQ [виртуальный хост](https://www.rabbitmq.com/docs/vhosts) и пользователя со всеми привилегиями на этот виртуальный хост.

2. Выполните `./resgroup.sh init_values`.

3. В конце мастер предложит ответить на вопрос `Использовать Ingress?`. Введите "да".

    Если вы используете встроенный RabbitMQ, значения должны установиться автоматически.

    Если вы не используете встроенный RabbitMQ, укажите в диалоге мастера следующие значения:

    - адрес к серверу RabbitMQ (IP/доменное имя),
    - номер порта сервера RabbitMQ,
    - название виртуального хоста,
    - имя секрета в Kubernetes, содержащего логин и пароль от виртуального хоста RabbitMQ

4. Перезапустите группу ресурсов. Зайдите в сервер приложений. Если сервер не смог соединиться с RabbitMQ, вы увидите уведомление об ошибке в нижнем правом углу.