cisco.iosxr.iosxr_bgp_address_family модуль – Модуль ресурсов для настройки семейства адресов BGP.

Примечание

Этот модуль входит в состав коллекции cisco.iosxr (версия 9.0.0).

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

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

Для использования в книге задач укажите: cisco.iosxr.iosxr_bgp_address_family.

Новое в cisco.iosxr 2.0.0

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

Обзор

Этот модуль настраивает и управляет атрибутами семейства адресов BGP на платформах Cisco IOS-XR.

Псевдонимы: bgp_address_family

Параметры

Параметр	Комментарии
config dictionary	Список конфигураций для семейства адресов BGP.
address_family list / elements=dictionary	Включить семейство адресов и войти в его режим конфигурации
additional_paths string	Команды BGP additional-paths Варианты: `"send"` `"receive"`
advertise_best_external boolean	Объявить лучший внешний путь. Варианты: `false` `true`
afi string	Семейство адресов. Варианты: `"ipv4"` `"ipv6"` `"l2vpn"` `"link-state"` `"vpnv4"` `"vpnv6"`
aggregate_address list / elements=dictionary	Настроить записи агрегации BGP.
as_confed_set boolean	Создать информацию о пути набора AS confed. Варианты: `false` `true`
as_set boolean	Создать информацию о пути набора AS. Варианты: `false` `true`
route_policy string	Политика для управления объявлением, подавлением и атрибутами.
summary_only boolean	Фильтровать более конкретные маршруты из обновлений. Варианты: `false` `true`
value string	Агрегированный адрес IPv4 и маска или длина маски.
allocate_label dictionary	Выделять метки.
all boolean	Выделять метки для всех префиксов. Варианты: `false` `true`
route_policy string	Использовать политику маршрутизации для выбора префиксов для выделения меток.
allow_vpn_default_originate boolean	Разрешить отправку маршрута по умолчанию соседу VPN. Варианты: `false` `true`
as_path_loopcheck_out_disable boolean	Настроить проверку циклов пути AS для исходящих обновлений. Варианты: `false` `true`
bgp dictionary	Команды BGP.
attribute_download boolean	Настроить загрузку атрибутов для этого семейства адресов. Варианты: `false` `true`
bestpath dictionary	Изменить критерии выбора маршрута по умолчанию.
origin_as dictionary	Параметры BGP origin-AS.
allow dictionary	Параметры BGP origin-AS.

invalid boolean	Выбор лучшего пути BGP разрешит недействительный origin-AS Варианты: `false` `true`
use dictionary	Параметры origin-AS BGP.
validity boolean	Выбор лучшего пути BGP будет использовать действительность origin-AS Варианты: `false` `true`
client_to_client dictionary	Настроить отражение маршрута клиент-клиент.
reflection dictionary	отключить отражение client to client идентификатора кластера.
cluster_id_disable dictionary	Идентификатор кластера, для которого необходимо отключить отражение.
cluster_id string	Идентификатор кластера, для которого необходимо отключить отражение.
disable boolean	отключить идентификатор кластера. Варианты: `false` `true`
disable boolean	отключить отражение. Варианты: `false` `true`
dampening dictionary	Включить подавление колебаний маршрутов
route_policy string	Политика маршрутизации для указания критериев подавления.
set boolean	Включить подавление. Варианты: `false` `true`
value integer	Время полураспада для штрафа
import_delay dictionary	Указать задержку для пакетной обработки импорта.
delay_ms_parts integer	часть в миллисекундах <0-999>.
delay_second_parts integer	Задержка, часть в секундах <0-10>.
label_delay dictionary	Указать задержку для пакетной обработки меток
delay_ms_parts integer	часть в миллисекундах <0-999>.
delay_second_parts integer	Задержка, часть в секундах <0-10>.
origin_as dictionary	Параметры origin-AS BGP.
validation dictionary	Параметры проверки origin-AS BGP.
disable boolean	Отключить проверку origin-AS RPKI. Варианты: `false` `true`
signal dictionary	Сигнализировать о действительности origin-AS пирам.

