¶ Настройка
Для начала работы, нужно:
- Скачать и установить Docker Desktop, актуальной версии с сфициального сайта.
После установки и запуска Docker Desktop, он может попросить установить WSL, соглашаемся. - Скачать и установить Git, актуальной версии с сфициального сайта. При установке на всех страницах инсталлятора просто жмём Далее.
-
Установить Docker Desktop и открыть раздел Containers
-
Внутри раздела Containers открыть терминал, для дальнейшего клонирования репозитория.
- Нужно сделать клон репозитория с локальной версией DataLens:
git clone https://github.com/datalens-tech/datalens
cd datalens
- Далее убедится, что установлен Docker Desktop. Запуск сервиса:
$env:UI_port="8081"
docker compose up
Убедитесь в том, чтобы выбираемый порт был свободен.
- После запуска открыть интерфейс по адресу:
http://localhost:8081
- Войти в систему можно с учетными данными администратора по умолчанию:
▸ Логин: admin
▸ Пароль: admin
¶ Настройка импорта шаблонов
- Нужно посмотреть, что в docker-compose.yaml присутствует блок meta-manager. Ниже — минимальная конфигурация:
meta-manager:
container_name: datalens-meta-manager
image: ghcr.io/datalens-tech/datalens-meta-manager:0.40.0
...
depends_on:
temporal:
condition: service_healthy
ui-api:
condition: service_started
- Далее нужно добавить параметр в docker-compose.yaml
Нужно перейдите в корневую папку проекта datalens (обычно расположена по пути:
C:\Users\ИМЯ_ПОЛЬЗОВАТЕЛЯ\datalens), открыть файл docker-compose.yaml и найдите блок ui-api (или ui, если в нем указаны переменные окружения).
Добавьте переменную FEATURE_WORKBOOK_EXPORT_ENABLED: true, чтобы включить поддержку импорта/экспорта воркбуков:
Пример:
ui-api:
image: ghcr.io/datalens-tech/datalens-ui:0.3049.0
container_name: datalens-ui-api
environment:
FEATURE_WORKBOOK_EXPORT_ENABLED: true
# другие переменные
- Если кнопка импорта не появилась:
- Убедитесь, что контейнер meta-manager запущен:
docker ps
- Также нужно расширить блок UI, а именно добавить (где "10.1.12.162" - это ip-адрес сетевого интерфейса машины):
#
HC: ${HC:-1}
HC_ENDPOINT: "10.1.12.162:8080/build"
HC_PROTOCOL: "http"
HC_MODULES: "exporting,export-data,stock,treemap"
#
volumes:
- ./highcharts/8.2.2/:/opt/app/dist/public/build/8.2.2/
#
- Шаблоны не подтягиваются из облачной версии, поэтому нужно отдельно их подгрузить и положить в корневую папку с Datalens
Ниже приложен документ, с примером как должен быть заполнен файл docker-compose.yaml:
- Для того, чтобы подгрузились шаблоны, нужно скачать архив приложенный ниже и закинуть его в папку с DataLens:
Корневая папка примет следующий вид:
При любых изменениях нужно пересобирать сервис:
docker compose down docker compose up --build
¶ Настройка подключения к бд
После загрузки шаблона будет доступно поле заполнения данных для подключения к бд, где нужно указать ip-адрес, который прописан в IP4. Порт должен соответствовать порту SQL сервера, который укеазан в настройках TCP/IP вашего экземпляра, посмотреть можно с помощью SQL Server Configuration Manager.
Чтобы посмотреть свой ip-адрес, нужно зайти в SQL Server Configuration Manager и выбрать нужную сетевую конфигурацию. После зайти в TCP/IP.
Далее нужно найти IP4 и при необхомости изменить данные на нужные. Адрес и порт обязательно должны быть те же, что будут использоваться в подключении к бд в Datalens.
IPAll должен иметь такой же порт как в IP4
¶ Возможные ошибки и решения
- temporal exited (1) — проверьте правильность пароля к PostgreSQL (пользователь pg-user).
- Нет кнопки импорта — убедитесь, что переменная FEATURE_WORKBOOK_EXPORT_ENABLED указана, а контейнер meta-manager запущен.
- Ошибка импорта с Request-ID — проверьте логи meta-manager и убедитесь, что все зависимости доступны.
- ERR.DS_API.DB.SOURCE_ERROR.TIMEOUT — возможна ошибка подключения к внешней базе, проверьте IP и разрешённые порты.
- admin/admin не подходит — убедитесь, что авторизация включена и не переопределена в переменных окружения.
- Подключение зависло — убедитесь, что порт 8081 открыт, и контейнеры работают.
- 500 Internal server error — нужно сменить имя шаблона, ошибка означает, что используются недопустимые символы.