Модуль community.network.aireos_command – Выполнение команд на удалённых устройствах с Cisco WLC

Примечание

Этот модуль является частью коллекции community.network (версия 5.0.3).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network.

Для использования в плейбуке укажите: community.network.aireos_command.

Описание
Параметры
Примеры
Возвращаемые значения

Описание

Отправляет произвольные команды на узел aireos и возвращает результаты, считанные с устройства. В этом модуле есть аргумент, который заставляет модуль ожидать выполнения определённого условия до возврата или ожидает таймаут, если условие не выполняется.
Команды, выполняемые в режиме конфигурации с помощью этого модуля, не являются идемпотентными. Используйте community.network.aireos_config для конфигурации устройств WLC.

Псевдонимы: network.aireos.aireos_command

Параметры

Параметр	Комментарии
commands строка / обязательно	Список команд для отправки на удалённое устройство aireos через настроенный поставщик. Результирующий вывод команды возвращается. Если указан аргумент wait_for, модуль не возвращается до тех пор, пока условие не будет выполнено или не истечёт число попыток.
interval строка	Настраивает интервал в секундах для ожидания между повторами команды. Если команда не выполняет указанные условия, интервал определяет время ожидания перед повторной попыткой выполнения команды. По умолчанию: `1`
match строка	Аргумент match используется совместно с аргументом wait_for для указания политики сопоставления. Допустимые значения: `all` или `any`. Если значение установлено на `all`, все условные выражения в wait_for должны быть выполнены. Если значение установлено на `any`, должно быть выполнено только одно из значений. Выбор: `"any"` `"all"` ← (по умолчанию)
retries строка	Определяет количество повторов команды, прежде чем она будет считаться неудачной. Команда выполняется на целевом устройстве при каждом повторе и оценивается по условиям wait_for. По умолчанию: `10`
wait_for псевдонимы: waitfor строка	Список условий для оценки по выводу команды. Задача будет ждать, пока каждое условие не станет истинным, прежде чем перейти дальше. Если условие не будет истинным в течение заданного количества повторов, задача завершается ошибкой. См. примеры.

Примеры

tasks:
  - name: Run show sysinfo on remote devices
    community.network.aireos_command:
      commands: show sysinfo

  - name: Run show sysinfo and check to see if output contains Cisco Controller
    community.network.aireos_command:
      commands: show sysinfo
      wait_for: result[0] contains 'Cisco Controller'

  - name: Run multiple commands on remote nodes
    community.network.aireos_command:
      commands:
        - show sysinfo
        - show interface summary

  - name: Run multiple commands and evaluate the output
    community.network.aireos_command:
      commands:
        - show sysinfo
        - show interface summary
      wait_for:
        - result[0] contains Cisco Controller
        - result[1] contains Loopback0

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
failed_conditions список / элементы=строка	Список условных выражений, которые завершились неудачей Возвращается: failed Пример: `["...", "..."]`
stdout список / элементы=строка	Набор ответов от команд Возвращается: всегда, кроме ошибок низкого уровня (таких как плагин действия) Пример: `["...", "..."]`
stdout_lines список / элементы=строка	Значение stdout, разделённое по строкам в список Возвращается: всегда, кроме ошибок низкого уровня (таких как плагин действия) Пример: `[["...", "..."], ["..."], ["..."]]`

Авторы

James Mighion (@jmighion)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/aireos_command_module.html