ibgp boolean	Сигнализировать о корректности origin-AS для iBGP-пиров Choices: `false` `true`
scan_time integer	Настроить интервал сканирования в фоновом режиме для этого семейства адресов. Пример - <5-3600>.
default_martian_check_disable boolean	Проверка на "марсианские" адреса по умолчанию Choices: `false` `true`
distance dictionary	Определить административное расстояние.
local_routes integer	Расстояние для локальных маршрутов <1-255>.
routes_external_to_as integer	Расстояние для маршрутов, внешних для AS <1-255>.
routes_internal_to_as integer	Расстояние для маршрутов, внутренних для AS <1-255>.
dynamic_med integer	Интервал динамического MED.
global_table_multicast boolean	Включить глобальную многоадресную рассылку таблицы. Choices: `false` `true`
inter_as_install boolean	Установить удаленные mvpn маршруты в vrf по умолчанию. Это применимо для mvpn afi. Choices: `false` `true`
label_mode dictionary	Конфигурация меток.
per_ce boolean	Установить режим меток per CE Choices: `false` `true`
per_prefix boolean	Установить режим меток per perfix. Choices: `false` `true`
per_vrf boolean	Установить режим меток per VRF. Choices: `false` `true`
route_policy string	Использовать политику маршрутизации для выбора префиксов для режима распределения меток.
maximum_paths dictionary	Переадресовывать пакеты по нескольким путям.
ebgp dictionary	ebgp-multipath.
max_path_value integer	<2-64> Количество путей (лимит включает резервный путь).
order_igp_metric boolean	Упорядочить кандидаты многопутевого маршрута для выбора в соответствии с заданным числом (cisco-support). Choices: `false` `true`
selective_order_igp_metric boolean	Разрешить многопутевые маршруты только от помеченных соседей Choices: `false` `true`
eibgp dictionary	eiBGP-multipath.
max_path_value integer	<2-64> Количество путей (лимит включает резервный путь).

order_igp_metric boolean	Упорядочивать кандидаты по множественным путям для выбора в соответствии с настроенным количеством (cisco-support). Варианты: `false` `true`
selective_order_igp_metric boolean	Разрешить множественные пути только от помеченных соседей. Варианты: `false` `true`
ibgp dictionary	iBGP-множественные пути.
max_path_value integer	<2-64> Количество путей (предел включает резервный путь).
order_igp_metric boolean	Упорядочивать кандидаты по множественным путям для выбора в соответствии с настроенным количеством (cisco-support). Варианты: `false` `true`
selective_order_igp_metric boolean	Разрешить множественные пути только от помеченных соседей. Варианты: `false` `true`
unequal_cost dictionary	Разрешить множественные пути с разными метриками IGP следующего узла BGP.
order_igp_metric boolean	Упорядочивать кандидатов по множественным путям для выбора в соответствии с настроенным количеством (cisco-support). Варианты: `false` `true`
selective_order_igp_metric boolean	Разрешить множественные пути только от помеченных соседей. Варианты: `false` `true`
set boolean	Установить unequal_cost. Варианты: `false` `true`
mvpn_single_forwarder_selection_all boolean	Включить выбор одного маршрутизатора для всех. Варианты: `false` `true`
mvpn_single_forwarder_selection_highest_ip_address boolean	Включить выбор одного маршрутизатора для PE с наивысшим IP-адресом. Варианты: `false` `true`
networks list / elements=dictionary	Укажите сеть для объявления через BGP.
backdoor_route_policy string	Укажите политику маршрута BGP задней двери.
network string	Укажите сеть для объявления через BGP.
route_policy string	Политика маршрутизации для изменения атрибутов.
nexthop dictionary	Следующий узел.
resolution_prefix_length_minimum integer	Установите минимальную длину префикса для разрешения следующего узла. Варианты: `0` `32`
route_policy string	Политика для фильтрации уведомлений о следующем узле.
trigger_delay_critical integer	Для критических уведомлений.
trigger_delay_non_critical integer	Для некритических уведомлений.

END_OF_DOCUMENT_MARKER

