Модули ресурсов сети

Модули ресурсов сети Ansible упрощают и стандартизируют управление различными сетевыми устройствами. Сетевые устройства разделяют конфигурацию на секции (такие как интерфейсы и VLAN) , которые применяются к сетевой службе. Модули ресурсов сети Ansible используют это, позволяя настраивать подсекции или ресурсы в конфигурации сетевого устройства. Модули ресурсов сети обеспечивают согласованный опыт работы с различными сетевыми устройствами.

• Состояния модулей ресурсов сети
• Использование модулей ресурсов сети
• Пример: Проверка того, что конфигурация сетевого устройства не изменилась
• Пример: Получение и обновление VLAN на сетевом устройстве

Состояния модулей ресурсов сети

Вы используете модули ресурсов сети, назначая состояние тому, что вы хотите, чтобы модуль делал. Модули ресурсов поддерживают следующие состояния:

merged

Ansible объединяет конфигурацию на устройстве с предоставленной конфигурацией в задаче.

replaced

Ansible заменяет подсекцию конфигурации на устройстве подсекцией предоставленной конфигурации в задаче.

overridden

Ansible перезаписывает конфигурацию на устройстве для ресурса предоставленной конфигурацией в задаче. Будьте осторожны с этим состоянием, так как вы можете лишиться доступа к устройству (например, переопределив конфигурацию интерфейса управления).

deleted

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

gathered

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

rendered

Ansible преобразует предоставленную конфигурацию в задаче в формат, специфичный для устройства (например, Cisco IOS CLI). Ansible возвращает эту обработанную конфигурацию в ключе rendered в результате. Обратите внимание, что это состояние не взаимодействует с сетевым устройством и может использоваться автономно.

parsed

Ansible анализирует конфигурацию из параметра running_configuration в структурированные данные Ansible в ключе parsed в результате. Обратите внимание, что это состояние не собирает конфигурацию с сетевого устройства, поэтому это состояние может использоваться автономно.

Использование модулей ресурсов сети

В этом примере настраивается ресурс интерфейса L3 на устройстве Cisco IOS, в зависимости от различных параметров состояния.

- name: configure l3 interface
  cisco.ios.ios_l3_interfaces:
    config: "{{ config }}"
    state: <state>

В следующей таблице показан пример того, как начальная конфигурация ресурса изменяется с помощью этой задачи для разных состояний.

interface loopback100
 ip address 10.10.1.100 255.255.255.0
 ipv6 address FC00:100/64

config:
- ipv6:
 - address: fc00::100/64
 - address: fc00::101/64
 name: loopback100

Модули ресурсов сети возвращают следующие сведения:

• Состояние before — существующая конфигурация ресурса до выполнения задачи.
• Состояние after — новая конфигурация ресурса, которая существует на сетевом устройстве после выполнения задачи.
• Команды — любые настроенные на устройстве команды.

ok: [nxos101] =>
  result:
    after:
      contact: IT Support
      location: Room E, Building 6, Seattle, WA 98134
      users:
      - algorithm: md5
        group: network-admin
        localized_key: true
        password: '0x73fd9a2cc8c53ed3dd4ed8f4ff157e69'
        privacy_password: '0x73fd9a2cc8c53ed3dd4ed8f4ff157e69'
        username: admin
    before:
      contact: IT Support
      location: Room E, Building 5, Seattle HQ
      users:
      - algorithm: md5
        group: network-admin
        localized_key: true
        password: '0x73fd9a2cc8c53ed3dd4ed8f4ff157e69'
        privacy_password: '0x73fd9a2cc8c53ed3dd4ed8f4ff157e69'
        username: admin
    changed: true
    commands:
    - snmp-server location Room E, Building 6, Seattle, WA 98134
    failed: false

Пример: Проверка того, что конфигурация сетевого устройства не изменилась

В следующем плейбуке используется модуль arista.eos.eos_l3_interfaces для сбора подмножества конфигурации сетевого устройства (только интерфейсы уровня 3) и проверки точности информации и того, что она не изменилась. Этот плейбук передает результаты arista.eos.eos_facts непосредственно в модуль arista.eos.eos_l3_interfaces.

- name: Example of facts being pushed right back to device.
  hosts: arista
  gather_facts: false
  tasks:
    - name: grab arista eos facts
      arista.eos.eos_facts:
        gather_subset: min
        gather_network_resources: l3_interfaces

- name: Ensure that the IP address information is accurate.
  arista.eos.eos_l3_interfaces:
    config: "{{ ansible_network_resources['l3_interfaces'] }}"
    register: result

- name: Ensure config did not change.
  assert:
    that: not result.changed

Пример: Получение и обновление VLAN на сетевом устройстве

В этом примере показано, как вы можете использовать модули ресурсов для:

1. Получения текущей конфигурации на сетевом устройстве.
2. Сохранения этой конфигурации локально.
3. Обновления этой конфигурации и применения её к сетевому устройству.

В этом примере используется модуль ресурса cisco.ios.ios_vlans для получения и обновления VLAN на устройстве IOS.

1. Получение текущей конфигурации VLAN IOS:

- name: Gather VLAN information as structured data
  cisco.ios.ios_facts:
     gather_subset:
      - '!all'
      - '!min'
     gather_network_resources:
     - 'vlans'

2. Сохранение конфигурации VLAN локально:

- name: Store VLAN facts to host_vars
  copy:
    content: "{{ ansible_network_resources | to_nice_yaml }}"
    dest: "{{ playbook_dir }}/host_vars/{{ inventory_hostname }}"

3. Изменение сохранённого файла для обновления конфигурации VLAN локально.
4. Объединение обновлённой конфигурации VLAN с существующей конфигурацией на устройстве:

- name: Make VLAN config changes by updating stored facts on the controller.
  cisco.ios.ios_vlans:
    config: "{{ vlans }}"
    state: merged
  tags: update_config