###
### RMQ-КС - К
###
### Copyright (c) 2026, ООО Кейсистемс
###
### Версия 4.3.1
###

  Назначение         : Платформа для разворачивания, управления и удаления брокера сообщений RabbitMQ
                       реализованного в виде контейнера для работы в средах с поддержкой контейнеризации
                       Docker или Podman.


  Цель использования : Минимизировать издержки, связанные с разворачиванием и настройкой.

  Требует для работы : Docker-CE (Docker, Inc. лицензия Apache 2.0) или Podman (лицензия Apache 2.0), платформа linux/amd64.

  Характеристики     : Позволяет устанавливать до 10 экземляров контейнеров c брокером сообщений RabbitMQ.
                       Ограничение связано с ограничением диапазона используемых портов: 5672-5682.

                       В поставляемом образе контейнера используются компоненты:
                        - RabbitMQ Copyright (C) VMware, Inc.
                          (лицензия Mozilla Public License Version 2.0)

                       Для более подробного ознакомления с лицензированием Docker-CE, Podman, RabbitMQ
                       и информации об авторских правах смотрите соответствующие сайты программ:
                       https://www.docker.com/
                       https://podman.io/
                       https://www.rabbitmq.com/


I. Команды по созданию, удалению и просмотру состояния.

   Внимание! Для выполнения нижеперечисленных команд необходимы права суперпользователя.

 1. Создание экземпляра брокера по умолчанию выполняется через запуск скрипта:
    $ bash /opt/dks-rmqks-4.3.1/install.sh -n

    Внимание: Для получения информации о параметрах по умолчанию, необходимо выполнить:
              $ /opt/dks-rmqks-4.3.1/install.sh --help

    параметры              по умолчанию   описание
    -------------------    ------------   --------------------------------------------------------------
    -cs | --contsoft       docker         ПО контейнерезации (docker или podman)

    -p  | --port           5672           порт брокера сообщений (работа по amqp протоколу)

    -pe | --port_epmd      4369           порт вспомогательного сервиса epmd (Erlang Port Mapping Daemon)

    -u  | --user           admin          имя пользователя - администратора сайта управления

    -pwd| --pwd            1              пароль администратора

    -n  | --net_isolation                 изоляция сети контейнера


   При разворачивании инстанса создается:
   - Каталог данных экземпляра брокера по пути   : /var/lib/rmqks-4.3.1_<порт>
   - Каталог логов работы брокера по пути        : /var/lib/rmqks-4.3.1_<порт>/log
   - Каталог управления и утилит                 : /opt/rmqks-4.3.1_<порт>/*
   - Сервис systemd                              : rmqks-4.3.1_<порт>.service,
                                                   для автоматического запуска контейнера с инстансом брокера
                                                   после перезагрузки хоста
   - Веб интерфейс плагина управления            : http://<ip host>:1<порт>/#/
                                                   для входа пользователя - администратора


 2. Просмотр процессов и состояния в контейнере выполняется через запуск скрипта с указание порта как параметра:
    $ bash /opt/dks-rmqks-4.3.1/info.sh -p <порт>
    Если параметр не указан, то выводится общая информация по всем существующим контейнерам RMQ-КС Докер.

 3. Остановка контейнера с экземпляром брокера.
    $ systemctl stop rmqks-4.3.1_<порт>.service

 4. Запуск контейнера с экземпляром брокера.
    $ systemctl start rmqks-4.3.1_<порт>.service

 5. Удаление экземпляра брокера, установленного по умолчанию (порт 5672), выполняется через команду:
    $ /opt/dks-rmqks-4.3.1/uninstall.sh

    для удаления экземпляра брокера, установленного по другому порту, отличного от 5672, необходимо выполнить:
    $ /opt/dks-rmqks-4.3.1/uninstall.sh -p 5674


