ce_bgp_af — Управляет настройкой семейства адресов BGP на коммутаторах HUAWEI CloudEngine.
Новая в версии 2.4.
Описание
- Управляет настройками семейства адресов BGP на коммутаторах HUAWEI CloudEngine.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active_route_advertise |
| Если значение равно true, BGP включён для рекламы только оптимальных маршрутов в RM для пэров. Если значение равно false, BGP не включён для рекламы только оптимальных маршрутов в RM для пэров. |
| add_path_sel_num | Значение по умолчанию: None | Количество маршрутов Add-Path. Значение — целое число от 2 до 64. |
| af_type обязательно |
| Тип семейства адресов BGP-инстанса. |
| allow_invalid_as |
| Разрешить маршруты с результатом проверки валидации AS BGP — Invalid для выбора. Если значение равно true, недопустимые маршруты могут участвовать в выборе маршрута. Если значение равно false, недопустимые маршруты не могут участвовать в выборе маршрута. |
| always_compare_med |
| Если значение равно true, MED-значения маршрутов, полученных от пэров в разных автономных системах, сравниваются при выборе BGP оптимального маршрута. Если значение равно false, MED-значения маршрутов, полученных от пэров в разных автономных системах, не сравниваются при выборе BGP оптимального маршрута. |
| as_path_neglect |
| Если значение равно true, атрибут AS path игнорируется при выборе BGP оптимального маршрута. Если значение равно false, атрибут AS path не игнорируется при выборе BGP оптимального маршрута. AS path с меньшей длиной имеет более высокий приоритет. |
| auto_frr_enable |
| Если значение равно true, автоматическое резервирование (BGP auto FRR) включено. Если значение равно false, автоматическое резервирование (BGP auto FRR) выключено. |
| default_local_pref | Значение по умолчанию: None | Устанавливает атрибут Local-Preference. Значение — целое число от 0 до 4294967295. |
| default_med | Значение по умолчанию: None | Указывает значение 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 | Значение по умолчанию: None | Идентификатор процесса импортированного протокола маршрутизации. Значение — целое число от 0 до 4294967295. |
| import_protocol |
None | Протокол маршрутизации, из которого можно импортировать маршруты. |
| ingress_lsp_policy_name | Значение по умолчанию: None | Имя политики ingress lsp. |
| load_balancing_as_path_ignore |
| Игнорирование AS path при балансировке нагрузки. |
| lowest_priority |
| Если значение равно true, включить уменьшение приоритета для рекламы маршрута. Если значение равно false, выключить уменьшение приоритета для рекламы маршрута. |
| mask_len | Значение по умолчанию: None | Указывает длину маски IP-адреса. Значение — целое число от 0 до 128. |
| max_load_ebgp_num | Значение по умолчанию: None | Указывает максимальное количество равностоимостных EBGP-маршрутов. Значение — целое число от 1 до 65535. |
| max_load_ibgp_num | Значение по умолчанию: None | Указывает максимальное количество равностоимостных IBGP-маршрутов. Значение — целое число от 1 до 65535. |
| maximum_load_balance | Значение по умолчанию: None | Указывает максимальное количество равностоимостных маршрутов в таблице маршрутизации BGP. Значение — целое число от 1 до 65535. |
| med_none_as_maximum |
| Если значение равно true, при выборе BGP оптимального маршрута система использует значение MED 4294967295 для маршрута, если атрибут маршрута не содержит значение MED. Если значение равно false, система использует значение MED 0 для маршрута, если атрибут маршрута не содержит значение MED. |
| network_address | Значение по умолчанию: None | Указывает IP-адрес, рекламируемый BGP. Значение — строка от 0 до 255 символов. |
| next_hop_sel_depend_type |
| Тип зависимости выбора следующего прыжка. |
| nexthop_third_party |
| Если значение равно true, функция следующего прыжка третьей стороны включена. Если значение равно false, функция следующего прыжка третьей стороны выключена. |
| nhp_relay_route_policy_name | Значение по умолчанию: None | Указывает имя политики маршрутизации для итерации маршрутов. Значение — строка от 1 до 40 символов. |
| originator_prior |
| Приоритет инициатора. |
| policy_ext_comm_enable |
| Если значение равно true, разрешено изменение атрибутов расширенного сообщества. Если значение равно false, изменение атрибутов расширенного сообщества запрещено. |
| policy_vpn_target |
| Если значение равно true, выполняется фильтрация VPN-цели для полученных VPN-маршрутов. Если значение равно false, фильтрация VPN-цели для полученных VPN-маршрутов не выполняется. |
| preference_external | Значение по умолчанию: None | Устанавливает приоритет протокола для EBGP-маршрутов. Значение — целое число от 1 до 255. |
| preference_internal | Значение по умолчанию: None | Устанавливает приоритет протокола для IBGP-маршрутов. Значение — целое число от 1 до 255. |
| preference_local | Значение по умолчанию: None | Устанавливает приоритет протокола для локального маршрута BGP. Значение — целое число от 1 до 255. |
| prefrence_policy_name | Значение по умолчанию: None | Устанавливает политику маршрутизации для фильтрации маршрутов, чтобы заданный приоритет применялся к маршрутам, соответствующим указанной политике. Значение — строка длиной от 1 до 40 символов. |
| reflect_between_client |
| Если значение true, отражение маршрутов включено между клиентами. Если значение false, отражение маршрутов отключено между клиентами. |
| reflect_chg_path |
| Если значение true, отражатель маршрутов включён для изменения атрибутов пути маршрута на основе политики экспорта. Если значение false, отражатель маршрутов отключён от изменения атрибутов пути маршрута на основе политики экспорта. |
| reflector_cluster_id | Значение по умолчанию: None | Устанавливает идентификатор кластера. Настройка нескольких отражателей маршрутов в кластере может повысить стабильность сети. Значение — целое число от 1 до 4294967295. |
| reflector_cluster_ipv4 | Значение по умолчанию: None | Устанавливает адрес кластера IPv4. Значение выражается в формате адреса IPv4. |
| relay_delay_enable |
| Если значение true, включено отложенное ретрансляции. Если значение false, отложенное ретрансляции отключено. |
| rib_only_enable |
| Если значение true, маршруты BGP не могут быть опубликованы в таблицу маршрутизации IP. Если значение false, маршруты, предпочтительные по BGP, публикуются в таблицу маршрутизации IP. |
| rib_only_policy_name | Значение по умолчанию: None | Указывает имя политики маршрутизации. Значение — строка длиной от 1 до 40 символов. |
| route_sel_delay | Значение по умолчанию: None | Задержка выбора маршрута. Значение — целое число от 0 до 3600. |
| router_id | Значение по умолчанию: None | Идентификатор маршрутизатора в формате IPv4-адреса. Значение — строка длиной от 0 до 255 символов. Значение в точечной десятичной нотации. |
| router_id_neglect |
| Если значение true, атрибут идентификатора маршрутизатора игнорируется при выборе оптимального маршрута BGP. Если значение false, атрибут идентификатора маршрутизатора не игнорируется при выборе оптимального маршрута BGP. |
| rr_filter_number | Значение по умолчанию: None | Устанавливает номер фильтра расширенных сообществ, поддерживаемого группой RR. Значение — строка длиной от 1 до 51 символа. |
| state |
| Указывает желаемое состояние ресурса. |
| summary_automatic |
| Если значение true, автоматическое агрегирование включено для локально импортированных маршрутов. Если значение false, автоматическое агрегирование отключено для локально импортированных маршрутов. |
| supernet_label_adv |
| Если значение true, функция публикации метки суперсети включена. Если значение false, функция публикации метки суперсети отключена. |
| supernet_uni_adv |
| Если значение true, функция публикации маршрутов суперсети одноадресного типа включена. Если значение false, функция публикации маршрутов суперсети одноадресного типа отключена. |
| vrf_name обязательно | Имя экземпляра BGP. Имя — регистрозависимая строка символов. Экземпляр BGP можно использовать только после создания соответствующего экземпляра VPN. Значение — строка длиной от 1 до 31 регистрозависимого символа. | |
| vrf_rid_auto_sel |
| Если значение true, экземпляры VPN BGP включены для автоматического выбора идентификаторов маршрутизаторов. Если значение false, экземпляры VPN BGP отключены от автоматического выбора идентификаторов маршрутизаторов. |
Примеры
- 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"
ce_bgp_af:
state: present
vrf_name: js
af_type: ipv4uni
provider: "{{ cli }}"
- name: "Undo BGP Address_Family"
ce_bgp_af:
state: absent
vrf_name: js
af_type: ipv4uni
provider: "{{ cli }}"
- name: "Config import route"
ce_bgp_af:
state: present
vrf_name: js
af_type: ipv4uni
import_protocol: ospf
import_process_id: 123
provider: "{{ cli }}"
- name: "Undo import route"
ce_bgp_af:
state: absent
vrf_name: js
af_type: ipv4uni
import_protocol: ospf
import_process_id: 123
provider: "{{ cli }}"
- name: "Config network route"
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"
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 dict | всегда | параметры aaa в формате ключ/значение после выполнения модуля Пример: {'vrf_name': 'js', 'af_type': 'ipv4uni'} |
| existing dict | всегда | параметры существующего сервера aaa в формате ключ/значение |
| proposed dict | всегда | параметры, переданные в модуль, в формате ключ/значение Пример: {'state': 'present', 'vrf_name': 'js', 'af_type': 'ipv4uni'} |
| updates список | всегда | команда, отправленная на устройство Пример: ['ipv4-family vpn-instance js'] |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Автор
- wangdezhuang (@CloudEngine-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.5/modules/ce_bgp_af_module.html