3.02.02 Сервисы и размещение данных
Основные компоненты
| Компонент | Назначение |
|---|---|
| Nginx | Публикация портала и сервисов, обработка HTTPS |
| Frontend | Пользовательский интерфейс |
| API Manager | Приём запросов интерфейса и взаимодействие с прикладными сервисами |
| Keycloak | Аутентификация, OIDC и интеграция с каталогом |
| Сервисы активов и справочников | Основные объекты и справочные данные |
| Файловый сервис | Приём файлов и работа с объектным хранилищем |
| Сервис отчётов | Формирование отчётов |
| Сервис аудита | Регистрация изменений сущностей |
| Сервисы бизнес-правил и процессов | Выполнение правил и процессов |
| Почтовый сервис | Отправка уведомлений |
| PostgreSQL | Реляционные данные приложения и Keycloak; внешний по отношению к Compose |
| MongoDB | Документные данные компонентов |
| Neo4j | Графовые данные |
| S3-совместимое хранилище | Файлы; внешнее по отношению к Compose |
| RabbitMQ | AMQP-обмен между сервисами и события Keycloak |
| Kafka | Временная очередь сообщений Discovery и NetBox worker |
| Valkey | Кэш |
RabbitMQ и Kafka — разные компоненты, а не взаимозаменяемые варианты одного брокера.
В проверяемом Compose-комплекте нет сервисов postgres и minio. Параметр DB_HOST задаёт адрес внешней PostgreSQL, а FILESTORAGE_HOST — объектного хранилища. Не используйте команды docker compose … postgres или … minio для этого комплекта. Аналитика Superset разворачивается отдельным комплектом и использует собственный Redis; его не следует путать с Valkey приложения.
Получите список сервисов
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --services
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env ps
Для команд Compose используйте имя из config --services. Оно может отличаться от имени контейнера в docker ps.
Определите расположение данных
- Получите имена контейнеров:
sudo docker ps --format '{{.Names}}'
- Просмотрите подключённые хранилища. Пример для MongoDB:
sudo docker inspect --format '{{range .Mounts}}{{println .Type .Source "->" .Destination}}{{end}}' mongo
- Для именованного тома получите mountpoint:
sudo docker volume inspect --format '{{.Mountpoint}}' '<VOLUME_NAME>'
В bind mount поле Source указывает каталог хоста. Каталог установки с конфигурацией и каталоги постоянных данных учитываются раздельно.
Карта данных Compose-установки
| Компонент | Размещение и сохранность |
|---|---|
| PostgreSQL | Внешний сервер или кластер. Дампы выполняются по сети средствами PostgreSQL; тома Compose не содержат эти БД |
| MongoDB | Именованный том mongo_data → /data/db |
| RabbitMQ | Именованный том rabbitmq_data → /var/lib/rabbitmq/mnesia/ |
| Neo4j | Именованный том neo4j → /data |
| Объектное хранилище | Внешнее S3-совместимое хранилище. Его данные и служебные метаданные копируются средствами площадки хранения |
| Valkey | Bind mount /opt/itam/data → /data; в типовой схеме содержит восстанавливаемый кэш |
| Keycloak | /opt/itam/kcimports содержит файлы начального импорта, а не актуальную БД realm |
| Kafka | Постоянный том не используется; сообщения образуют временную очередь и не входят в резервную копию |
Проверяйте фактические Mounts контейнеров, а не только верхний список volumes в YAML. Физические имена Docker volumes получают префикс проекта.
Kafka можно пересоздавать без переноса writable layer, если назначение очереди остаётся временной. Перед пересозданием остановите производителей и дождитесь обработки накопленных сообщений либо зафиксируйте допустимость их повторного формирования. После восстановления проверьте Discovery и при необходимости повторите задачу обнаружения. Не копируйте вручную служебные каталоги /var/lib/docker.
Определите образы своей установки
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env config --images
sudo docker compose -f /opt/itam/docker-compose.yml --env-file /opt/itam/.env images
Первая команда показывает образы из конфигурации, вторая — образы созданных контейнеров. Для обновления и обращения в поддержку сохраняйте также image ID и digest. Не используйте статический перечень тегов из документации как замену инвентаризации сервера.
Результат: определены фактические сервисы, внешние хранилища, постоянные данные и образы установки.