optimal_route_reflection dictionary	Настройка группы optimal-route-reflection.
group_name string	Имя группы ORR - максимум 32 символа.
primary_address string	Основной IPv4-адрес.
secondary_address string	Вторичный IPv4-адрес
permanent_network_route_policy string	Имя политики.
redistribute list / elements=dictionary	Перераспределение информации от другого протокола маршрутизации.
external boolean	Перераспределение внешних маршрутов EIGRP. Применимо для eigrp. Варианты: `false` `true`
external_ospf integer	Перераспределение внешних маршрутов OSPF. Применимо для ospf. Варианты: `1` `2`
id string	Идентификатор протокола маршрутизации для настройки информации о перераспределении. Пример - имя приложения, имя экземпляра eigrp/is-is, тег ospf Действительно для протоколов ‘ospf’, ‘eigrp’, ‘isis’ и ‘application’.
internal boolean	Перераспределение внутренних маршрутов EIGRP. Применимо для eigrp. Варианты: `false` `true`
level string	Перераспределение маршрутов с указанных уровней ISIS. Перераспределение маршрутов ISIS уровня 1 Перераспределение межзонных маршрутов ISIS уровня 1 Перераспределение маршрутов ISIS уровня 2 Варианты: `"1"` `"2"` `"1-inter-area"`
metric integer	Указывает метрику для перераспределяемых маршрутов.
nssa_external boolean	Перераспределение внешних маршрутов OSPF NSSA. Применимо для ospf. Варианты: `false` `true`
protocol string / required	Указывает протокол для настройки информации о перераспределении. Варианты: `"ospf"` `"application"` `"eigrp"` `"isis"` `"static"` `"connected"` `"lisp"` `"mobile"` `"rip"` `"subscriber"`
route_policy string	Указывает ссылку на политику маршрутизации.
retain_local_label integer	Время хранения метки в минутах <3-60>.
route_target_download boolean	Установка RIB цели маршрута. Варианты: `false` `true`
safi string	Модификатор семейства адресов Варианты: `"flowspec"` `"mdt"` `"multicast"` `"mvpn"` `"rt-filter"` `"tunnel"` `"unicast"` `"evpn"` `"mspw"` `"vpls-vpws"` `"link-state"`
segmented_multicast boolean	Включить сегментированную многоадресную рассылку. Это применимо для mvpn afi. Варианты: `false` `true`
table_policy string	Настройка политики для установки маршрутов в RIB.

update dictionary	Конфигурация генерации обновления BGP.
limit dictionary	Лимит обновлений.
address_family integer	Лимит обновлений для подгрупп.
sub_group dictionary	Лимит обновлений для семейства адресов.
ebgp integer	Лимит обновлений для подгрупп eBGP<1-512.
ibgp integer	Лимит обновлений для подгрупп iBGP<1-512.
wait_install boolean	Ожидать установку маршрута. Варианты: `false` `true`
vrf string	Имя VRF.
vrf_all_conf dictionary	Конфигурация для всех VRF и применима для afi vpn6 и модификатора unicast.
label_mode dictionary	Конфигурация, связанная с метками.
per_ce boolean	Установить режим метки на каждый CE Варианты: `false` `true`
per_vrf boolean	Установить режим метки на каждый VRF. Варианты: `false` `true`
route_policy string	Использовать политику маршрутизации для выбора префиксов для режима выделения меток.
source_rt_import_policy boolean	Импорт целевых маршрутов источника из политики импорта. Варианты: `false` `true`
table_policy string	Настроить политику для установки маршрутов в RIB.
weight dictionary	Определить или изменить вес.
reset_on_import boolean	Установить reset_on_import. Варианты: `false` `true`
reset_on_import_disable boolean	Отключить reset_on_import. Варианты: `false` `true`
as_number string	Номер автономной системы.
running_config string	Этот параметр используется только с состоянием parsed. Значение этого параметра должно быть выводом, полученным от устройства Iosxr путем выполнения команды show running-config router bgp. Состояние parsed считывает конфигурацию из параметра `running_config` и преобразует её в структурированные данные Ansible в соответствии с argspec модуля ресурса, а затем возвращаемое значение находится в ключе parsed в результате.
state string	Состояние, в котором должна остаться конфигурация. Варианты: `"deleted"` `"merged"` ← (по умолчанию) `"overridden"` `"replaced"` `"gathered"` `"rendered"` `"parsed"`

Примечания

Примечание

Этот модуль работает с соединением network_cli.

Примеры

