Обновление Glarus BI в Docker Compose¶
В статье описаны шаги для обновления экземпляра Glarus BI в среде Docker Compose.
Обновления Glarus BI публикуются на серверах разработчика в репозитории образов Docker. Доступ к репозиторию администратор получает в рамках процесса развёртывания системы. Информацию о выходе новой версии системы можно получить из открытых источников (сайт разработчика, тематические группы в социальных сетях, каналы разработчика на видеохостингах), а также при взаимодействии с технической поддержкой.
Обновление системы¶
Перед обновлением в обязательном порядке требуется выполнить резервное копирование БД метаданных приложения Glarus BI и проверить работоспособность полученной копии. Это действие необходимо провести для каждого из контуров, если их несколько.
Внимание
Запрещено выполнять обновление экземпляра промышленной эксплуатации без создания резервной копии БД метаданных приложения, так как откат без резервной копии в большинстве случаев невозможен.
Оповестите пользователей о планах обновить систему. Всё, что будет создано ими в Glarus BI после создания резервной копии метаданных, может быть утеряно, если обновление придётся откатить.
Если у вас развёрнуто несколько контуров (например: песочница, контур разработки, тестирования, продуктивный), начинать обновление рекомендуется с песочницы, переходя к обновлению следующего контура только после базовой проверки работоспособности системы на предыдущем.
Примечание
В ходе проверки следует просмотреть все созданные ранее визуализации на дашбордах и убедиться в их корректном отображении.
Перед обновлением стенда продуктивной эксплуатации следует выполнить более тщательное тестирование системы. Рекомендуется также убедиться в наличии резервной копии критичных данных или выполнить внеплановое резервное копирование. Обновление не должно затронуть источники данных, но возможен человеческий фактор при работе с консолью.
Разрешите подключение к репозиторию разработчика¶
Контур должен получить доступ к образам Docker, которые хранятся на registry.glarus-digital.ru.
Скопируйте файл настройки Docker Compose¶
Сохраните копию файла docker-compose.yml, чтобы не ошибиться в пути к образам предыдущей версии в случае отката.
Укажите путь к образу новой версии Glarus BI¶
Откройте настройки docker-compose.yml. Замените номер версии в пути к образу в секции glarusbi > image на "52" (последние цифры в строке). При необходимости уточните путь к новому образу в технической поддержке.
Запустите обновление¶
Находясь в каталоге с docker-compose.yml, выполните команду для начала обновления:
Примечание
Команда docker compose может выполняться как docker-compose (написание через дефис) — это зависит от версии ОС и пакетов.
Проверьте результат обновления¶
Результат обновления следует искать в журнале работы сервера приложений системы, визуально в браузере.
При этом требуется сбросить кэш страницы в браузере и проверить, что в блоке «О Glarus BI» указан новый номер версии и сборки. Во время проверки результата в браузере рекомендуется убедиться, что все визуализации присутствуют на дашбордах и выглядят корректно.
Обновление завершено! Не забудьте оставить рабочие записи об обновлении, если вы их ведёте, и оповестить пользователей о результате.
Откат обновления в случае неудачи¶
Для отката необходима резервная копия БД метаданных приложения.
Предупреждение
Все изменения, сделанные пользователями в системе с момента создания резервной копии БД метаданных до текущего момента, будут утеряны.
Остановите работающие контейнеры¶
В каталоге с конфигурацией Docker Compose:
Запустите один контейнер БД метаданных¶
В данном примере он называется "postgres", точное название можно узнать в файле docker-compose.yml:
Разверните БД метаданных приложения из резервной копии¶
Замените испорченную неудачным обновлением БД метаданных на работоспособную копию.
Откатите файл docker-compose.yml¶
Верните номер версии image, изменённый перед неудачной попыткой обновления и сохраните изменения. Вы можете взять предыдущий файл docker-compose.yml целиком, если создали его копию во время обновления.
Запустите остальные контейнеры¶
Выполните команду:
Дождитесь запуска и проанализируйте журнал¶
Журнал запуска:
Проверьте результат отката¶
Сбросьте кэш страницы в браузере и проверьте номер версии системы и состояние визуализаций на дашбордах. Если критические ошибки отсутствуют, откат успешно завершён.