community.network.ce_bgp_af – Управляет конфигурацией семейства адресов BGP на коммутаторах HUAWEI CloudEngine.
Примечание
Этот плагин входит в коллекцию community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в плейбуке укажите: community.network.ce_bgp_af.
Обзор
- Управляет конфигурациями семейств адресов BGP на коммутаторах HUAWEI CloudEngine.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active_route_advertise строка |
| Если значение равно true, BGP включен для рекламы только оптимальных маршрутов в RM peer. Если значение равно false, BGP не включен для рекламы только оптимальных маршрутов в RM peer. |
| add_path_sel_num строка | Количество маршрутов Add-Path. Значение является целым числом от 2 до 64. | |
| af_type строка / обязательно |
| Тип адресной семьи BGP инстанса. |
| allow_invalid_as строка |
| Разрешить маршруты с результатом проверки AS источника BGP «Недействительный» для выбора. Если значение true, недопустимые маршруты могут участвовать в выборе маршрута. Если значение false, недопустимые маршруты не могут участвовать в выборе маршрута. |
| always_compare_med строка |
| Если значение равно true, значения MED маршрутов, полученных от peer в разных автономных системах, сравниваются при выборе BGP оптимального маршрута. Если значение равно false, значения MED маршрутов, полученных от peer в разных автономных системах, не сравниваются при выборе BGP оптимального маршрута. |
| as_path_neglect строка |
| Если значение равно true, атрибут AS path игнорируется при выборе BGP оптимального маршрута. Если значение равно false, атрибут AS path не игнорируется при выборе BGP оптимального маршрута. AS path с меньшей длиной имеет более высокий приоритет. |
| auto_frr_enable строка |
| Если значение равно true, авто FRR BGP включен. Если значение равно false, авто FRR BGP выключен. |
| default_local_pref строка | Установить атрибут Local-Preference. Значение — целое число. Значение — целое число в диапазоне от 0 до 4294967295. | |
| default_med строка | Указать Multi-Exit-Discriminator (MED) для BGP маршрутов. Значение — целое число в диапазоне от 0 до 4294967295. | |
| default_rt_import_enable строка |
| Если значение равно true, разрешено импортировать маршруты по умолчанию в таблицу маршрутизации BGP. Если значение равно false, импорт маршрутов по умолчанию в таблицу маршрутизации BGP запрещен. |
| determin_med строка |
| Если значение равно true, детерминированный MED BGP включен. Если значение равно false, детерминированный MED BGP выключен. |
| ebgp_ecmp_nexthop_changed строка |
| Если значение равно true, следующий хоп рекламируемого маршрута изменяется на рекламодателя в сценариях балансировки нагрузки EBGP. Если значение равно false, следующий хоп рекламируемого маршрута не изменяется на рекламодателя в сценариях балансировки нагрузки EBGP. |
| ebgp_if_sensitive строка |
| Если значение равно true, после включения функции быстрой осведомлённости о интерфейсах EBGP, сессии EBGP на интерфейсе удаляются немедленно, когда интерфейс переходит в состояние Down. Если значение равно false, после включения функции быстрой осведомлённости о интерфейсах EBGP, сессии EBGP на интерфейсе не удаляются немедленно, когда интерфейс переходит в состояние Down. |
| ecmp_nexthop_changed строка |
| Если значение равно true, следующий хоп рекламируемого маршрута изменяется на рекламодателя в сценариях балансировки нагрузки BGP. Если значение равно false, следующий хоп рекламируемого маршрута не изменяется на рекламодателя в сценариях балансировки нагрузки BGP. |
| ibgp_ecmp_nexthop_changed строка |
| Если значение равно true, следующий хоп рекламируемого маршрута изменяется на рекламодателя в сценариях балансировки нагрузки IBGP. Если значение равно false, следующий хоп рекламируемого маршрута не изменяется на рекламодателя в сценариях балансировки нагрузки IBGP. |
| igp_metric_ignore строка |
| Если значение равно true, метрики маршрутов IGP следующего хопа не сравниваются при выборе BGP оптимального маршрута. Если значение равно false, метрики маршрутов IGP следующего хопа не сравниваются при выборе BGP оптимального маршрута. Маршрут с меньшей метрикой имеет более высокий приоритет. |
| import_process_id строка | Идентификатор процесса импортированного протокола маршрутизации. Значение — целое число от 0 до 4294967295. | |
| import_protocol строка |
| Протокол маршрутизации, из которого можно импортировать маршруты. |
| ingress_lsp_policy_name строка | Имя политики ingress lsp. | |
| load_balancing_as_path_ignore строка |
| Игнорирование AS path при балансировке нагрузки. |
| lowest_priority строка |
| Если значение равно true, включить понижение приоритета для рекламы маршрута. Если значение равно false, выключить понижение приоритета для рекламы маршрута. |
| mask_len строка | Указать длину маски IP адреса. Значение — целое число в диапазоне от 0 до 128. | |
| max_load_ebgp_num строка | Указать максимальное количество маршрутов EBGP с равной стоимостью. Значение — целое число от 1 до 65535. | |
| max_load_ibgp_num строка | Указать максимальное количество маршрутов IBGP с равной стоимостью. Значение — целое число от 1 до 65535. | |
| maximum_load_balance строка | Указать максимальное количество маршрутов с равной стоимостью в таблице маршрутизации BGP. Значение — целое число от 1 до 65535. | |
| med_none_as_maximum строка |
| Если значение равно true, при выборе BGP оптимального маршрута, система использует значение MED 4294967295 для маршрута, если атрибут маршрута не содержит значения MED. Если значение равно false, система использует значение MED 0 для маршрута, если атрибут маршрута не содержит значения MED. |
| network_address строка | Указать IP адрес, рекламируемый BGP. Значение — строка от 0 до 255 символов. | |
| next_hop_sel_depend_type строка |
| Тип зависимости выбора следующего хопа. |
| nexthop_third_party строка |
| Если значение равно true, функция третьего хопа включена. Если значение равно false, функция третьего хопа выключена. |
| nhp_relay_route_policy_name строка | Указать имя политики маршрутизации для итерации маршрутов. Значение — строка от 1 до 40 символов. | |
| originator_prior строка |
| Приоритет рекламодателя. |
| policy_ext_comm_enable строка |
| Если значение равно true, изменение расширенных атрибутов сообщений разрешено. Если значение равно false, изменение расширенных атрибутов сообщений запрещено. |
| policy_vpn_target строка |
| Если значение равно true, выполняется фильтрация VPN-Target для принятых VPN маршрутов. Если значение равно false, фильтрация VPN-Target для принятых VPN маршрутов не выполняется. |
| preference_external строка | Установить приоритет протокола для маршрутов EBGP. Значение — целое число от 1 до 255. | |
| preference_internal строка | Установить приоритет протокола для маршрутов IBGP. Значение — целое число от 1 до 255. | |
| preference_local строка | Установить приоритет протокола для локального BGP маршрута. Значение — целое число от 1 до 255. |
| prefrence_policy_name string | Установите политику маршрутизации для фильтрации маршрутов, чтобы применить настроенный приоритет к маршрутам, соответствующим указанной политике. Значение представляет собой строку длиной от 1 до 40 символов. | |
| reflect_between_client string |
| Если значение равно true, рефлексия маршрутов включена между клиентами. Если значение равно false, рефлексия маршрутов отключена между клиентами. |
| reflect_chg_path string |
| Если значение равно true, рефлектор маршрутов включён для изменения атрибутов пути маршрута на основе политики экспорта. Если значение равно false, рефлектор маршрутов отключен от изменения атрибутов пути маршрута на основе политики экспорта. |
| reflector_cluster_id string | Установите идентификатор кластера. Настройка нескольких рефлекторов маршрутов в кластере может повысить стабильность сети. Значение представляет собой целое число от 1 до 4294967295. | |
| reflector_cluster_ipv4 string | Установите адрес кластера ipv4. Значение выражается в формате адреса IPv4. | |
| relay_delay_enable string |
| Если значение равно true, включение задержки ретрансляции. Если значение равно false, отключение задержки ретрансляции. |
| rib_only_enable string |
| Если значение равно true, маршруты BGP не могут быть объявлены в таблице маршрутизации IP. Если значение равно false, маршруты, предпочтительные для BGP, объявляются в таблице маршрутизации IP. |
| rib_only_policy_name string | Укажите имя политики маршрутизации. Значение представляет собой строку длиной от 1 до 40 символов. | |
| route_sel_delay string | Задержка выбора маршрута. Значение представляет собой целое число от 0 до 3600. | |
| router_id string | Идентификатор маршрутизатора в формате IPv4. Значение представляет собой строку длиной от 0 до 255 символов. Значение представлено в точечной десятичной записи. | |
| router_id_neglect string |
| Если значение равно true, атрибут идентификатора маршрутизатора игнорируется при выборе оптимального маршрута BGP. Если значение равно false, атрибут идентификатора маршрутизатора не игнорируется при выборе оптимального маршрута BGP. |
| rr_filter_number string | Установите номер расширенного фильтра сообщества, поддерживаемого группой RR. Значение представляет собой строку длиной от 1 до 51 символа. | |
| state string |
| Укажите желаемое состояние ресурса. |
| summary_automatic string |
| Если значение равно true, автоматическое агрегирование включено для локально импортированных маршрутов. Если значение равно false, автоматическое агрегирование отключено для локально импортированных маршрутов. |
| supernet_label_adv string |
| Если значение равно true, функция объявления метки суперсети включена. Если значение равно false, функция объявления метки суперсети отключена. |
| supernet_uni_adv string |
| Если значение равно true, функция объявления маршрутов суперсети одноадресной включена. Если значение равно false, функция объявления маршрутов суперсети одноадресной отключена. |
| vrf_name string / required | Имя экземпляра BGP. Имя — это чувствительная к регистру строка символов. Экземпляр BGP можно использовать только после создания соответствующего экземпляра VPN. Значение представляет собой строку длиной от 1 до 31 символа, чувствительную к регистру. | |
| vrf_rid_auto_sel string |
| Если значение равно true, экземпляры VPN BGP включены для автоматического выбора идентификаторов маршрутизаторов. Если значение равно false, экземпляры VPN BGP отключены от автоматического выбора идентификаторов маршрутизаторов. |
Примечания
Примечание
- Для этого модуля требуется, чтобы служба netconf системы была включена на удалённом управляемом устройстве.
- Рекомендуемое соединение —
netconf. - Этот модуль также работает с
localподключениями для устаревших playbooks.
Примеры
- name: CloudEngine BGP address family 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: "Config BGP Address_Family"
community.network.ce_bgp_af:
state: present
vrf_name: js
af_type: ipv4uni
provider: "{{ cli }}"
- name: "Undo BGP Address_Family"
community.network.ce_bgp_af:
state: absent
vrf_name: js
af_type: ipv4uni
provider: "{{ cli }}"
- name: "Config import route"
community.network.ce_bgp_af:
state: present
vrf_name: js
af_type: ipv4uni
import_protocol: ospf
import_process_id: 123
provider: "{{ cli }}"
- name: "Undo import route"
community.network.ce_bgp_af:
state: absent
vrf_name: js
af_type: ipv4uni
import_protocol: ospf
import_process_id: 123
provider: "{{ cli }}"
- name: "Config network route"
community.network.ce_bgp_af:
state: present
vrf_name: js
af_type: ipv4uni
network_address: 1.1.1.1
mask_len: 24
provider: "{{ cli }}"
- name: "Undo network route"
community.network.ce_bgp_af:
state: absent
vrf_name: js
af_type: ipv4uni
network_address: 1.1.1.1
mask_len: 24
provider: "{{ cli }}"
Значения возврата
Общие значения возврата описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed boolean | всегда | проверка, было ли изменение на устройстве Пример: True |
| end_state словарь | всегда | пара ключ-значение параметров aaa после выполнения модуля Пример: {'af_type': 'ipv4uni', 'vrf_name': 'js'} |
| existing словарь | всегда | пара ключ-значение существующего aaa сервера |
| proposed словарь | всегда | пара ключ-значение параметров, переданных в модуль Пример: {'af_type': 'ipv4uni', 'state': 'present', 'vrf_name': 'js'} |
| updates список / элементы=строка | всегда | команда, отправленная на устройство Пример: ['ipv4-family vpn-instance js'] |
Авторы
- wangdezhuang (@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.10/collections/community/network/ce_bgp_af_module.html