Spec-Zone.ru › Ansible 2.10

Парсинг полуструктурированного текста с Ansible

Модуль cli_parse парсит полуструктурированные данные, такие как конфигурации сети, в структурированные данные, чтобы разрешить программное использование данных с этого устройства. Вы можете извлечь информацию с сетевого устройства и обновить CMDB в одном плане. Примеры использования включают автоматизированную диагностику, создание динамической документации, обновление инструментов IPAM (управление IP-адресами) и так далее.

  • Понимание парсера командной строки

    • Зачем парсить текст?
    • Когда не стоит парсить текст
  • Парсинг командной строки

    • Парсинг с помощью собственного движка парсинга

      • Пример для сетевого оборудования
      • Пример для Linux
    • Парсинг JSON
    • Парсинг с помощью шаблонов ntc
    • Парсинг с помощью pyATS
    • Парсинг с помощью textfsm
    • Парсинг с помощью TTP
    • Преобразование XML
  • Расширенные случаи использования

    • Указать полный путь к шаблону
    • Указать команду для парсера отличную от выполняемой команды
    • Указать пользовательское значение ОС
    • Парсить существующий текст

Понимание парсера командной строки

Коллекция ansible.netcommon версии 1.2.0 или более поздней включает модуль cli_parse, который может выполнять команды командной строки и парсить полуструктурированный текстовый вывод. Вы можете использовать модуль cli_parse на устройстве, узле или платформе, которые поддерживают только командную строку, и выданные команды возвращают полуструктурированный текст. Модуль cli_parse может либо выполнить команду командной строки на устройстве и вернуть обработанный результат, либо просто обработать любой текстовый документ. Модуль cli_parse включает плагины cli_parser для взаимодействия с различными движками парсинга.

Зачем парсить текст?

Парсинг полуструктурированных данных, таких как конфигурации сети, в структурированные данные позволяет программное использование данных с этого устройства. Примеры использования включают автоматизированную диагностику, создание динамической документации, обновление инструментов IPAM (управление IP-адресами) и так далее. Вы можете предпочесть сделать это с помощью Ansible напрямую, чтобы воспользоваться встроенными конструкциями Ansible, такими как:

  • Оператор when для условного выполнения других задач или ролей
  • Модуль assert для проверки соответствия конфигурации и операционного состояния
  • Модуль template для генерации отчетов о конфигурации и операционном состоянии
  • Шаблоны и модули command или config для генерации команд или конфигурации узла, устройства или платформы
  • Модули текущей платформы facts для дополнения фактической информации об операционной системе

Преобразование полуструктурированного текста в собственные структуры данных Ansible позволяет в полной мере использовать сетевые модули и плагины Ansible.

Когда не стоит парсить текст

Вы не должны парсить полуструктурированный текст, когда:

  • Устройство, узел или платформа имеет RESTAPI и возвращает JSON.
  • Существующие модули фактов Ansible уже возвращают нужные данные.
  • Существуют модули Ansible для управления ресурсами сети для управления конфигурацией устройства и ресурса.

Парсинг командной строки

Модуль cli_parse включает следующие плагины cli_parsing:

native

Встроенный в Ansible собственный движок парсинга, не требующий дополнительных библиотек Python

xml

Преобразование XML в структуру данных Ansible

textfsm

Модуль Python, реализующий шаблонную автоматизированную машину состояний для парсинга полуформатированного текста

ntc_templates

Предварительно определенные textfsm шаблоны, поддерживающие различные платформы и команды

ttp

Библиотека для парсинга полуструктурированного текста с использованием шаблонов, с дополнительными возможностями для упрощения процесса

pyats

Использует парсеры, включенные в Cisco Test Automation & Validation Solution

json

Преобразует выходные данные JSON из командной строки в структуру данных Ansible

Хотя Ansible содержит ряд плагинов, которые могут преобразовать XML в структуру данных Ansible, модуль ``cli_parse`` выполняет команду на устройствах, возвращающих XML, и возвращает преобразованные данные в одной задаче.

