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

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

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
bridge_domain_id - / обязательно		Укажите существующий мост домен (BD). Значение является целым числом от 1 до 16777215.
evpn -	Варианты: включить ← выключить	Создать или удалить экземпляр EVPN для VXLAN в представлении BD.
route_distinguisher -		Настраивает различающий маршрут (RD) для экземпляра BD EVPN. Формат RD может быть следующим: 1) 2-байтовое значение AS: 4-байтовое пользовательское значение, например, 1:3. Значение AS — целое число от 0 до 65535, а пользовательское значение — целое число от 0 до 4294967295. Значения AS и пользовательского значения не могут быть одновременно нулевыми. Это означает, что 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 и пользовательского значения не могут быть одновременно нулевыми. Это означает, что 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 -	Варианты: наличие ← отсутствие	Управление состоянием ресурса.
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 при наличии состояния.
Убедитесь, что мост домен (BD) существует при наличии состояния.
Убедитесь, что VNI был создан и связан с областью широковещательной передачи (BD) при наличии состояния.
Если вы настроили evpn:false для удаления экземпляра EVPN, все конфигурации в экземпляре EVPN будут удалены.
После создания экземпляра EVPN в представлении BD вы можете настроить RD с помощью параметра route_distinguisher в представлении экземпляра BD-EVPN.
Прежде чем настраивать VPN-цели для экземпляра BD EVPN, убедитесь, что для экземпляра BD EVPN настроен RD.
Если вы отменили настройку route_distinguisher, все атрибуты VPN-целей для экземпляра BD EVPN будут удалены одновременно.
При использовании state:absent evpn не поддерживается и будет проигнорирован.
При использовании state:absent для удаления атрибутов VPN-целей убедитесь, что конфигурация атрибутов VPN-целей существует, иначе будет сообщено об ошибке.
Для данного модуля требуется, чтобы на удалённом управляемом устройстве была включена служба системы netconf.
Рекомендуемое подключение netconf.
Этот модуль также работает с подключениями local для устаревших playbooks.

Примеры

- 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 словарь	всегда	пара ключ-значение конечных атрибутов на устройстве Пример: {'bridge_domain_id': '2', 'evpn': 'включить', '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 словарь	всегда	пара ключ-значение существующих атрибутов на устройстве Пример: {'bridge_domain_id': '2', 'evpn': 'выключить', 'route_distinguisher': None, 'vpn_target_both': [], 'vpn_target_export': [], 'vpn_target_import': []}
proposed словарь	всегда	пара ключ-значение параметров, переданных в модуль Пример: {'bridge_domain_id': '2', 'evpn': 'включить', 'route_distinguisher': '22:22', 'state': 'наличие', '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. [сообщество]

Авторы

Zhijin Zhou (@QijunPan)

Подсказка

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

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