Обновление Glarus BI в Docker Compose¶
В данном подразделе описаны шаги для обновления экземпляра Glarus BI в среде Docker Compose.
Обзор вариантов использования и альтернатив: "Обновление Glarus BI. Обзор вариантов".
Перед обновлением в обязательном порядке требуется выполнить резервное копирование БД метаданных приложения 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» указан новый номер версии и сборки.
Проверьте, что все визуализации присутствуют на дашбордах и выглядят корректно.
Отправьте любое email-оповещение, чтобы убедиться в работе рассылки.
Убедитесь в доступности подключённых баз данных.
Обновление завершено! Не забудьте оповестить руководителя и пользователей о результате и оставить рабочие записи об обновлении, если вы их ведёте.
Откат обновления в случае неудачи¶
Для отката необходима резервная копия БД метаданных приложения.
Предупреждение
Все изменения, внесённые пользователями в систему с момента создания резервной копии БД метаданных до текущего момента, будут утеряны.
Остановите работающие контейнеры¶
В каталоге с конфигурацией Docker Compose:
Запустите один контейнер БД метаданных¶
В данном примере он называется "postgres", точное название можно узнать в файле docker-compose.yml:
Разверните БД метаданных приложения из резервной копии¶
Замените испорченную неудачным обновлением БД метаданных на работоспособную копию. Детали описаны в "Восстановление БД метаданных (Postgres)"
Откатите файл docker-compose.yml¶
Верните номер версии image, изменённый перед неудачной попыткой обновления и сохраните изменения. Вы можете взять предыдущий файл docker-compose.yml целиком, если создали его копию во время обновления.
Запустите остальные контейнеры¶
Выполните команду:
Дождитесь запуска и проанализируйте журнал¶
Журнал запуска:
Проверьте результат отката¶
Сбросьте кэш страницы в браузере, проверьте номер версии системы и состояние визуализаций на дашбордах. Если критические ошибки отсутствуют, откат успешно завершён.