Перейти к основному содержимому
Версия: 1.12

Работа с файлами конфигурации

Примечание

Статья описывает изменение параметров конфигурации без смены версии Sage — например, добавление компонентов или настройку переменных. Чтобы перейти на новую версию Sage, используйте Руководство по обновлению.

Чтобы изменить конфигурацию Sage:

  1. Создайте резервную копию текущей конфигурации.
  2. Запустите контейнер установщика.
  3. Внесите необходимые изменения.
  4. Запустите утилиту для проверки.
  5. Перезапустите плейбук установки с нужным режимом.

Шаг 1. Создание резервной копии конфигурации​

Перед началом работ создайте резервную копию текущей конфигурации. Это позволит восстановить рабочее состояние Sage, если в процессе что-то пойдет не так.

Скопируйте всю рабочую директорию установщика, включая конфигурационные файлы, секреты, сертификаты и инвентарь, в отдельное место за пределами рабочей директории.

Храните резервную копию до тех пор, пока не убедитесь, что Sage работает корректно.

Шаг 2. Запуск контейнера установщика​

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

Полное имя контейнера содержит версию установки: sage-trukk-${SAGE_VERSION}, где ${SAGE_VERSION} — версия Sage в формате v<номер>. Например, для версии v1.12.51 имя контейнера будет sage-trukk-v1.12.51.

  1. Запустите контейнер установщика и подключитесь к нему:

    sudo docker start sage-trukk-${SAGE_VERSION}
    sudo docker attach sage-trukk-${SAGE_VERSION}

    Подробнее см. в разделе Работа с контейнером установщика.

  2. Перейдите в директорию с командами:

    cd ~/ansible

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

    source setup.sh

Шаг 3. Изменение конфигурации​

Способ внесения изменений зависит от структуры, в которой вы развернули Sage.

  1. Выберите каталог конфигурации, который нужно изменить:

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

  2. Перейдите в директорию с конфигурационными файлами.

    cd $SAGE_HORDE_CLAN_PATH/group_vars/sage

  3. Внесите изменения с помощью любого удобного текстового редактора.

Шаг 4. Проверка конфигурации​

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

Подробнее о запуске и чтении вывода утилиты см. в статье Precheck — проверка конфигурации.

Шаг 5. Применение изменений​

Установщик Sage работает в двух режимах:

  • install — установка с перерывом сервиса, используется по умолчанию;
  • update — обновление без перерыва сервиса.

  1. Выберите и задайте правильный режим:

    • Если Sage находится в продуктивной эксплуатации или вы переходите на другую версию продукта, используйте режим update.

      export SAGE_DEPLOY_MODE=update

    • Если версия Sage остается прежней, используйте режим install.

      export SAGE_DEPLOY_MODE=install

  2. Запустите плейбук установки:

    ansible-playbook sage-setup.yml

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

Совет

Чтобы не выполнять полную установку, применяйте изменения конфигурации только для затрагиваемых компонентов. Для этого запустите плейбук с тегом, соответствующим компоненту. Например, для применения изменений к компонентам Spirit IAM:

ansible-playbook sage-setup.yml --tags spirit_iam

Список плейбуков и тегов доступен в контейнере установщика в директории ansible/setup_playbooks. Теги можно указывать через запятую.

Последнее обновление