Процесс обновления Sage

Чтобы перейти на новую версию Sage, выполните следующие шаги:

1. Инициализация среды Ansible
2. Запуск плейбука

Все команды выполняются внутри запущенного контейнера установщика sage-trukk на контрольном хосте.

При возникновении проблем во время обновления см. подраздел Действия при ошибке обновления.

Шаг 1. Инициализация среды Ansible

Настройте окружение перед запуском плейбука — укажите путь к конфигурации и режим работы. Все скрипты и плейбуки находятся в папке /home/trukker/ansible.

1. Перейдите в рабочую директорию:

   cd ~/ansible

2. Подключите bash-функции установщика:

   source setup.sh

3. Укажите путь к вашей конфигурации. В зависимости от структуры, в которой развернут Sage, команда будет отличаться:

   • Для структуры clans/ — укажите каталог конфигурации:

     clan clans/example/prod/3vm # Используйте реальный путь к вашему каталогу

   • Для структуры inventories/ — укажите путь к инвентарю и выберите дата-центр:

     export ANSIBLE_INVENTORY=groups,inventories/prod
     export SAGE_DC=dc1

4. Задайте режим работы — при обновлении используйте режим update:

   export SAGE_DEPLOY_MODE=update

Примечание

Доступные режимы работы:

• install — установка с перерывом сервиса, режим по умолчанию;

• update — установка без перерыва сервиса, рекомендуется для обновления.

Шаг 2. Запуск плейбука

После подготовки окружения запустите основной Ansible-плейбук:

ansible-playbook sage-setup.yml

Скрипт автоматически выполнит следующие действия:

1. Проверит доступность всех хостов из инвентаря по SSH.
2. Скачает Docker-образы и запустит Docker-контейнеры всех компонентов Sage.
3. Создаст нужные структуры в базах данных и при необходимости применит миграции.
4. Убедится, что все сервисы запустились корректно и готовы к работе.

Установка занимает от 30 минут в зависимости от конфигурации и скорости сети.

Примечание

В процессе работы вывод терминала может «замирать» на некоторых задачах на 3–5 минут — например, при загрузке образов или инициализации баз данных. Это нормальное поведение, не прерывайте установку.

При успешном завершении плейбука будет выведено сообщение: Installation validation succeeded. You can open Sage now: https://<sage_hostname>, где <sage_hostname> — это FQDN основного домена, указанный в файле инвентаря hosts.yml.

После успешного завершения обновления проверьте работоспособность Sage:

1. Откройте в браузере хост https://<sage_hostname>, где <sage_hostname> — это FQDN основного домена, указанный в файле инвентаря hosts.yml.

2. Убедитесь, что страница входа Sage отображается корректно и аутентификация работает.

Действия при ошибке обновления

При возникновении ошибок в процессе установки:

1. Изучите вывод консоли — в нем содержится указание на задачу (TASK) и хост(ы), на которых произошел сбой.

2. Проверьте логи контейнеров на целевых хостах или воспользуйтесь утилитой диагностики — она автоматически соберет логи всех компонентов в один архив и выявит типовые ошибки.

3. Примите решение о повторном запуске. Повторный запуск безопасен, если ошибка возникла вследствие следующих причин:

   • сбой сети, например таймауты при скачивании образов;
   • ошибки в конфигурационных файлах YAML;
   • временная недоступность хостов.

   В этом случае исправьте причину и запустите плейбук повторно.

Внимание

Не пытайтесь перезапустить установку самостоятельно, если сбой произошел на этапе:

• инициализации баз данных (ClickHouse, PostgreSQL);
• генерации сертификатов.

Повторный запуск в этих случаях может привести к неконсистентному состоянию. Соберите логи и обратитесь в техническую поддержку.