# Using merged
# Before state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.2.1
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
- name: Merge the provided configuration with the existing running configuration
  cisco.iosxr.iosxr_bgp_address_family:
    state: merged
    config:
      as_number: '65536'
      address_family:
        - afi: ipv4
          safi: unicast
          vrf: vrf1
          dynamic_med: 9
          redistribute:
            - protocol: connected
              metric: 10
        - afi: ipv4
          safi: unicast
          dynamic_med: 10
          redistribute:
            - protocol: application
              id: test1
              metric: 10
          bgp:
            scan_time: 20
            attribute_download: true
          advertise_best_external: true
          allocate_label:
            all: true
# Task output
# -------------
# commands:
# - router bgp 65536
# - address-family ipv4 unicast
# - advertise best-external
# - allocate-label all
# - bgp attribute-download
# - bgp scan-time 20
# - dynamic-med interval 10
# - redistribute application test1 metric 10
# - vrf vrf1
# - address-family ipv4 unicast
# - dynamic-med interval 9
# - redistribute connected metric 10
#
#
# after:
#   as_number: "65536"
#   address_family:
#     - afi: "ipv4"
#       safi: "unicast"
#       vrf: vrf1
#       dynamic_med: 9
#       redistribute:
#         - protocol: connected
#           metric: 10
#     - afi: "ipv4"
#       safi: "unicast"
#       dynamic_med: 10
#       redistribute:
#         - protocol: application
#           id: "test1"
#           metric: 10
#       bgp:
#         scan_time: 20
#         attribute_download: true
#       advertise_best_external: true
#       allocate_label:
#         all: true
#
# After state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#    advertise best-external
#    allocate-label all
#    bgp attribute-download
#    bgp scan-time 20
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#   address-family ipv4 unicast
#     dynamic-med interval 9
#     redistribute connected metric 10
#
# Using replaced
# Before state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#    advertise best-external
#    allocate-label all
#    bgp attribute-download
#    bgp scan-time 20
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#   address-family ipv4 unicast
#     dynamic-med interval 9
#     redistribute connected metric 10
#
#
- name: Replace the provided configuration with the existing running configuration
  cisco.iosxr.iosxr_bgp_address_family:
    state: replaced
    config:
      as_number: '65536'
      address_family:
        - afi: ipv4
          safi: unicast
          vrf: vrf1
          dynamic_med: 10
# Task output
# -------------
# commands:
# - router bgp 65536
# - vrf vrf1
# - address-family ipv4 unicast
# - dynamic-med interval 10
# - no redistribute connected metric 10
#
# after:
#   as_number: "65536"
#   address_family:
#     - afi: "ipv4"
#       safi: "unicast"
#       vrf: vrf1
#       dynamic_med: 10
#     - afi: "ipv4"
#       safi: "unicast"
#       dynamic_med: 10
#       redistribute:
#         - protocol: application
#           id: "test1"
#           metric: 10
#       bgp:
#         scan_time: 20
#         attribute_download: true
#       advertise_best_external: true
#       allocate_label:
#         all: true
# After state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#    advertise best-external
#    allocate-label all
#    bgp attribute-download
#    bgp scan-time 20
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#   address-family ipv4 unicast
#     dynamic-med interval 10
#
#
# Using overridden
# Before state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#    advertise best-external
#    allocate-label all
#    bgp attribute-download
#    bgp scan-time 20
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#   address-family ipv4 unicast
#     dynamic-med interval 9
#     redistribute connected metric 10
#
#
- name: Override the provided configuration with the existing running configuration
  cisco.iosxr.iosxr_bgp_address_family:
    state: overridden
    config:
      as_number: '65536'
      address_family:
        - afi: ipv4
          safi: unicast
          vrf: vrf1
          dynamic_med: 10

# Task output
# -------------
# commands:
# - router bgp 65536
# - no address-family ipv4 unicast
# - vrf vrf1
# - address-family ipv4 unicast
# - dynamic-med interval 10
# - no redistribute connected metric 10
#
#
# after:
#   as_number: "65536"
#   address_family:
#     - afi: "ipv4"
#       safi: "unicast"
#       vrf: vrf1
#       dynamic_med: 10
#
# After state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#   address-family ipv4 unicast
#     dynamic-med interval 10
#
#
# Using deleted
# Before state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#    advertise best-external
#    allocate-label all
#    bgp attribute-download
#    bgp scan-time 20
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#   address-family ipv4 unicast
#     dynamic-med interval 9
#     redistribute connected metric 10
#
#
- name: Delete the provided configuration
  cisco.iosxr.iosxr_bgp_address_family:
    state: deleted
    config:

