Утилита awx-manage#
awx-manage является утилитой командной строки, используемой для получения подробной информации о контроллере и управления им.
Команды утилиты awx-manage необходимо запускать на управляющем узле контроллера от имени пользователя awx или суперпользователя.
Если управляющих узлов несколько, то запускать команду можно на любом из них.
Важно
Запуск команд awx-manage через playbook не поддерживается.
Вызов утилиты имеет следующий вид:
sudo awx-manage <command> [<arguments>]
Для вывода справочной информации воспользуйтесь командой:
sudo awx-manage --help
Импорт инвентаря#
Утилита awx-manage предоставляет администраторам возможность импортировать инвентарь в Automation Controller с помощью следующих шагов:
В контроллере создайте инвентарь, который будет служить местом назначения для импорта.
Подключитесь по SSH к управляющему узлу контроллера и выполните команду:
sudo awx-manage inventory_import --source=<path_to_inventory> --inventory-id=<id>
Здесь:
<path_to_inventory> – путь к файлу инвентаря, который будет использован в качестве источника.
<id> – идентификатор инвентаря, созданного ранее.
Команда inventory_import позволяет синхронизировать существующий инвентарь в контроллере с текстовым файлом инвентаря в формате INI или YAML, динамическим инвентарем или каталогом, содержащим такие файлы и инвентари.
При импорте можно использовать аргументы --overwrite и --overwrite-vars, чтобы управлять тем, как данные объединяются или заменяются.
По умолчанию данные из внешнего источника перезаписывают имеющиеся. Данные, которые отсутствуют во внешнем источнике, но присутствуют в контроллере, сохраняются.
При запуске утилиты с аргументом --overwrite используются только данные из внешнего источника.
Данные, отсутствующие во внешнем источнике, будут удалены.
При запуске утилиты с аргументом --overwrite-vars используются переменные исключительно из внешнего источника.
Узлы, которые отсутствуют во внешнем источнике, но присутствуют в контроллере, сохраняются.
Удаление устаревших данных#
Команды cleanup_jobs и cleanup_activitystream используются для удаления данных о выполненных заданиях и данных ленты активности старше количества дней, указанного в аргументе --days:
Удаление данных о выполненных заданиях:
sudo awx-manage cleanup_jobs --days <n>
Удаление данных ленты активности:
sudo awx-manage cleanup_activitystream --days <n>
Удаление узла#
Команда deprovision_instance используется для удаления узлов:
sudo awx-manage deprovision_instance --hostname=<hostname>
Здесь <hostname> – название удаляемого узла в инвентаре установщика платформы.
Примечание
Узел необходимо удалить из инвентаря установщика платформы, если он не должен появиться в кластере при повторном запуске сценария настройки.
Метрики узлов#
Утилита awx-manage предоставляет возможность генерировать данные метрик узлов в формате CSV.
Создание файлов с данными метрик узла и информацией о кластере:
sudo awx-manage host_metric --csv
Чтобы упаковать все файлы в один архив, воспользуйтесь командой:
sudo awx-manage host_metric --tarball
Чтобы указать количество строк (<N>) для вывода в каждый файл, используйте аргумент --pows_per_file:
sudo awx-manage host_metric --rows_per_file <N>