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

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

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

См. [Резервное копирование данных приложения GlarusBI](backing-up-metabase-application-data.md).

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

- [Обновление образа Docker](#upgrading-the-docker-image)


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

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

1. [Создайте резервную копию ваших метаданных](backing-up-metabase-application-data.md).

   > ПРЕДУПРЕЖДЕНИЕ. Если вы не используете [базу данных, предназначенную для промышленной эксплуатации](migrating-from-h2.md), данные вашего приложения (вопросы, информационные панели и т. д.) будут храниться в базе
   > данных 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 завершит обновление, у вас будет запущена новая версия.


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

В общем случае, регулярные резервные копии (особенно резервные копии перед обновлением) - это лучшая политика, поэтому мы рекомендуем откатиться к резервной копии базы данных приложения, чтобы откатить обновление.
Но, если вы сделали изменения в базе данных приложения после обновления, которые вы хотите сохранить, вы можете использовать команду `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 для версии, которую вы хотите запустить.