Установка системы возможна на GNU/Linux дистрибутивы (включая отечественные: AstraLinux, AltLinux, RedOS и иные).
Рекомендация по ресурсам: 16Gb RAM, 8 ядер CPU.

Дополнительно стоит убедиться, что раздел, на котором размещается директория с данными docker (data-root docker, по умолчанию /var), должен быть не менее 20Gb при этом для бесперебойного функционирования системы необходимо резервировать дисковое пространство из расчета размера загружаемых файловых вложений.

Требования к инфраструктуре

Установка системы

Дистрибутив системы представляет собой набор следующих артефактов:
докер-образы;
установочный файл docker-compose.yml для запуска системы на сервере;
шаблон конфигурации (.env.example);
инструкция.
Команды, указанные в инструкции, выполняются от имени суперпользователя root.

Подготовка окружения

Установить Docker Engine под нужную операционную систему в соответствии с документацией:
https://docs.docker.com/engine/install/.
Установить Docker Compose и docker compose в соответствии с документацией: https://docs.docker.com/compose/install/.
Примечание: Требуется использование docker compose не ниже версии 2.0

Подготовка установочных файлов

Если дистрибутив получен на физическом носителе
Скачать архив с установочными файлами, распаковать.
Перейти в директорию c распакованными файлами.
Импортировать docker-образы, выполнив команды:
docker load < images/n3pm-backend.image
docker load < images/n3pm-frontend.image

Если дистрибутив скачивается посредством доступа к серверам вендора через интернет
Авторизоваться на сервере с дистрибутивами по адресу gitlab.develop.netrika.ru. Адрес сервера, сетевой доступ, логин и пароль, предоставляется вендором.
Скачать архив с установочными файлами, распаковать. Архив доступен по ссылке: https://gitlab.develop.netrika.ru/products/n3pm/-/archive/main/n3pm-main.tar.gz.
Перейти в директорию c распакованными файлами.
Авторизоваться в приватном реестре docker-образов системы при помощи команды:
docker login gitlab.develop.netrika.ru:4567
Адрес сервера, сетевой доступ, логин и пароль, предоставляется вендором.

Запуск системы
Перейти в каталог docker при помощи команды: cd docker
Скопировать шаблонный файл с настройками при помощи команды: cp .env.example .env
Выполнить команду для запуска системы: docker compose up -d --force-recreate --remove-orphans
Дождаться запуска системы. После запуска система будет доступна на локальном порту http://127.0.0.1:8080/
После первого запуска, для выполнения административных операций потребуется создать первого суперпользователя с помощью команды:
docker compose run --rm management createsuperuser
В процессе система попросит ввести e-mail и пароль.
После создания суперпользователя их можно использовать для авторизации в системе, в том числе в административной панели.

1. Авторизоваться в приватном реестре docker-образов системы при помощи команды: docker login gitlab.develop.netrika.ru:4567 Адрес сервера, сетевой доступ, логин и пароль, предоставляется вендором.
2. Перейти в каталог с установочными файлами дистрибутива
3. Отредактировать файл настроек .env, указав желаемую версию системы в качестве значения параметра N3PM_VERSION, например: # старое значение N3PM_VERSION=4.1.0 # новое значение N3PM_VERSION=4.2.0
4. Скачать новые версии компонентов системы, выполнив команду docker compose pull
5. Выполнить команду для остановки системы docker compose down
6. Выполнить команду для запуска обновления и последующего старта системы docker compose up -d --force-recreate --remove-orphans

После запуска данной команды система будет недоступна до окончания процедуры обновления.

Обновление системы