ce_evpn_bd_vni — Управляет идентификатором сети EVPN VXLAN (VNI) на коммутаторах HUAWEI CloudEngine.

Новая версия с 2.4.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Обзор

Управляет конфигурациями идентификаторов сети VXLAN (VNI) Ethernet Virtual Private Network (EVPN) на коммутаторах HUAWEI CloudEngine.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
bridge_domain_id обязательно		Укажите существующий домен моста (BD). Значение — целое число от 1 до 16777215.
evpn	Варианты: enable ← disable	Создать или удалить экземпляр EVPN для VXLAN в представлении BD.
route_distinguisher		Настраивает различатель маршрутов (RD) для экземпляра BD EVPN. Формат RD может быть следующим: 1) 2-байтовое число AS: 4-байтовое пользовательское число, например, 1:3. Число AS — целое число от 0 до 65535, а пользовательское число — целое число от 0 до 4294967295. Числа AS и пользовательское число не могут быть одновременно равны 0. Это означает, что RD не может быть 0:0. 2) Целое 4-байтовое число AS: 2-байтовое пользовательское число, например, 65537:3. Число AS — целое число от 65536 до 4294967295, а пользовательское число — целое число от 0 до 65535. 3) 4-байтовое число AS в точечной нотации: 2-байтовое пользовательское число, например, 0.0:3 или 0.1:0. 4-байтовое число AS в точечной нотации имеет формат x.y, где x и y — целые числа от 0 до 65535. 4) Пользовательское число — целое число от 0 до 65535. Числа AS и пользовательское число не могут быть одновременно равны 0. Это означает, что RD не может быть 0.0:0. 5) 32-битный IP-адрес: 2-байтовое пользовательское число. Например, 192.168.122.15:1. IP-адрес находится в диапазоне от 0.0.0.0 до 255.255.255.255, а пользовательское число — целое число от 0 до 65535. 6) «auto» указывает автоматически сгенерированный RD.
state	Варианты: present ← absent	Управление состоянием ресурса.
vpn_target_both		Добавление VPN-целей как в список импорта, так и в список экспорта VPN-целей экземпляра BD EVPN. Формат аналогичен route_distinguisher.
vpn_target_export		Добавление VPN-целей в список экспорта VPN-целей экземпляра BD EVPN. Формат аналогичен route_distinguisher.
vpn_target_import обязательно		Добавление VPN-целей в список импорта VPN-целей экземпляра BD EVPN. Формат аналогичен route_distinguisher.

Примечания

Примечание

Убедитесь, что EVPN настроен в качестве контрольной плоскости VXLAN при state=present.
Убедитесь, что домен моста (BD) существует при state=present.
Убедитесь, что VNI создан и связан с областью широковещательной передачи (BD) при state=present.
Если настроить evpn:false для удаления экземпляра EVPN, все конфигурации в этом экземпляре удаляются.
После создания экземпляра EVPN в представлении BD вы можете настроить RD с помощью параметра route_distinguisher в представлении экземпляра BD-EVPN.
Прежде чем настроить VPN-цели для экземпляра BD EVPN, убедитесь, что для этого экземпляра настроен RD.
Если вы отключаете route_distinguisher, все атрибуты VPN-целей для экземпляра BD EVPN будут удалены одновременно.
При использовании state:absent параметр evpn не поддерживается и будет проигнорирован.
При использовании state:absent для удаления атрибутов VPN-целей убедитесь, что конфигурация атрибутов VPN-целей существует; в противном случае будет выдано сообщение об ошибке.

Примеры

- name: EVPN BD VNI test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: "Configure an EVPN instance for a VXLAN in BD view"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      evpn: enable
      provider: "{{ cli }}"

  - name: "Configure a route distinguisher (RD) for a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      route_distinguisher: '22:22'
      provider: "{{ cli }}"

  - name: "Configure VPN targets to both the import and export VPN target lists of a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      vpn_target_both: 22:100,22:101
      provider: "{{ cli }}"

  - name: "Configure VPN targets to the import VPN target list of a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      vpn_target_import: 22:22,22:23
      provider: "{{ cli }}"

  - name: "Configure VPN targets to the export VPN target list of a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      vpn_target_export: 22:38,22:39
      provider: "{{ cli }}"

  - name: "Unconfigure VPN targets to both the import and export VPN target lists of a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      vpn_target_both: '22:100'
      state: absent
      provider: "{{ cli }}"

  - name: "Unconfigure VPN targets to the import VPN target list of a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      vpn_target_import: '22:22'
      state: absent
      provider: "{{ cli }}"

  - name: "Unconfigure VPN targets to the export VPN target list of a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      vpn_target_export: '22:38'
      state: absent
      provider: "{{ cli }}"

  - name: "Unconfigure a route distinguisher (RD) of a BD EVPN instance"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      route_distinguisher: '22:22'
      state: absent
      provider: "{{ cli }}"

  - name: "Unconfigure an EVPN instance for a VXLAN in BD view"
    ce_evpn_bd_vni:
      bridge_domain_id: 20
      evpn: disable
      provider: "{{ cli }}"

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

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

Ключ	Возвращаемое значение	Описание
changed boolean	всегда	Проверка внесения изменений на устройстве Пример: True
end_state dict	всегда	Пара К/З конечных атрибутов на устройстве Пример: {'bridge_domain_id': '2', 'evpn': 'enable', 'route_distinguisher': '22:22', 'vpn_target_both': ['22:100', '22:101'], 'vpn_target_export': ['22:38', '22:39'], 'vpn_target_import': ['22:22', '22:23']}
existing dict	всегда	Пара К/З существующих атрибутов на устройстве Пример: {'bridge_domain_id': '2', 'evpn': 'disable', 'route_distinguisher': None, 'vpn_target_both': [], 'vpn_target_export': [], 'vpn_target_import': []}
proposed dict	всегда	Пара К/З параметров, переданных в модуль Пример: {'bridge_domain_id': '2', 'evpn': 'enable', 'route_distinguisher': '22:22', 'state': 'present', 'vpn_target_both': ['22:100', '22:101'], 'vpn_target_export': ['22:38', '22:39'], 'vpn_target_import': ['22:22', '22:23']}
updates список	всегда	Список команд, отправленных на устройство Пример: ['bridge-domain 2', ' evpn', ' route-distinguisher 22:22', ' vpn-target 22:38 export-extcommunity', ' vpn-target 22:39 export-extcommunity', ' vpn-target 22:100 export-extcommunity', ' vpn-target 22:101 export-extcommunity', ' vpn-target 22:22 import-extcommunity', ' vpn-target 22:23 import-extcommunity', ' vpn-target 22:100 import-extcommunity', ' vpn-target 22:101 import-extcommunity']

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Поддержка и техническое обслуживание модулей.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

Zhijin Zhou (@CloudEngine-Ansible)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.

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