Обновление версии GlarusBI

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

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

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

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

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

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

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

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

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

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

    GlarusBI с открытым исходным кодом:

    docker pull repo/image:latest

  4. Запустите новый контейнер Docker. В зависимости от портов и того, как вы хотите назвать контейнер, команда будет выглядеть примерно так:

    GlarusBI с открытым исходным кодом:

    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

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

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

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

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

  • 1.38.X

  • 1.39.X

  • 1.40.X

  • Latest,

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

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

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

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

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

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

java -jar metabase.jar migrate down

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

docker run --rm metabase/metabase migrate down

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