Инфраструктура Middleware
Запи сь таблицы Инфраструктура Middleware (mai_middleware_infrastructure) является ключевым звеном архитектуры платформы Ainergy. Она отвечает за сетевую связность, распределение ресурсов и интеграцию основных компонентов системы: больших языковых моделей (LLM), оркестратора мультиагентных систем, брокеров сообщений и аналитических баз данных.
Работа с инфраструктурой состоит из трех шагов: создание записи, развертывание и, при необходимости, остановка. После развертывания инфраструктура сама забирает конфигурации нексусов, потребителей и лимитов – читайте подробнее в статье Доставка конфигураций.
Требуемые роли:
- Чтение – mai_reporter.
- Создание – mai_admin.
- Обновление – mai_admin. Запись недоступна для редактирования в статусах В процессе удаления и Остановлена.
- Удаление записи не предусмотрено: вместо удаления инфраструктура останавливается действием ❌ Удалить.
После создания записи автоматически создаются соответствующие экземпляры сервиса, RabbitMQ, ClickHouse, Redis и хранилища токенов, которые станут доступны в связанном списке Экземпляр MAI после сохранения записи. Также создается экземпляр сборщика трассировки – читайте подробнее в статье Трассировка запросов. Учетные данные для подключения к каждому из перечисленных экземпляров хранятся в записях этих экземпляров вместе с их остальными настройками. Учетные данные для экземпляра сервиса не предусмотрены.
Создание записи инфраструктуры
- Перейдите в на вигаторе в Управление инсталляциями приложений (MAI) → Инфраструктура Ainergy → Инфраструктура Middleware.
- Нажмите Создать и заполните поля формы.
- Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
Поля формы Инфраструктура Middleware
| Поле | Обязательно | Описание |
|---|---|---|
| DNS | Да | Укажите доменное имя, используемое для маршрутизации запросов к данному экземпляру инфраструктуры. Значение должно быть уникальным: создать вторую инфраструктуру с тем же доменным именем нельзя. |
| IP-адрес | Да | Укажите IP-адрес машины, на которой будет развернута инфраструктура. |
| Тип окружения | Да | Выберите тип окружения, определяющий назначение инфраструктуры:
|
| Путь для API | Да | Укажите домен, на который внешние приложения и ИИ-агенты отправляют API-запросы для генерации ответов. Поле будет заполнено автоматически после указания DNS, но доступно для редактирования. |
| Путь для RabbitMQ | Да | Укажите домен для брокера сообщений RabbitMQ. Поле будет заполнено автоматически после указания DNS, но доступно для редактирования. |
| Путь для ClickHouse | Да | Укажите домен для базы данных ClickHouse. Поле будет заполнено автоматически после указания DNS, но доступно для редактирования. |
| Producer | Нет | Поставщик RabbitMQ, через которого система отправляет инфраструктуре сообщения об изменении конфигураций. Поле заполняется автоматически при создании инфраструктуры. Если поставщик отсутствует, на форме отображается баннер с ошибкой, а изменения нексусов, потребителей и лимитов перестают доходить до платформы автоматически. Восстановить поставщика можно действиями Обслуживание → CMS на форме инфраструктуры. |
| Статус | Да | Текущее состояние инфраструктуры. Значение меняется автоматически при развертывании и остановке. Возможные опции:
|
| Включить трассировку | Нет | Установите флажок, чтобы включить сбор трассировки запросов. Настройка вступает в силу после развертывания. Читайте подробнее в статье Трассировка запросов. |
Связанные списки
- Экземпляр MAI – список связанных экземпляров сервиса, RabbitMQ, Redis, ClickHouse и хранилища токенов.
- Очередь общей зоны – задачи развертывания и обслуживания, отправленные для этой инфраструктуры.
Действия Инфраструктура Middleware
Все действия расположены в бургер-меню формы.
| UI-действие | Описание |
|---|---|
| ✅ Развернуть | Нажмите, чтобы развернуть инфраструктуру и ее компоненты. |
| ❌ Удалить | Нажмите, чтобы остановить инфраструктуру. Действие доступно пользователю с ролью mai_admin в статусах Развернута, Ошибка развертывания и Ошибка удаления. |
| Обновление конфигурации → ⬆️ Нексусы | Нажмите, чтобы отправить на платформу состав и параметры нексусов. Действие доступно в статусе Развернута. |
| Обновление конфигурации → ⬆️ Лимиты | Нажмите, чтобы отправить на платформу ограничения пропускной способности и квоты. Действие доступно в статусе Развернута. |
| Обновление конфигурации → ⬆️ Потребители | Нажмите, чтобы отправить на платформу состав потребителей и доступные им нексусы. Действие доступно в статусе Развернута. |
| Обслуживание → TSI → Пересоздать потребителя | Нажмите, чтобы запустить принудительное пересоздание обработчика, например, в случае изменения конфигурации связанной записи из таблицы Потребитель RabbitMQ (sys_rabbitmq_consumer) на некорректную. |
| Обслуживание → TSI → Автовосстановление | Нажмите, чтобы проверить наличие и корректность настроек указанного потребителя RabbitMQ. В случае отсутствия связанной записи она будет создана, в случае некорректности настроек они будут исправлены на актуальные. |
| Обслуживание → CMS → Автовосстановление | Нажмите, чтобы проверить и исправить настройки поставщика RabbitMQ, указанного в поле Producer. Выполните это действие после изменения полей DNS или IP-адрес: адрес поставщика зависит от них, и без исправления сообщения об изменении конфигураций перестанут доходить до инфраструктуры. |
| Обслуживание → CMS → Пересоздать поставщика | Нажмите, чтобы пересоздать поставщика RabbitMQ, если исправить его настройки действием Автовосстановление не удалось. |
Действия развертывания конфигураций Deploy Nexus Configuration, Deploy Limits Configuration, Deploy Multipliers и Deploy sApps Inst, доступные в предыдущих версиях, убраны. Развертывание выполняется одним действием ✅ Развернуть, а конфигурации инфраструктура забирает сама. Читайте подробнее в статье Доставка конфигураций.
Развертывание инфраструктуры
- Откройте запись инфраструктуры.
- Убедитесь, что заполнены поля DNS, IP-адрес, Тип окружения и пути для API, RabbitMQ и ClickHouse.
- В бургер-меню выберите ✅ Развернуть.
Инфраструктура переходит в статус Отправлена на развертывание, а после успешного развертывания – в Развернута. Если развертывание завершилось ошибкой, запись переходит в статус Ошибка развертывания; повторить развертывание можно тем же действием.
При первом развертывании система автоматически создает служебную учетную запись, через которую платформа читает конфигурации из панели управления. Учетная запись не отображается в навигаторе и недоступна для редактирования, пароль хранится в зашифрованном виде. Повторное развертывание переиспользует существующую запись.
До первого развертывания конфигурации недоступны платформе, потому что служебная учетная запись еще не создана. Это нормальное состояние новой инфраструктуры.
Остановка инфраструктуры
- Откройте запись инфраструктуры в статусе Развернута, Ошибка развертывания или Ошибка удаления.
- В бургер-меню выберите ❌ Удалить.
- Подтвердите действие, введя название инфраструктуры.
Инфраструктура переходит в статус В процессе удаления, а после завершения – в Остановлена.
Остановка необратима. Запись инфраструктуры сохраняет параметры подключения и конфигурации, но исторические данные не сохраняются, а сама запись становится недоступной для редактирования. Развернуть инфраструктуру повторно из этой записи нельзя – создайте новую.