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 -	Варианты: включено ← выключено	Создать или удалить экземпляр 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, когда state — текущее состояние.
Убедитесь, что мост домен (BD) существует, когда state — текущее состояние.
Убедитесь, что VNI создан и связан с областью широковещательной передачи (BD), когда state — текущее состояние.
Если вы настроите 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 логический тип	всегда	Проверка, были ли внесены изменения на устройстве Пример: 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.9/modules/ce_evpn_bd_vni_module.html