aa-setup#
В этом документе описаны назначение и синтаксис утилиты Astra Automation Setup (aa-setup
).
Назначение#
Утилита aa-setup
выполняет следующие действия:
развертывает платформу в виде нескольких связанных компонентов;
обновляет версии и структуру компонентов платформы;
выполняет резервное копирование и восстановление базы данных;
генерирует и распространяет секретный ключ;
проверяет версии Astra Automation, доступные в репозитории;
удаляет Astra Automation.
Установка и запуск#
Для установки утилиты aa-setup
выполните следующие действия:
В каталоге
/etc/apt/sources.list.d/
создайте файлastra-automation.list
со ссылкой на репозиторий Astra Automation:deb https://dl.astralinux.ru/aa/aa-debs-for-alse-1.7 <version> main
Вместо <version> необходимо подставить версию устанавливаемой платформы, например,
1.1
.Доступные версии продукта опубликованы в таблице История обновлений.
Обновите список доступных пакетов:
sudo apt update
Выполните команду установки:
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#
Включает режим отладки для более подробного вывода информации о процессе.
- -y, --force-yes#
Ключ отключает запрос на подтверждение выполнения операции, подразумевая, что ответ всегда Да (Yes).
- --force-postgres-removal#
Запускает процесс удаления PostgreSQL.
- --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
- --component <component_name>#
Указывает альтернативный компонент репозитория. Например, если необходимо использовать пакеты, размещенные в компоненте
testing
, воспользуйтесь командой:sudo ./aa-setup --component testing
- --product-version <product_version>#
Указывает определенную версию Astra Automation. По умолчанию устанавливается новейшая версия. Для установки версии <version> (например,
1.1
) воспользуйтесь командой:sudo ./aa-setup --product-version <version>
- -v, --version#
Показывает версию утилиты
aa-setup
.
- --upgrade#
Обновляет компоненты Astra Automation до новейшей версии. Может быть использован совместно с аргументом
--product-version
для обновления до определенной версии.Для обновления до версии <version> (например,
1.1
) используйте команду:sudo ./aa-setup --upgrade --product-version <version>
- --check-releases#
Выводит на экран терминала версии Astra Automation, доступные в репозитории.
Также вы можете передать дополнительные аргументы для команды ansible-playbook
после --
, например:
sudo ./aa-setup -b -- -vvv --ask-pass