Устранение неполадок Glarus BI в Docker

Docker упрощает многие аспекты работы с Glarus BI, но следует помнить о некоторых "подводных камнях". Если у вас возникли проблемы с Glarus BI в Docker, попробуйте приведённый ниже алгоритм устранения неполадок, а затем посмотрите подробности о конкретной проблеме, которую вы обнаружили, ниже.

1. Контейнер запущен?
2. Сервер работает внутри контейнера?
3. Использует ли Glarus BI правильную базу данных приложения?
4. Можно ли подключиться к хосту Docker через порт Glarus BI?
5. Можно ли подключиться к контейнеру с хоста Docker?
6. Можно ли подключиться к серверу из контейнера?

Следующие полезные команды часто используются при анализе ошибок. Запуск bash внутри контейнера Glarus BI:

docker exec -it CONTAINER_NAME bash

Получение логов ошибок контейнера Glarus BI:

docker logs -f CONTAINER_NAME

Контейнер Glarus BI завершает работу без запуска сервера

Как обнаружить

1. Запустите docker ps, чтобы узнать, запущен ли в данный момент контейнер Glarus BI. Если это так, перейдите к следующему шагу.

2. Если docker ps не показывает работающий контейнер, выведите список остановленных контейнеров, запустив:

docker ps -a | grep repo/image

1. Найдите контейнер, который показан последним, и запишите его идентификатор. Посмотрите на журналы этого контейнера с помощью:

docker logs CONTAINER_ID

Контейнер Glarus BI запущен, но сервер не работает

Как обнаружить

1. Запустите docker ps, чтобы убедиться, что контейнер запущен. Сервер должен регистрироваться в журналах контейнера Docker. Проверьте это, запустив:

docker logs CONTAINER_NAME

1. Вы должны увидеть такую строку в начале:

05-10 18:11:32 INFO metabase.util :: Loading Glarus BI...

1. Ниже вы должны увидеть строку:

05-10 18:12:30 INFO metabase.core :: Glarus BI Initialization COMPLETE

1. Если вы видите строки ниже:

05-15 19:07:11 INFO metabase.core :: Glarus BI Shutting Down ...
05-15 19:07:11 INFO metabase.core :: Glarus BI Shutdown COMPLETE

значит после попытки запуска сервер Glarus BI завершил работу.

Решение

Проверьте журналы контейнера Docker на наличие ошибок при подключении к базе данных приложения. Просмотрите журналы, чтобы убедиться, что Glarus BI всё ещё запущена. Команда

docker logs -f CONTAINER_ID

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

Если контейнер останавливается до завершения запуска, проблема может заключаться в таймауте проверки работоспособности в службе оркестровки, используемой для запуска контейнера, например Docker Cloud или Elastic Beanstalk.

Если контейнер не завершается извне, но всё равно не запускается, эта проблема, вероятно, не специфична для Docker. Если вы используете образ, предоставленный Glarus BI, задайте вопрос в сообществе Glarus BI.

Не подключается к базе данных удалённого приложения

Как обнаружить

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

05-10 18:11:40 INFO metabase.core :: Setting up and migrating Glarus BI DB. Please sit tight, this may take a minute...
05-10 18:11:40 INFO metabase.db :: Verifying h2 Database Connection ...

05-10 18:11:40 INFO metabase.db :: Verify Database Connection ...  ✅

Решение

Убедитесь, что вы правильно передаёте переменные среды в Docker. Вы можете перечислить их для контейнера с помощью этой команды:

docker inspect some-postgres -f '{{ .Config.Env }}'

Сервер Glarus BI не может подключиться к базе данных MySQL или PostgreSQL

Как обнаружить

Журналы контейнера Docker возвращают сообщение об ошибке после строки «Проверка подключения к базе данных».

Решение

1. Попробуйте подключиться с помощью команды mysql или psql с параметрами строки подключения, которые вы передаёте [через переменные среды][база данных конфигурирования-приложения].
2. Если вы не можете подключиться к базе данных, проблема связана либо с учётными данными, либо с подключением. Чтобы убедиться, что учётные данные верны, войдите в систему с этими учётными данными с другого компьютера, а затем попробуйте установить такое же подключение с хоста, на котором запущен контейнер Docker.
3. Один из простых способов запуска — использовать Docker для запуска контейнера с соответствующим клиентом для вашей базы данных. Для Postgres это будет выглядеть так:

docker run --name postgres-client --rm -ti --entrypoint /bin/bash postgres

1. Из этого контейнера попробуйте подключиться к хосту базы данных с помощью клиентской команды в контейнере, например psql. Если вы можете подключиться из другого контейнера на том же хосте, попробуйте установить это подключение из самого контейнера Glarus BI Docker:

docker exec -ti container-name bash

1. Вы также можете попробовать подключиться к хосту базы данных с помощью команды nc и проверить, можно ли открыть соединение:

nc -v your-db-host 5432

Эти шаги помогут вам определить, связана ли проблема с сетью или с проверкой подлинности.

База данных приложения Glarus BI не сохраняется

Как обнаружить

Это происходит, если вы видите экран настройки каждый раз, когда запускаете приложение. Наиболее распространённая причина — база данных приложения не примонтирована к файловой системе, а находится внутри контейнера.

Решение

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

Внутренний порт неправильно переназначается

Как обнаружить

Запустите docker ps и посмотрите на сопоставление портов, затем запустите curl http://localhost:port-number-here/api/health. Это должно вернуть ответ JSON, который выглядит так:

{"status":"ok"}

Решение

Обязательно включите -p 3000:3000 или аналогичное переназначение порта в команду docker run, которую вы используете для запуска образа контейнера Glarus BI.

Glarus BI не может записывать или читать в/из файла или каталога

Как обнаружить

Сообщение в журналах будет явно указывать на ошибку IOError или Отказано в доступе из Java или ошибки из SQLite, содержащие org.sqlite.core.NativeDB._open_utf8.

Решение

1. Убедитесь, что у пользователя, работающего с Glarus BI, есть разрешение на чтение и запись в файл или каталог:

2. Если вы запускаете Glarus BI в виде файла JAR на локальном компьютере или сервере, проверьте пользователя, который запускает процесс Java.

3. Если вы запускаете Glarus BI из контейнера Docker, убедитесь, что вы используете каталог /metabase.db.

4. Если вы запускаете Glarus BI из JAR в любой Unix-подобной операционной системе, вы можете увидеть, какой пользователь запускает Glarus BI, открыв терминал и набрав ps -aux | grep metabase.