🛠️ Локальный запуск микросервисов PrimoART в Docker (Linux)

1. Подготовка архива

Загрузить архив PrimoART_Docker_dd_mm_yyyy на целевой сервер, разархивировать его и перейти в созданную директорию.

2. Загрузка Docker-образов

Перейти в каталог docker_images и загрузить все образы:

cd docker_images
sudo docker load -i <image_1>
...
sudo docker load -i <image_n>
cd ..

3. Настройка ОС под OpenSearch

Дать права для opensearch (uid=1000(opensearch) gid=1000(opensearch) groups=1000(opensearch)) на volume

sudo chown -R 1000:1000 ./volumes/opensearch/data

Увеличить vm.max_map_count в OS

echo 'vm.max_map_count=262144' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

4. Запуск хранилищ

sudo docker compose -f docker-compose-storages.yml up -d

5. Настройка nginx

Добавить в файл volumes/nginx/nginx.conf новый location

location /api/v1/trace-viewer-url {
    default_type application/json;
    return 200 '{"url":"https://<trace_viewer_url>:5173"}';
}

Изменить URL на корректный.

6. Запуск микросервисов

sudo docker compose -f docker-compose-microservices.yml up -d

7. Выпуск самоподписанных сертификатов

Для выпуска сертификатов предполагается использование mkcert — простой утилиты для генерации локально-доверенных сертификатов с собственным центром сертификации.

7.1. Установить mkcert (пример для Debian)

sudo apt install mkcert

7.2. Создать локальный Root CA

mkcert -install
mkcert -CAROOT

rootCA.pem — корневой сертификат, его нужно добавить в доверенные CA на клиентских машинах.

7.3. Создать сертификатов

Создать сразу в volumes/certs и выдать права на файлы

mkcert -cert-file volumes/certs/dev.crt -key-file volumes/certs/dev.key <portal_name> <portal_ip>
mkcert -cert-file volumes/certs/dev_tv.crt -key-file volumes/certs/dev_tv.key <tv_name> <tv_ip>
sudo chmod 644 volumes/certs/*

8. Запуск trace-viewer

sudo docker compose -f docker-compose-tv.yml up -d

9. Запуск UI

sudo docker compose -f docker-compose-portal.yml up -d

✔️ Проверка работы UI

Откройте в браузере:

https://<host_address>:8443