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

Примечание

Этот модуль входит в коллекцию community.network (версия 5.0.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network.

Для использования в плейбуке укажите: community.network.ce_evpn_bd_vni.

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

Обзор

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

Псевдонимы: network.cloudengine.ce_evpn_bd_vni

Параметры

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

Примечания

Примечание

Убедитесь, что EVPN настроен для работы в качестве контрольной плоскости VXLAN, когда state задан.
Убедитесь, что домен моста (BD) существует, когда state задан.
Убедитесь, что VNI создан и ассоциирован с областью широковещательной передачи (BD), когда state задан.
Если вы настраиваете 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-целей существует, в противном случае будет ошибка.
Для этого модуля требуется, чтобы служба netconf была включена на управляемом удалённом устройстве.
Рекомендуемое соединение – netconf.
Этот модуль также работает с local соединениями для устаревших плейбуков.

Примеры

- name: EVPN BD VNI test
  hosts: cloudengine
  connection: local
  gather_facts: false
  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"
    community.network.ce_evpn_bd_vni:
      bridge_domain_id: 20
      evpn: enable
      provider: "{{ cli }}"

  - name: "Configure a route distinguisher (RD) for a BD EVPN instance"
    community.network.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"
    community.network.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"
    community.network.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"
    community.network.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"
    community.network.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"
    community.network.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"
    community.network.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"
    community.network.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"
    community.network.ce_evpn_bd_vni:
      bridge_domain_id: 20
      evpn: disable
      provider: "{{ cli }}"

Значения возврата

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

Ключ	Описание
changed boolean	проверка, были ли внесены изменения на устройстве Возвращается: всегда Пример: `true`
end_state словарь	пара ключ/значение конечных атрибутов на устройстве Возвращается: всегда Пример: `{"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 словарь	пара ключ/значение существующих атрибутов на устройстве Возвращается: всегда Пример: `{"bridge_domain_id": "2", "evpn": "disable", "route_distinguisher": null, "vpn_target_both": [], "vpn_target_export": [], "vpn_target_import": []}`
proposed словарь	пара ключ/значение параметров, переданных в модуль Возвращается: всегда Пример: `{"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"]`

Авторы

Zhijin Zhou (@QijunPan)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/ce_evpn_bd_vni_module.html