aa-setup#

В этом документе описаны назначение и синтаксис утилиты Astra Automation Setup (aa-setup).

Назначение#

Утилита aa-setup выполняет следующие действия:

  • развертывает платформу в виде нескольких связанных компонентов;

  • обновляет версии и структуру компонентов платформы;

  • выполняет резервное копирование и восстановление базы данных;

  • генерирует и распространяет секретный ключ;

  • проверяет версии Astra Automation, доступные в репозитории;

  • удаляет Astra Automation.

Установка и запуск#

Для установки утилиты aa-setup выполните следующие действия:

  1. В каталоге /etc/apt/sources.list.d/ создайте файл astra-automation.list со ссылкой на репозиторий контроллера:

    deb https://dl.astralinux.ru/aa/aa-debs-for-alse-1.7 <version> main
    

    Доступные версии продукта опубликованы в таблице История обновлений. Например, для установки версии 1.0-upd2 вместо <version> подставьте значение 1.0-upd2.

  2. Обновите список доступных пакетов:

    sudo apt update
    
  3. Выполните команду установки:

    sudo apt install astra-automation-setup --yes
    

Описание аргументов#

Запустить утилиту можно в каталоге /opt/rbta/aa/astra-automation-setup/ со следующими аргументами:

  • -h, --help#

    Выводит информацию о доступных опциях и соответствующих аргументах.

  • -i <inventory_path>, --inventory <inventory_path>#

    Путь к файлу инвентаризации. Значение по умолчанию – ./inventory.

  • -p <log_path>, --log-path <log_path>#

    Путь к альтернативному каталогу для сохранения журнала установки. Текущий пользователь должен иметь привилегию на создание файлов и запись в этом каталоге. Значение по умолчанию – ./.

  • -k, --generate-key#

    Генерирует и распространяет новый секретный ключ, используемый для выполнения следующих задач:

    • шифрование данных пользовательских сессий;

    • генерация токенов для паролей;

    • защита данных контроллера.

  • -b, --backup#

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

  • -r, --restore#

    Использует резервную копию данных для восстановления платформы на узлах, описанных в инвентаре установщика.

  • -d, --debug#

    Включает режим отладки для более подробного вывода информации о процессе.

  • -u, --uninstall#

    Запускает процесс удаления компонентов Astra Automation, перечисленных в файле инвентаризации.

    Added in version 1.0-upd2.

  • --force-postgres-removal#

    Запускает процесс удаления PostgreSQL.

    Added in version 1.0-upd1.

  • --plain#

    Отключает расширенный вариант текстового пользовательского интерфейса.

  • --repo-url <repo_url>#

    Указывает URL альтернативного репозитория для установки из него Astra Automation. Например, для использования репозитория https://example.com/artifactory/automation-debs-for-alse воспользуйтесь командой:

    sudo ./aa-setup --repo-url https://example.com/artifactory/automation-debs-for-alse
    
  • --default-job-ee <ee_url>#

    Указывает на образ контейнейнера, который будет использован в качестве среды исполнения по умолчанию (Default execution environment). Например, для использования образа registry.astralinux.ru/aa/aa-base-ee:0.5.1 воспользуйтесь командой:

    sudo ./aa-setup --default-job-ee registry.astralinux.ru/aa/aa-base-ee:0.5.1
    

    Added in version 1.0-upd2.

  • --component <component_name>#

    Указывает альтернативный компонент репозитория. Например, если необходимо использовать пакеты, размещенные в компоненте testing, воспользуйтесь командой:

    sudo ./aa-setup --component testing
    
  • --product-version <product_version>#

    Указывает определенную версию Astra Automation. По умолчанию устанавливается новейшая версия. Например, для установки версии 1.0-upd2 воспользуйтесь командой:

    sudo ./aa-setup --product-version 1.0-upd2
    
  • -v, --version#

    Показывает версию утилиты aa-setup.

  • --upgrade#

    Обновляет компоненты Astra Automation до новейшей версии. Может быть использован совместно с аргументом --product-version для обновления до определенной версии.

    Added in version 1.0-upd1.

    Примечание

    Аргумент --product-version обязателен при обновлении с версии 1.0-upd1 до 1.0-upd2.

    Например, для обновления до версии 1.0-up2 используйте команду:

    sudo ./aa-setup --upgrade --product-version 1.0-up2
    
  • --check-releases#

    Выводит на экран терминала версии Astra Automation, доступные в репозитории.

    Added in version 1.0-upd1.

Также вы можете передать дополнительные аргументы для команды ansible-playbook после --, например:

sudo ./aa-setup -b -- -vvv --ask-pass