Поскольку cli_parse использует архитектуру на основе плагинов, он может использовать дополнительные движки парсинга из любой коллекции Ansible.

Примечание

Движки парсинга ansible.netcommon.native и ansible.netcommon.json полностью поддерживаются с подпиской Red Hat Ansible Automation Platform. Поддержка подписки Red Hat Ansible Automation Platform ограничена использованием ntc_templates, pyATS, textfsm, xmltodict, общедоступных API, как документировано.

Парсинг с помощью собственного движка парсинга

Встроенный движок парсинга включен в модуль cli_parse. Он использует данные, полученные с помощью регулярных выражений, для заполнения структуры обработанных данных. Собственный движок парсинга требует файла шаблона YAML для парсинга вывода команды.

Пример для сетевого оборудования

В этом примере используется вывод команды сетевого устройства и применяется собственный шаблон для получения вывода в структурированном формате Ansible.

Вывод команды show interface с сетевого устройства выглядит следующим образом:

Ethernet1/1 is up
admin state is up, Dedicated Interface
  Hardware: 100/1000/10000 Ethernet, address: 5254.005a.f8bd (bia 5254.005a.f8bd)
  MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec
  reliability 255/255, txload 1/255, rxload 1/255
  Encapsulation ARPA, medium is broadcast
  Port mode is access
  full-duplex, auto-speed
  Beacon is turned off
  Auto-Negotiation is turned on  FEC mode is Auto
  Input flow-control is off, output flow-control is off
  Auto-mdix is turned off
  Switchport monitor is off
  EtherType is 0x8100
  EEE (efficient-ethernet) : n/a
  Last link flapped 4week(s) 6day(s)
  Last clearing of "show interface" counters never
<...>

Создайте собственный шаблон для соответствия этому выводу и сохраните его как templates/nxos_show_interface.yaml:

---
- example: Ethernet1/1 is up
  getval: '(?P<name>\S+) is (?P<oper_state>\S+)'
  result:
    "{{ name }}":
      name: "{{ name }}"
      state:
        operating: "{{ oper_state }}"
  shared: true

- example: admin state is up, Dedicated Interface
  getval: 'admin state is (?P<admin_state>\S+),'
  result:
    "{{ name }}":
      name: "{{ name }}"
      state:
        admin: "{{ admin_state }}"

- example: "  Hardware: Ethernet, address: 5254.005a.f8b5 (bia 5254.005a.f8b5)"
  getval: '\s+Hardware: (?P<hardware>.*), address: (?P<mac>\S+)'
  result:
    "{{ name }}":
      hardware: "{{ hardware }}"
      mac_address: "{{ mac }}"

Этот шаблон собственного парсера структурирован как список парсеров, каждый из которых содержит следующие пары ключ-значение:

  • example - Пример строки текста для парсинга
  • getval - Регулярное выражение с именованными группами захвата для хранения извлеченных данных
  • result - Дерево данных, заполненное как шаблон, из обработанных данных
  • shared - (необязательно) Общий ключ делает обработанные значения доступными для остальных записей парсера до тех пор, пока они снова не будут сопоставлены.

Следующая задача использует cli_parse с собственным парсером и приведенным выше шаблоном для парсинга команды show interface с устройства Cisco NXOS:

- name: "Run command and parse with native"
  ansible.netcommon.cli_parse:
    command: show interface
      parser:
        name: ansible.netcommon.native
    set_fact: interfaces

Более подробный анализ этой задачи:

  • Параметр command указывает команду, которую необходимо выполнить на устройстве или узле. В качестве альтернативы вы можете предоставить текст из предыдущей команды с помощью параметра text.
  • Параметр parser предоставляет информацию, специфичную для движка парсинга.
  • Подпараметр name предоставляет полное имя коллекции (FQCN) движка парсинга (ansible.netcommon.native).
  • Модуль cli_parse по умолчанию ищет шаблон в каталоге шаблонов как {{ short_os }}_{{ command }}.yaml.

    • Значение short_os в имени файла шаблона получено из узла ansible_network_os или ansible_distribution.
    • Пробелы в команде сетевого или хост-устройства заменяются на _ в части имени файла шаблона command. В данном примере команда сетевой командной строки show interfaces преобразуется в show_interfaces в имени файла.

