Установка DVT

В этой статье описан удобный способ установки DVT на рабочую станцию с помощью единого командного скрипта. Он автоматически подготовит окружение, проверит все необходимые зависимости и запустит сервисы системы.

DVT разворачивается в среде Docker под управлением ОС Linux.

В видео продемонстрирован пример развертывания dbt (DVT) в Yandex Cloud:

Установка Docker

Обновите список пакетов:

sudo apt update

Откройте файл источников пакетов для редактирования:

sudo nano /etc/apt/sources.list

Обновите установленные пакеты:

sudo apt upgrade -y

Установите необходимые зависимости:

sudo apt install -y ca-certificates curl gnupg

Создайте директорию для ключей:

sudo install -m 0755 -d /etc/apt/keyrings

Добавьте GPG-ключ Docker:

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Установите права доступа на ключ:

sudo chmod a+r /etc/apt/keyrings/docker.gpg

Добавьте репозиторий Docker в систему:

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Повторно обновите список пакетов:

sudo apt update

Установите Docker и сопутствующие компоненты командой

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Далее можно переходить к установке DVT.

Установка DVT

Установка по умолчанию

Запустите установочный скрипт:

bash <(sudo curl -fsSL https://raw.distribution.denvic.tech/dvt/install.sh)

Скрипт запустится и перейдёт в интерактивный режим настройки.

После запуска отображается приветствие:

🚀 Добро пожаловать в установщик DVT

Далее последовательно будут заданы параметры окружения.

🔑 Лицензионный ключ

Скрипт запросит лицензионный ключ и выполнит его проверку на сервере лицензий:

🔑 Введите лицензионный ключ DVT.
> XXXXX-XXXXX-XXXXX

При успешной проверке выводится подтверждение.

🗄 Каталог данных

Необходимо указать каталог, где будут храниться данные PostgreSQL, Redpanda и файлов окружения:

🗄  Каталог для данных DVT
По умолчанию: /var/lib/dvt
> /mnt/dvt

Каталог создаётся автоматически.

🌐 Публичный URL

Устанавливается адрес, по которому вы будете открывать интерфейс DVT:

🌐 Публичный URL DVT
Например: http://localhost или https://dvt.company.local
> http://localhost

Скрипт автоматически определяет необходимость использования Secure cookies.

⚙️ Выбор версии образов

Укажите Docker‑tag:

Введите версию DVT (docker tag) или оставьте latest:
> latest

🗄 Параметры PostgreSQL

Скрипт разворачивает встроенный PostgreSQL и предлагает задать параметры:

Имя пользователя PostgreSQL: [dvt-user]
Имя базы PostgreSQL: [DVT]
Пароль PostgreSQL (пусто = сгенерировать случайный): > ******

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

🔑 Аккаунт администратора

Создаётся первый пользователь админ‑панели:

Имя пользователя администратора: [dvt-admin]
Пароль администратора (пусто = сгенерировать случайный): > ******

🔐 Токены внутренних сервисов

Генерируются ключи для Store Service, gRPC Forward Service и Fernet. Каждый можно ввести вручную или оставить генерацию скрипту.

⚙️ Формирование .env

Установщик автоматически создаёт файл окружения .env в каталоге установки. В нём хранятся параметры доступа к БД, токены сервисов, публичный URL и настройки контейнеров.

При наличии существующего .env создаётся резервная копия.

📋 Итоговая конфигурация

Перед запуском сервисов отображается краткое резюме параметров:

Сводка конфигурации:
  Лицензионный ключ: XXXXX...
  Каталог данных:    /var/lib/dvt
  Публичный URL:     http://localhost
  Версия образов:    latest
Продолжить установку? [Y/n]

🚀 Запуск сервисов

Скрипт скачивает файл docker-compose.yaml, авторизуется в Container Registry и запускает DVT:

🚀  Запускаем DVT через 'sudo docker compose -f /var/lib/dvt/docker-compose.yaml up -d'

После старта появится сообщение:

✓  DVT запущен.
Откройте в браузере: http://localhost

Установка не в интерактивном режиме

Также есть возможность запустить установщик не в интерактивном режиме.
Флаги установщика DVT:

Пример:

sudo bash install.sh -n --license XXXXX --version 1.15.0 --public-url https://dvt.example.ru

Полезные рекомендации

• Установщик полностью интерактивный — достаточно отвечать на вопросы по порядку.

• Для продвинутых сценариев возможна автоматизация через параметры окружения и предварительно подготовленный .env.

• Все данные и конфигурации располагаются в каталоге, который вы указали на этапе установки.

После завершения установки система готова к работе, а все контейнеры можно посмотреть командой:

sudo docker ps