Процесс установки Sage

Установка является финальным этапом в процессе развертывания Sage и включает следующие шаги:

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

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

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

Важно

Перед началом установки убедитесь, что соблюдены следующие условия:

• в файле hosts.yml указаны FQDN ваших хостов;
• имеется файл лицензии sage_license.json;
• проверка sage-precheck пройдена без ошибок.

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

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

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

   cd ~/ansible

2. Активируйте скрипт настройки:

   source setup.sh

   Скрипт загрузит переменные окружения и настроит алиасы для работы с Ansible.

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

   • Для флейвора 1VM:

     clan clans/example/prod/1vm

   • Для флейвора 3VM:

     clan clans/example/prod/3vm

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

   export SAGE_DEPLOY_MODE=install

Примечание

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

• 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 завершена. Подробнее о том, как выполнить вход в систему, см. в разделе Первый запуск.

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

Ansible-плейбук поддерживает повторный запуск, но возможность перезапуска зависит от этапа, на котором произошел сбой.

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

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

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

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

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

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

Внимание

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

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

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