Примечание

Движок парсинга ansible.netcommon.native полностью поддерживается с подпиской Red Hat Ansible Automation Platform.

Наконец, в этой задаче параметр set_fact устанавливает следующий факт interfaces для устройства на основе структурированных данных, возвращенных из cli_parse:

Ethernet1/1:
    hardware: 100/1000/10000 Ethernet
    mac_address: 5254.005a.f8bd
    name: Ethernet1/1
    state:
    admin: up
    operating: up
Ethernet1/10:
    hardware: 100/1000/10000 Ethernet
    mac_address: 5254.005a.f8c6
<...>

Пример для Linux

Вы также можете использовать собственный парсер для выполнения команд и парсинга вывода с узлов Linux.

Вывод образцовой команды Linux (ip addr show) выглядит следующим образом:

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host
       valid_lft forever preferred_lft forever
2: enp0s31f6: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc fq_codel state DOWN group default qlen 1000
    link/ether x2:6a:64:9d:84:19 brd ff:ff:ff:ff:ff:ff
3: wlp2s0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
    link/ether x6:c2:44:f7:41:e0 brd ff:ff:ff:ff:ff:ff permaddr d8:f2:ca:99:5c:82

Создайте собственный шаблон для соответствия этому выводу и сохраните его как templates/fedora_ip_addr_show.yaml:

---
- example: '1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000'
  getval: |
    (?x)                                                # free-spacing
    \d+:\s                                              # the interface index
    (?P<name>\S+):\s                                    # the name
    <(?P<properties>\S+)>                               # the properties
    \smtu\s(?P<mtu>\d+)                                 # the mtu
    .*                                                  # gunk
    state\s(?P<state>\S+)                               # the state of the interface
  result:
    "{{ name }}":
        name: "{{ name }}"
        loopback: "{{ 'LOOPBACK' in stats.split(',') }}"
        up: "{{ 'UP' in properties.split(',')  }}"
        carrier: "{{ not 'NO-CARRIER' in properties.split(',') }}"
        broadcast: "{{ 'BROADCAST' in properties.split(',') }}"
        multicast: "{{ 'MULTICAST' in properties.split(',') }}"
        state: "{{ state|lower() }}"
        mtu: "{{ mtu }}"
  shared: True

- example: 'inet 192.168.122.1/24 brd 192.168.122.255 scope global virbr0'
  getval: |
   (?x)                                                 # free-spacing
   \s+inet\s(?P<inet>([0-9]{1,3}\.){3}[0-9]{1,3})       # the ip address
   /(?P<bits>\d{1,2})                                   # the mask bits
  result:
    "{{ name }}":
        ip_address: "{{ inet }}"
        mask_bits: "{{ bits }}"

Примечание

Ключ shared в шаблоне парсера позволяет использовать имя интерфейса в последующих записях парсера. Использование примеров и режима свободного форматирования с регулярными выражениями упрощает чтение шаблона.

Следующая задача использует cli_parse с собственным парсером и приведенным выше шаблоном для парсинга вывода Linux:

- name: Run command and parse
  ansible.netcommon.cli_parse:
    command: ip addr show
    parser:
      name: ansible.netcommon.native
    set_fact: interfaces

Эта задача предполагает, что вы предварительно собрали фактические данные для определения ansible_distribution для поиска шаблона. В качестве альтернативы, вы можете указать путь в параметре parser/template_path.

Наконец, в этой задаче параметр set_fact устанавливает следующий факт interfaces для узла на основе структурированных данных, возвращенных из cli_parse:

