Установка Glarus BI в Docker Compose¶

В данном подразделе описаны шаги для получения экземпляра Glarus BI в среде Docker Compose.

Поддерживаемые операционные системы¶

Glarus BI создаётся и упаковывается в контейнере Docker. Поэтому для запуска системы требуется актуальная (ещё поддерживаемая) Unix-совместимая операционная система с поддержкой Docker.

Перечень операционных систем для Docker можно получить на docs.docker.com.

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

Также Glarus BI совместима с:

Astra Linux Special Edition РУСБ.10015-01 (очередное обновление 1.7). Сертификат соответствия от 08.09.2023 №13977/2023;
ОС РЕД ОС. Сертификат совместимости от 15.01.2024.

Предварительные условия¶

Для запуска стека Glarus BI используется среда Docker Compose.
Для запуска нужен сервер или рабочая станция с установленными пакетами Docker актуальной на момент установки версии.
Служба docker должна быть запущена.
Для развёртывания нужно получить в службе технической поддержки архив с настройками среды.
Вам понадобится команда с логином и паролем для доступа к репозиторию Glarus Digital. Команда находится в текстовом файле инструкции README.md внутри архива для установки.

Распаковка настроек¶

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

mkdir glarus_bi
unzip docker_config-main.zip -d glarus_bi/ && cd glarus_bi/docker_config-main

Создание паролей для баз данных¶

Система поставляется с колоночной СУБД ClickHouse и реляционной СУБД Postgres. Для работы с данными будет создан отдельный пользователь glarusbi с расширенными правами.

Для предустановки паролей используется скрытый файл .env. Используйте консольные инструменты для редактирования файла или включите отображение скрытых файлов, чтобы найти его в списке графического менеджера файлов.

Придумайте пароли для каждой СУБД и в файле .env замените фразу <YOUR_PASSWORD> на придуманные вами пароли:

PG_PASSWORD;
CLICK_PASSWORD.

Не забудьте сохранить файл при выходе.

Авторизация в репозитории Glarus Digital¶

Откройте файл README.md, найдите строку для доступа к репозиторию Glarus Digital, она содержит логин и пароль. Скопируйте её целиком (из вашего файла) и выполните в консоли. Ниже приведён пример подобной строки.

docker login registry.glarus-digital.ru -u <логин> -p <пароль>

Получение образа и запуск контейнеров¶

Всё готово к началу установки. Запустите процесс в консоли, выполнив команду:

docker compose up -d

Примечание

Команда docker compose может выполняться как docker-compose (написание через дефис) — это зависит от версии ОС и пакетов.

Дождитесь завершения процесса. Веб-интерфейс системы будет запущен на порту 3000.

Проверка доступа к веб-интерфейсу¶

Откройте браузер и составьте ссылку из адреса вашего сервера и порта 3000. Например:

https://localhost:3000

Система должна отобразить форму с кодом запроса лицензии. Серверу приложений может понадобиться какое-то время на запуск, но не более 3 минут. Если формы с кодом лицензии нет, установка выполнена с ошибками. В этом случае воспользуйтесь журналами контейнеров, попытайтесь переустановить Glarus BI или обратитесь в нашу техническую поддержку.

Ввод кода подтверждения лицензии¶

Если вы определились с размещением системы (ключ "привязывается" к серверу), сообщите в нашу техподдержку код запроса лицензии и другие данные для выпуска ключа (см. подраздел "Работа с лицензионным ключом Glarus BI".

После проверки мы выпустим лицензию и вышлем код подтверждения.

Введите код подтверждения в соответствующую форму в веб-интерфейсе системы.

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

После активации лицензии не откладывайте предварительную настройку системы. Система сейчас разблокирована, и создать первую учётную запись администратора может любой пользователь, имеющий доступ к вашему серверу по http или https.

Начало работы с системой¶

После успешного ввода лицензии вы попадаете в мастер настройки в веб-интерфейсе, который поможет создать первого пользователя с правами администратора, установить пароль и подключить дополнительные источники данных.

Рекомендуем обзорный ролик "Весь Glarus BI для разработчика дашбордов за 15 минут!".

Известные проблемы и решения¶

Не работает команда `docker compose`¶

Выполните установку Docker согласно официальной документации Docker. Вам нужен пакет docker-compose-plugin. Если он не может установиться, и ОС поддерживается Docker, то скорее всего вы пытаетесь установить Docker из репозитория ОС, а не из репозитория Docker.

Docker сообщает о проблемах доступа к docker.sock¶

Добавьте пользователя в группу docker и примените изменения (ссылка на stackoverflow, англ.).

Не удаётся авторизоваться в registry.glarus-digital.ru. Docker не принимает пароль в текстовом виде¶

Если команда не может выполниться из-за повышенных требований к безопасности Docker, сохраните пароль в отдельный файл password.txt, расположите его в каталоге, куда распакован архив, и повторите попытку с изменённой командой:

cat password.txt | docker login registry.glarus-digital.ru -u <логин> --password-stdin

В архиве нет файла .env¶

Файл есть, но он скрытый. Включите отображение скрытых файлов в утилите, которую используете для работы с файлами. Например, в консоли команду ls -a вместо ls.
Такое может быть, если вы получали архив для установки до ноября 2025. Запросите в нашей техподдержке актуальный архив.

Glarus BI не запускается после установки¶

Более подробную информацию вы можете получить командами docker compose logs, docker logs <контейнер>, а список контейнеров — с помощью docker ps.