Запуск Glarus BI на Podman¶

Glarus BI совместим с любой системой, на которой работает Podman.

Быстрый старт¶

Предполагая, что у вас установлен и запущен Podman, получите последний образ контейнера (данные запросите в технической поддержке, ниже показан синтетический пример):

podman pull docker.io/repo/glarus-bi:latest

Затем запустите контейнер Glarus BI:

podman run -d -p 3000:3000 --name=glarusbi docker.io/repo/glarus-bi:latest

Это запустит сервер Glarus BI на порту 3000 по умолчанию.

Опционально: чтобы просмотреть логи во время инициализации Open Source Glarus BI, выполните:

podman logs -f glarusbi

После завершения запуска вы можете получить доступ к вашему Open Source Glarus BI по адресу http://localhost:3000.

Чтобы запустить ваш Open Source Glarus BI на другом порту, например, на порту 12345:

podman run -d -p 12345:3000 --name=glarusbi docker.io/repo/glarus-bi:latest

Установка для промышленной эксплуатации¶

Glarus BI поставляется со встроенной базой данных H2, которая использует файловую систему для хранения своих собственных данных приложения. Это означает, что если вы удалите контейнер, вы потеряете данные приложения Glarus BI (ваши вопросы, дашборды, коллекции и так далее).

Если вы хотите запустить Glarus BI в производственной среде, вам нужно хранить данные вашего приложения в базе данных, готовой к промышленной эксплуатации.

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

Запуск Podman в производственной среде¶

Допустим, вы создали базу данных Postgres, выполнив:

createdb glarusappdb

Нет необходимости добавлять какие-либо таблицы; Glarus BI создаст их при запуске. И предположим, что эта база данных доступна через my-database-host:5432 с именем пользователя name и паролем password.

Вот пример команды Podman, который указывает Glarus BI использовать эту базу данных:

podman run -d -p 3000:3000 \
  -e "MB_DB_TYPE=postgres" \
  -e "MB_DB_DBNAME=glarusappdb" \
  -e "MB_DB_PORT=5432" \
  -e "MB_DB_USER=name" \
  -e "MB_DB_PASS=password" \
  -e "MB_DB_HOST=my-database-host" \
   --name glarusbi repo/glarus-bi

Имейте в виду, что Glarus BI будет подключаться изнутри вашего контейнера Podman, поэтому убедитесь, что либо: a) вы используете полностью квалифицированное имя хоста, либо b) вы установили правильную запись в файле /etc/hosts вашего контейнера.

Миграция на производственную установку¶

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

Дополнительное обслуживание и настройка Podman¶

Запуск Glarus BI как службы¶

Мы можем использовать службу инициализации systemd для регистрации службы Glarus BI, которая может запускаться и останавливаться автоматически. Перед выполнением этого процесса убедитесь, что контейнер Glarus BI работает. Затем используйте встроенную функцию Podman для создания файла службы следующим образом:

sudo podman generate systemd --new --name glarusbi > glarusbi.service

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

sudo mv glarusbi.service /etc/systemd/system

Чтобы включить автоматический запуск службы Glarus BI во время загрузки системы, выполните:

sudo systemctl enable glarusbi

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

Настройка сервера Glarus BI Jetty¶

Вы можете использовать любые пользовательские настройки из Настройка веб-сервера Glarus BI Jetty, установив переменные окружения в команде запуска Podman.

Установка часового пояса Java¶

Лучше всего установить часовой пояс Java так, чтобы он совпадал с часовым поясом, в котором вы хотите получать все отчеты. Вы можете сделать это, просто указав переменную окружения JAVA_TIMEZONE, которую подхватывает скрипт запуска Glarus BI. Например:

podman run -d -p 3000:3000 \
  -e "JAVA_TIMEZONE=Europe/Moscow" \
  --name glarusbi repo/glarus-bi

Устранение неполадок¶

См. "Запуск Glarus BI" в Руководстве по устранению неполадок.

Продолжение настройки¶

Теперь, когда вы установили Glarus BI, пришло время настроить его и подключить к вашей базе данных.