lo:
  broadcast: false
  carrier: true
  ip_address: 127.0.0.1
  mask_bits: 8
  mtu: 65536
  multicast: false
  name: lo
  state: unknown
  up: true
enp64s0u1:
  broadcast: true
  carrier: true
  ip_address: 192.168.86.83
  mask_bits: 24
  mtu: 1500
  multicast: true
  name: enp64s0u1
  state: up
  up: true
<...>

Парсинг JSON

Хотя Ansible будет по умолчанию преобразовывать сериализованный JSON в собственную структуру данных Ansible при распознавании, вы также можете использовать модуль cli_parse для этого преобразования.

Пример задачи:

- name: "Run command and parse as json"
  ansible.netcommon.cli_parse:
    command: show interface | json
    parser:
      name: ansible.netcommon.json
    register: interfaces

Более подробный анализ этой задачи:

  • Команда show interface | json выполняется на устройстве.
  • Вывод устанавливается в качестве факта interfaces для устройства.
  • Поддержка JSON предоставляется в основном для согласованности выполнения задач.

Примечание

Использование ansible.netcommon.json полностью поддерживается с подпиской Red Hat Ansible Automation Platform

Разбор с помощью ntc_templates

Библиотека ntc_templates python содержит предварительно определённые textfsm шаблоны для разбора различных выводов команд сетевых устройств.

Пример задачи:

- name: "Run command and parse with ntc_templates"
  ansible.netcommon.cli_parse:
    command: show interface
    parser:
      name: ansible.netcommon.ntc_templates
    set_fact: interfaces

Более глубокое изучение этой задачи:

  • ansible_network_os устройства преобразуется в формат шаблона ntc_template cisco_nxos. В качестве альтернативы можно указать os с опцией parser/os вместо этого.
  • Шаблон cisco_nxos_show_interface.textfsm, включённый в пакет ntc_templates, анализирует вывод.
  • Дополнительную информацию о библиотеке ntc_templates python см. в файле README ntc_templates.

Примечание

Поддержка Red Hat Ansible Automation Platform ограничена использованием публичных API ntc_templates в соответствии с документацией.

Эта задача устанавливает следующий факт в качестве факта interfaces для хоста:

interfaces:
- address: 5254.005a.f8b5
  admin_state: up
  bandwidth: 1000000 Kbit
  bia: 5254.005a.f8b5
  delay: 10 usec
  description: ''
  duplex: full-duplex
  encapsulation: ARPA
  hardware_type: Ethernet
  input_errors: ''
  input_packets: ''
  interface: mgmt0
  ip_address: 192.168.101.14/24
  last_link_flapped: ''
  link_status: up
  mode: ''
  mtu: '1500'
  output_errors: ''
  output_packets: ''
  speed: 1000 Mb/s
- address: 5254.005a.f8bd
  admin_state: up
  bandwidth: 1000000 Kbit
  bia: 5254.005a.f8bd
  delay: 10 usec

Разбор с помощью pyATS

pyATS является частью решения Cisco Test Automation & Validation. Оно включает в себя много предварительно определённых парсеров для ряда сетевых платформ и команд. Предварительно определённые парсеры, которые являются частью пакета pyATS, можно использовать с модулем cli_parse.

Пример задачи:

- name: "Run command and parse with pyats"
  ansible.netcommon.cli_parse:
    command: show interface
    parser:
      name: ansible.netcommon.pyats
    set_fact: interfaces

Более глубокое изучение этой задачи:

  • Модули cli_parse автоматически преобразуют ansible_network_os (в данном примере, ansible_network_os установлено как cisco.nxos.nxos, преобразуется в nxos для pyATS. В качестве альтернативы можно указать операционную систему с помощью опции parser/os вместо этого).
  • Используя комбинацию команды и операционной системы, pyATS выбирает следующий парсер: https://pubhub.devnetcloud.com/media/genie-feature-browser/docs/#/parsers/show%2520interface.
  • Модуль cli_parse устанавливает cisco.ios.ios в iosxe для pyATS. Это можно переопределить с помощью опции parser/os.
  • cli_parse использует только предварительно определённые парсеры в pyATS. См. документацию pyATS по адресу https://developer.cisco.com/docs/pyats/ и полный список включенных в pyATS парсеров по адресу https://pubhub.devnetcloud.com/media/genie-feature-browser/docs/#/parsers.

