Плагины httpapi

Добавление плагинов httpapi

Вы можете расширить Ansible для поддержки других API, поместив пользовательский плагин в каталог httpapi_plugins. Подробности см. в разделе Разработка плагинов httpapi.

Использование плагинов httpapi

Плагин httpapi для использования автоматически определяется по переменной ansible_network_os.

Большинство плагинов httpapi работают без дополнительной настройки. Каждый плагин может определять дополнительные параметры.

Плагины документируют сами себя. В документации каждого плагина должны быть описаны параметры настройки.

В следующем примере плейбука показан плагин httpapi для сетевого устройства Arista. Предполагается, что в инвентаре задана переменная ansible_network_os=eos, по которой будет выбран плагин httpapi:

- hosts: leaf01
  connection: httpapi
  gather_facts: false
  tasks:

    - name: type a simple arista command
      eos_command:
        commands:
          - show version | json
      register: command_output

    - name: print command output to terminal window
      debug:
        var: command_output.stdout[0]["version"]

Полный рабочий пример см. на GitHub.

Просмотр плагинов httpapi

Эти плагины перенесены в коллекции на платформе Ansible Galaxy. Если вы установили Ansible версии 2.10 или более поздней с помощью pip, вам доступны несколько плагинов httpapi. Чтобы просмотреть список доступных плагинов, используйте ansible-doc -t httpapi -l. Чтобы просмотреть документацию и примеры для конкретного плагина, используйте ansible-doc -t httpapi <plugin name>.