# Task output
# -------------
# commands:
# - router bgp 65536
# - no address-family ipv4 unicast
# - vrf vrf1
# - no address-family ipv4 unicast
#
#
# after:
#   as_number: "65536"
#
#
# After state:
# -------------
# RP/0/0/CPU0:iosxr-02#show running-config router bgp
# Sat Feb 20 03:49:43.618 UTC
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#
# Using rendered
# -------------
#
- name: rendered state example
  cisco.iosxr.iosxr_bgp_address_family:
    state: rendered
    config:
      as_number: '65536'
      address_family:
        - afi: ipv4
          safi: unicast
          vrf: vrf1
          dynamic_med: 9
          redistribute:
            - protocol: connected
              metric: 10
        - afi: ipv4
          safi: unicast
          dynamic_med: 10
          redistribute:
            - protocol: application
              id: test1
              metric: 10
          bgp:
            scan_time: 20
            attribute_download: true
          advertise_best_external: true
          allocate_label:
            all: true
# Task output
# -------------
# commands:
# - router bgp 65536
# - address-family ipv4 unicast
# - advertise best-external
# - allocate-label all
# - bgp attribute-download
# - bgp scan-time 20
# - dynamic-med interval 10
# - redistribute application test1 metric 10
# - vrf vrf1
# - address-family ipv4 unicast
# - dynamic-med interval 9
# - redistribute connected metric 10
#
# Using gathered
# -------------
- name: Gather existing running configuration
  cisco.iosxr.iosxr_bgp_address_family:
    state: gathered
    config:
      as_number: '65536'
      address_family:
        - afi: ipv4
          safi: unicast
          vrf: vrf1
          dynamic_med: 9
          redistribute:
            - protocol: connected
              metric: 10
        - afi: ipv4
          safi: unicast
          dynamic_med: 10
          redistribute:
            - protocol: application
              id: test1
              metric: 10
          bgp:
            scan_time: 20
            attribute_download: true
          advertise_best_external: true
          allocate_label:
            all: true
# gathered:
#   as_number: "65536"
#   address_family:
#     - afi: "ipv4"
#       safi: "unicast"
#       vrf: vrf1
#       dynamic_med: 9
#       redistribute:
#         - protocol: connected
#           metric: 10
#     - afi: "ipv4"
#       safi: "unicast"
#       dynamic_med: 10
#       redistribute:
#         - protocol: application
#           id: "test1"
#           metric: 10
#       bgp:
#         scan_time: 20
#         attribute_download: true
#       advertise_best_external: true
#       allocate_label:
#         all: true
#
# Using parsed
#
# parsed.cfg
# ------------
# router bgp 65536
#  bgp router-id 192.0.1.1
#  address-family ipv4 unicast
#    advertise best-external
#    allocate-label all
#    bgp attribute-download
#    bgp scan-time 20
#  address-family vpnv4 unicast
#  vrf vrf1
#   rd auto
#   address-family ipv4 unicast
#     dynamic-med interval 9
#     redistribute connected metric 10
#
- name: Parse externally provided BGP neighbor AF config
  cisco.iosxr.iosxr_bgp_address_family:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Task output (redacted)
# -----------------------
# parsed:
#   as_number: "65536"
#   address_family:
#     - afi: "ipv4"
#       safi: "unicast"
#       vrf: vrf1
#       dynamic_med: 9
#       redistribute:
#         - protocol: connected
#           metric: 10
#     - afi: "ipv4"
#       safi: "unicast"
#       dynamic_med: 10
#       redistribute:
#         - protocol: application
#           id: "test1"
#           metric: 10
#       bgp:
#         scan_time: 20
#         attribute_download: true
#       advertise_best_external: true
#       allocate_label:
#         all: true

Авторы

Ashwini Mhatre (@amhatre)

Ссылки на сборник

© 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/cisco/iosxr/iosxr_bgp_address_family_module.html