Примечание

Поддержка Red Hat Ansible Automation Platform ограничена использованием публичных API pyATS в соответствии с документацией.

Эта задача устанавливает следующий факт в качестве факта interfaces для хоста:

mgmt0:
  admin_state: up
  auto_mdix: 'off'
  auto_negotiate: true
  bandwidth: 1000000
  counters:
    in_broadcast_pkts: 3
    in_multicast_pkts: 1652395
    in_octets: 556155103
    in_pkts: 2236713
    in_unicast_pkts: 584259
    rate:
      in_rate: 320
      in_rate_pkts: 0
      load_interval: 1
      out_rate: 48
      out_rate_pkts: 0
    rx: true
    tx: true
  delay: 10
  duplex_mode: full
  enabled: true
  encapsulations:
    encapsulation: arpa
  ethertype: '0x0000'
  ipv4:
    192.168.101.14/24:
      ip: 192.168.101.14
      prefix_length: '24'
  link_state: up
  <...>

Разбор с помощью textfsm

textfsm — это модуль Python, реализующий основанную на шаблонах машину состояний для разбора полуформатированного текста.

Следующий пример шаблона ``textfsm`` хранится в templates/nxos_show_interface.textfsm.

Value Required INTERFACE (\S+)
Value LINK_STATUS (.+?)
Value ADMIN_STATE (.+?)
Value HARDWARE_TYPE (.\*)
Value ADDRESS ([a-zA-Z0-9]+.[a-zA-Z0-9]+.[a-zA-Z0-9]+)
Value BIA ([a-zA-Z0-9]+.[a-zA-Z0-9]+.[a-zA-Z0-9]+)
Value DESCRIPTION (.\*)
Value IP_ADDRESS (\d+\.\d+\.\d+\.\d+\/\d+)
Value MTU (\d+)
Value MODE (\S+)
Value DUPLEX (.+duplex?)
Value SPEED (.+?)
Value INPUT_PACKETS (\d+)
Value OUTPUT_PACKETS (\d+)
Value INPUT_ERRORS (\d+)
Value OUTPUT_ERRORS (\d+)
Value BANDWIDTH (\d+\s+\w+)
Value DELAY (\d+\s+\w+)
Value ENCAPSULATION (\w+)
Value LAST_LINK_FLAPPED (.+?)

Start
  ^\S+\s+is.+ -> Continue.Record
  ^${INTERFACE}\s+is\s+${LINK_STATUS},\sline\sprotocol\sis\s${ADMIN_STATE}$$
  ^${INTERFACE}\s+is\s+${LINK_STATUS}$$
  ^admin\s+state\s+is\s+${ADMIN_STATE},
  ^\s+Hardware(:|\s+is)\s+${HARDWARE_TYPE},\s+address(:|\s+is)\s+${ADDRESS}(.*bia\s+${BIA})*
  ^\s+Description:\s+${DESCRIPTION}
  ^\s+Internet\s+Address\s+is\s+${IP_ADDRESS}
  ^\s+Port\s+mode\s+is\s+${MODE}
  ^\s+${DUPLEX}, ${SPEED}(,|$$)
  ^\s+MTU\s+${MTU}.\*BW\s+${BANDWIDTH}.\*DLY\s+${DELAY}
  ^\s+Encapsulation\s+${ENCAPSULATION}
  ^\s+${INPUT_PACKETS}\s+input\s+packets\s+\d+\s+bytes\s\*$$
  ^\s+${INPUT_ERRORS}\s+input\s+error\s+\d+\s+short\s+frame\s+\d+\s+overrun\s+\d+\s+underrun\s+\d+\s+ignored\s\*$$
  ^\s+${OUTPUT_PACKETS}\s+output\s+packets\s+\d+\s+bytes\s\*$$
  ^\s+${OUTPUT_ERRORS}\s+output\s+error\s+\d+\s+collision\s+\d+\s+deferred\s+\d+\s+late\s+collision\s\*$$
  ^\s+Last\s+link\s+flapped\s+${LAST_LINK_FLAPPED}\s\*$$

