Обновление версии Glarus BI

Резервная копия метаданных

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

См. Резервное копирование данных приложения Glarus BI.

Обновление Glarus BI на новую версию

Обновление образа Docker

Если вы используете Glarus BI в контейнере Docker:

  1. Создайте резервную копию ваших метаданных.

    ПРЕДУПРЕЖДЕНИЕ. Если вы не используете базу данных, уровня промышленной эксплуатации, данные вашего приложения (запросы, информационные панели и т. д.) будут храниться в базе данных H2 внутри вашего контейнера. Обновление потребует замены вашего существующего контейнера на новый с обновленным JAR-файлом Glarus BI, который также обновит данные вашего приложения. Перед обновлением рекомендуется переключиться на внешнюю базу данных.

  2. Остановите текущий Docker-контейнер.

  3. Загрузите последний образ Glarus BI Docker.

   docker pull repo/image:latest
  1. Запустите новый контейнер Docker. В зависимости от портов и того, как вы хотите назвать контейнер, команда будет выглядеть примерно так:

   docker run -d -p 3000:3000 -e MB_DB_CONNECTION_URI="jdbc:postgresql://<host>:5432/metabase?user=<username>&password=<password>" --name glarusBI repo/image:latest

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

Обновление со старых версий Glarus BI

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

Например, если вы используете Glarus BI 1.38, ваш процесс обновления должен выглядеть так:

  • 1.38.X

  • 1.39.X

  • 1.40.X

  • Latest,

где X - последняя версия, доступная для каждого выпуска.

Список выпусков см. в Версии Glarus BI.

Откат обновления

В общем случае регулярные резервные копии (особенно резервные копии перед обновлением) — это лучшая политика, поэтому мы рекомендуем откатиться к резервной копии базы данных приложения, чтобы откатить обновление. Но если вы сделали изменения в базе данных приложения после обновления, которые вы хотите сохранить, вы можете использовать команду migrate down, чтобы откатить базу данных приложения Glarus BI к предыдущей версии Glarus BI, которую вы запускали. При обновлении до новой версии выполняются миграции, которые могут изменить схему базы данных приложения. Команда migrate down отменяет эти изменения схемы. В целом, мы рекомендуем восстановиться из резервной копии (резервной копии, которую вы определённо помните, что сгенерировали перед обновлением), и использовать команду migrate down только в том случае, если вам действительно нужно сохранить изменения, сделанные после обновления.

Использование команды migrate down

Остановите Glarus BI и используйте текущий обновлённый JAR-файл, чтобы завершить откат с помощью следующей команды:

java -jar metabase.jar migrate down

Если вы работаете в Docker, команда будет такой:

docker run --rm metabase/metabase migrate down

Как только процесс миграции завершится, запустите Glarus BI с помощью JAR-файла или образа Docker для версии, которую вы хотите запустить.