Перейти к содержанию

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.

Определите расположение данных

  1. Получите имена контейнеров:
sudo docker ps --format '{{.Names}}'
  1. Просмотрите подключённые хранилища. Пример для MongoDB:
sudo docker inspect --format '{{range .Mounts}}{{println .Type .Source "->" .Destination}}{{end}}' mongo
  1. Для именованного тома получите 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. Не используйте статический перечень тегов из документации как замену инвентаризации сервера.

Результат: определены фактические сервисы, внешние хранилища, постоянные данные и образы установки.