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. |
Примеры
- 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 | k/v пары конечных атрибутов на устройстве |
всегда | словарь | {'vpn_target_export': ['22:38', '22:39'], 'route_distinguisher': '22:22', 'vpn_target_both': ['22:100', '22:101'], 'evpn': 'включено', 'vpn_target_import': ['22:22', '22:23'], 'bridge_domain_id': '2'} |
| existing | k/v пары существующих атрибутов на устройстве |
всегда | словарь | {'vpn_target_export': [], 'route_distinguisher': None, 'vpn_target_both': [], 'evpn': 'выключено', 'vpn_target_import': [], 'bridge_domain_id': '2'} |
| proposed | k/v пары параметров, переданных в модуль |
всегда | словарь | {'vpn_target_export': ['22:38', '22:39'], 'state': 'настоящее', 'route_distinguisher': '22:22', 'vpn_target_both': ['22:100', '22:101'], 'evpn': 'включено', 'vpn_target_import': ['22:22', '22:23'], 'bridge_domain_id': '2'} |
| 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'] |
Примечания
Примечание
- Убедитесь, что 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-целей существовала, иначе будет выдано сообщение об ошибке.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Для получения помощи в разработке модулей ознакомьтесь с Информация о сообществе и вклад, Тестирование 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.4/ce_evpn_bd_vni_module.html