Архитектура SALT.BOX
Таблица 1. Взаимодействия компонентов, контейнеров и подсистем программного комплекса SALT.BOX
| № | Описание |
|---|---|
| 1 | Взаимодействие пользователя с веб-приложением (https) |
| 2 | Веб-приложение работает с API-шлюзом через прокси |
| 3 | Для выполнения процедуры аутентификации логин и пароль пользователя передаются системе KeyCloak |
| 4 | KeyCloak использует СУБД PostgreSQL для хранения регистрационных данных пользователя и хеша его пароля |
| 5 | Интеграция KeyCloak с корпоративным каталогом LDAP позволяет использовать существующие учетные записи пользователей. Использование OpenID Connect обеспечивает единый вход для всех подключённых приложений |
| 6 | KeyCloak выдаёт JSON Web Token (JWT) для доступа веб-приложения к компонентам SALT.BOX |
| 7 | JWT передаётся в составе любого запроса веб-приложением |
| 8 | API-шлюз выполняет валидацию JWT, полученного в составе запроса, в системе KeyCloak |
| 9 | Если JWT валиден, API-шлюз запрашивает у OPA (Open Policy Agent) политику доступа пользователя-владельца токена к SALT.BOX |
| 10 | Проверка обновлений, получение, упаковка и сохранение изменений в бандлах (bundles) |
| 11 | Если политика доступа разрешает пользователю выполнение запроса, API-шлюз транслирует запрос Ядру SALT.BOX — интерфейсу ядра программного комплекса SALT.BOX |
| 12 | Ядро SALT.BOX сохраняет временные данные (данные pillars, команды, результаты выполнения команд), в Redis store — хранилище ключ-значение на базе Redis |
| 13 | «Движок» (engine) контроллера SALT.BOX (например, модуль подключения сервера SALT.BOX Bridge) имеет доступ к хранилищу Redis store, получают из него данные и сохранят результаты выполнения — Job Return — и прочие структуры данных. Результаты выполнения задач сохраняются с заданным временем жизни (TTL) |
| 14, 15 | Ядро SALT.BOX осуществляет синхронные вызовы (RPC) и обработку событий (Events) через брокер сообщений на базе Redis Pub/Sub channels, управляемый фреймворком FastStream |
| 16 | Статические данные (коллекции, параметры клиентов и контроллеров SALT.BOX, схемы команд, шаблоны задач, настройки SALT.BOX) хранятся в БД под управлением MongoDB* |
| 17 | Ответ Ядра SALT.BOX на запрос API-шлюзу о статусе выполнения команд и задач на стороне агентов |
| 18 | API-шлюз транслирует ответ веб-приложению для отображения результата пользователю |
| 19 | Ядро SALT.BOX осуществляет запуск продолжительных асинхронных задач посредством Taskiq, используя RabbitMQ в качестве брокера сообщений |
| 20 | Трансляция вызова метода Salt рабочему процессу контроллера SALT.BOX для публикации задачи (Job) агентам |
| 21 | Передача ответа агента (Job Returns) Рабочему процессу контроллера SALT.BOX |
| 22 | Взаимодействие контроллера SALT.BOX с «Движком» (engine) (передача команд, получение событий из шины) |
| 23 | Рабочий процесс контроллера SALT.BOX передаёт задание для публикации агентам |
| 24 | Получение задачи (Job) агентом |
| 25 | Передача SLS-файлов (Pillars и стейтов) и файлов ресурсов |
| 26 | Ответ агента (Job Returns) контроллеру SALT.BOX |
| 27 | Передача задачи (Job) в рабочий поток (Jobber) агента |
| 28 | Если политика доступа разрешает пользователю выполнение запроса, API-шлюз транслирует запрос Модулю расширения |
| 29 | Сохранение статических данных модуля расширения |
| 30 | Получение Рабочими процессами Модуля расширения данных для запуска фоновых задач |
| 31 | Ответ Модуля расширения на запрос API-шлюза со статусом и данными о выполнения заданий планировщика |
| 32 | Модуль расширения осуществляет запуск продолжительных асинхронных задач посредством Taskiq, используя RabbitMQ в качестве брокера сообщений |
| 33 | Компонент Модуля расширения взаимодействует с экземпляром Redis Ядра SALT.BOX, получают из него и сохранят Runtime-данные, относящиеся к процессу выполнения заданий планировщика |
| 34 | Данные WebSocket для отображения в реальном времени |