В следующей задаче используется пример шаблона для textfsm с модулем cli_parse.

- name: "Run command and parse with textfsm"
  ansible.netcommon.cli_parse:
    command: show interface
    parser:
      name: ansible.netcommon.textfsm
    set_fact: interfaces

Более глубокое изучение этой задачи:

  • ansible_network_os для устройства (cisco.nxos.nxos) преобразуется в nxos. В качестве альтернативы можно указать операционную систему в опции parser/os.
  • Имя шаблона textfsm по умолчанию устанавливается как templates/nxos_show_interface.textfsm, используя комбинацию операционной системы и выполняемой команды. В качестве альтернативы, путь к сгенерированному шаблону можно переопределить с помощью опции parser/template_path.
  • Подробную информацию см. в файле README textfsm по адресу https://github.com/google/textfsm.
  • textfsm ранее был доступен как плагин фильтра. Пользователи Ansible должны перейти на модуль cli_parse.

Примечание

Поддержка Red Hat Ansible Automation Platform ограничена использованием публичных API textfsm в соответствии с документацией.

Эта задача устанавливает следующий факт в качестве факта interfaces для хоста:

- ADDRESS: X254.005a.f8b5
  ADMIN_STATE: up
  BANDWIDTH: 1000000 Kbit
  BIA: X254.005a.f8b5
  DELAY: 10 usec
  DESCRIPTION: ''
  DUPLEX: full-duplex
  ENCAPSULATION: ARPA
  HARDWARE_TYPE: Ethernet
  INPUT_ERRORS: ''
  INPUT_PACKETS: ''
  INTERFACE: mgmt0
  IP_ADDRESS: 192.168.101.14/24
  LAST_LINK_FLAPPED: ''
  LINK_STATUS: up
  MODE: ''
  MTU: '1500'
  OUTPUT_ERRORS: ''
  OUTPUT_PACKETS: ''
  SPEED: 1000 Mb/s
- ADDRESS: X254.005a.f8bd
  ADMIN_STATE: up
  BANDWIDTH: 1000000 Kbit
  BIA: X254.005a.f8bd

Разбор с помощью TTP

TTP — это библиотека Python для разбора полуструктурированного текста с использованием шаблонов. TTP использует синтаксис, похожий на jinja, для сокращения необходимости в регулярных выражениях. Пользователям, знакомым с шаблонами jinja, синтаксис шаблонов TTP может показаться знакомым.

Следующий пример шаблона TTP хранится в templates/nxos_show_interfaces.ttp:

{{ interface }} is {{ state }}
admin state is {{ admin_state }}{{ ignore(".\*") }}

В следующей задаче используется этот шаблон для разбора вывода команды show interface:

- name: "Run command and parse with ttp"
  ansible.netcommon.cli_parse:
    command: show interface
    parser:
      name: ansible.netcommon.ttp
    set_fact: interfaces

Более глубокое изучение этой задачи:

  • Путь к шаблону по умолчанию templates/nxos_show_interface.ttp был сгенерирован с использованием ansible_network_os для хоста и command.
  • TTP поддерживает несколько дополнительных переменных, которые будут переданы в парсер. К ним относятся:

    • parser/vars/ttp_init — дополнительный параметр, передаваемый при инициализации парсера.
    • parser/vars/ttp_results — дополнительные параметры, влияющие на вывод парсера.
    • parser/vars/ttp_vars — дополнительные переменные, доступные в шаблоне.
  • Подробную информацию см. в документации TTP по адресу https://ttp.readthedocs.io.

