Репозиторий Docker

Внимание

Дисклеймер.

Инструкция содержит примерный порядок действий по установке. Инструкция призвана описать логику действий по установке на простом абстрактном примере. В зависимости от инфраструктуры сервера (кластера) и его конфигурации вам могут понадобиться дополнительные/иные шаги.

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

При старте системы требуется проверить backend лог на предмет ошибок ERROR. В случае их наличия - обратитесь к разработчику.

Рекомендуемый способ установки Юниверс – c использованием Docker. Официальная документация Docker.

Система при желании может быть установлена вручную. Такой способ установки требует специальных навыков. См. примеры инструкций ручной установки на Ubuntu в закрытом контуре и с доступом к интернету. Для корректной работы сборки необходимо, чтобы синхронизация с NTP сервером была включена на хосте, где будет запущена сборка.

Примечание

Текущая инструкция содержит пример установки через Docker. Для установки необходимо иметь репозиторий с дистрибутивом Юниверс в виде образов Docker.

Предупреждение

В Юниверс DG версии 2.10 было осуществлено обновление PostgreSQL до версии 16.3, в связи с этим теперь требуется обязательная установка расширения TimescaleDB для корректной работы с большими объемами данных. Перед установкой рекомендуется проверить совместимость вашей версии PostgreSQL и версии TimescaleDB.

Подготовка к установке

Подготовка сервера:

  • Обновите существующий список пакетов Ubuntu. Команда:

    sudo apt update

  • Установите Docker через официальный репозиторий. Документацию см. по ссылке https://docs.docker.com/.

  • Установите Docker Compose (версия выше 1.29).

  • Настройте разрешения для Docker Compose. Пример команды:

    sudo chmod +x /usr/local/bin/docker-compose

  • Установите Git.

Ссылка на репозиторий:

  • Согласно договору поставки Юниверс получите доступ к репозиторию с дистрибутивом вашего продукта.

  • Альтернативный путь: получите архив с Docker-образами дистрибутива, и создайте собственный репозиторий через локальный Dockerhub. Архив будет содержать файл .env, который включает теги на компоненты системы и набор образов для компонентов.

Установка с Docker

Чтобы установить Юниверс DG:

  1. Перед работой с репозиторием, убедитесь, что он добавлен в исключения антивируса.

  2. Убедитесь, что ссылка на репозиторий с дистрибутивом вашего продукта в наличии. О получении ссылки см. выше.

  3. Клонируйте репозиторий из Gitlab или Docker. Пример команды:

    git clone [your-link-universe-platform-deploy.git]

  4. Перейдите в каталог с кодом. Пример команды:

    cd universe-platform-deploy

  5. Для запуска системы используйте команду:

    docker-compose up -d

По умолчанию пользовательский интерфейс доступен для просмотра на localhost:8080.

Логин и пароль по умолчанию: admin/admin. После введения логина и пароля система запросит файл лицензии и смену пароля.

Пользовательская установка с Docker Compose

Примечание

Версия docker-compose должна быть 1.29 или выше

При необходимости используйте docker-compose.yml для создания собственного образа. В файле .env содержится полный перечень доступных переменных.

  1. Создайте файл docker-compose.yml.

  2. Создайте папку hunspell со словарями. См. также инструкцию по настройке библиотеки Hunspell.

  3. Вы можете пересоздать docker-контейнер с новыми настройками с помощью команды:

    docker-compose up -d --build --force-recreate

Пример файла docker-compose.yml см. в статье.

Проверка статуса синхронизации

  • Чтобы проверить статус синхронизации, выполните команду:

    timedatectl

  • Чтобы включить синхронизацию, выполните команду:

    timedatectl -- set-ntp yes

  • Чтобы отключить синхронизацию, выполните команду:

    timedatectl -- set-ntp no