Задача устанавливает следующий факт в качестве факта interfaces для хоста:

- admin_state: up,
  interface: mgmt0
  state: up
- admin_state: up,
  interface: Ethernet1/1
  state: up
- admin_state: up,
  interface: Ethernet1/2
  state: up

Преобразование XML

Хотя Ansible содержит ряд плагинов, которые могут преобразовывать XML в собственные данные Ansible, модуль ``cli_parse`` выполняет команду на устройствах, возвращающих XML, и возвращает преобразованные данные в одной задаче.

В этом примере задачи выполняется команда show interface и парсится вывод в качестве XML:

- name: "Run command and parse as xml"
    ansible.netcommon.cli_parse:
      command: show interface | xml
      parser:
        name: ansible.netcommon.xml
  set_fact: interfaces

Примечание

Поддержка Red Hat Ansible Automation Platform ограничена использованием публичных API xmltodict в соответствии с документацией.

В этой задаче факт interfaces для хоста устанавливается на основе этого возвращённого вывода:

nf:rpc-reply:
  '@xmlns': http://www.cisco.com/nxos:1.0:if_manager
  '@xmlns:nf': urn:ietf:params:xml:ns:netconf:base:1.0
  nf:data:
    show:
      interface:
        __XML__OPT_Cmd_show_interface_quick:
          __XML__OPT_Cmd_show_interface___readonly__:
            __readonly__:
              TABLE_interface:
                ROW_interface:
                - admin_state: up
                  encapsulation: ARPA
                  eth_autoneg: 'on'
                  eth_bia_addr: x254.005a.f8b5
                  eth_bw: '1000000'

Расширенные варианты использования

Модуль cli_parse поддерживает несколько функций для поддержки более сложных вариантов использования.

Указать полный путь к шаблону

Используйте опцию template_path для переопределения пути к шаблону по умолчанию в задаче:

- name: "Run command and parse with native"
  ansible.netcommon.cli_parse:
    command: show interface
    parser:
      name: ansible.netcommon.native
      template_path: /home/user/templates/filename.yaml

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

Используйте подопцию command для parser, чтобы настроить команду, ожидаемую парсером, если она отличается от команды, которую cli_parse выполняет:

- name: "Run command and parse with native"
  ansible.netcommon.cli_parse:
    command: sho int
    parser:
      name: ansible.netcommon.native
      command: show interface

Указать пользовательское значение ОС

Используйте подопцию os для парсера, чтобы напрямую установить ОС вместо использования ansible_network_os или ansible_distribution для генерации пути к шаблону или с указанным движком парсера:

- name: Use ios instead of iosxe for pyats
  ansible.netcommon.cli_parse:
    command: show something
    parser:
      name: ansible.netcommon.pyats
      os: ios

- name: Use linux instead of fedora from ansible_distribution
  ansible.netcommon.cli_parse:
    command: ps -ef
    parser:
      name: ansible.netcommon.native
      os: linux

Разбор существующего текста

Используйте опцию text вместо command для разбора текста, собранного ранее в задаче:

# using /home/user/templates/filename.yaml
- name: "Parse text from previous task"
  ansible.netcommon.cli_parse:
    text: "{{ output['stdout'] }}"
    parser:
      name: ansible.netcommon.native
      template_path: /home/user/templates/filename.yaml

 # using /home/user/templates/filename.yaml
- name: "Parse text from file"
  ansible.netcommon.cli_parse:
    text: "{{ lookup('file', 'path/to/file.txt') }}"
    parser:
      name: ansible.netcommon.native
      template_path: /home/user/templates/filename.yaml

# using templates/nxos_show_version.yaml
- name: "Parse text from previous task"
  ansible.netcommon.cli_parse:
    text: "{{ sho_version['stdout'] }}"
    parser:
      name: ansible.netcommon.native
      os: nxos
      command: show version

См. также

  • Разработка плагинов cli_parser в коллекции

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/network/user_guide/cli_parsing.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API