cisco.iosxr.iosxr_bgp – Настройка глобальных параметров протокола BGP на Cisco IOS-XR
Примечание
Этот плагин входит в коллекцию cisco.iosxr (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install cisco.iosxr.
Для использования в playbook, укажите: cisco.iosxr.iosxr_bgp.
Новое в версии 1.0.0: of cisco.iosxr
Обзор
- Этот модуль предоставляет управление конфигурацией глобальных параметров BGP на устройствах с Cisco IOS-XR.
Примечание
У этого модуля есть соответствующий плагин действий.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |||
|---|---|---|---|---|---|
| config словарь | Указывает конфигурацию, связанную с BGP. | ||||
| address_family список / элементы=словарь | Указывает конфигурации, связанные с семейством адресов BGP. | ||||
| afi строка / обязательно |
| Тип семейства адресов для настройки. | |||
| networks список / элементы=словарь | Указывает сети, которые нужно объявить через BGP. Для операции замены этот параметр исключает параметр сети на уровне корня. | ||||
| masklen целое число / обязательно | Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.). | ||||
| network строка / обязательно | Идентификатор сети для объявления через BGP. Псевдонимы: префикс | ||||
| route_map строка | Карта маршрутов для изменения атрибутов. | ||||
| redistribute список / элементы=словарь | Указывает информацию о перераспределении из другого протокола маршрутизации. | ||||
| id строка | Идентификатор протокола маршрутизации для настройки информации о перераспределении. Допустимо для протоколов 'ospf', 'eigrp', 'isis' и 'ospfv3'. | ||||
| metric целое число | Указывает метрику для перераспределенных маршрутов. | ||||
| protocol строка / обязательно |
| Указывает протокол для настройки информации о перераспределении. | |||
| route_map строка | Указывает ссылку на карту маршрутов. | ||||
| safi строка |
| Указывает тип адресации для семейства адресов. | |||
| bgp_as целое число / обязательно | Указывает номер автономной системы BGP (AS) для настройки на устройстве. | ||||
| log_neighbor_changes булево |
| Включение/выключение регистрации изменений/отключения соседей и причины сброса. | |||
| neighbors список / элементы=словарь | Указывает конфигурации, связанные с соседями BGP. | ||||
| advertisement_interval целое число | Указывает минимальный интервал (в секундах) между отправкой обновлений маршрутизации BGP. Диапазон от 0 до 600. | ||||
| description строка | Описание, специфичное для соседа. | ||||
| ebgp_multihop целое число | Указывает максимальное количество переходов для соседей EBGP, которые не находятся в сети прямого соединения. Диапазон от 0 до 255. | ||||
| enabled булево |
| Административное отключение или включение соседа. | |||
| neighbor строка / обязательно | Адрес маршрутизатора соседа. | ||||
| password строка | Пароль для аутентификации подключения BGP-пиров. | ||||
| remote_as целое число / обязательно | Удаленная AS соседа BGP для настройки. | ||||
| tcp_mss целое число | Указывает начальный размер максимального сегмента TCP для использования. Диапазон от 68 до 10000. | ||||
| timers словарь | Указывает конфигурации, связанные с таймерами соседа BGP. | ||||
| holdtime целое число | Интервал после того, как не было получено сообщения keepalive, что программное обеспечение объявляет пир мертвым. Диапазон от 3 до 65535. | ||||
| keepalive целое число | Частота, с которой программное обеспечение Cisco IOS-XR отправляет сообщения keepalive своему пиру. Диапазон от 0 до 65535. | ||||
| min_neighbor_holdtime целое число | Интервал, определяющий минимально допустимое время удержания от соседа BGP. Минимально допустимое время удержания должно быть меньше или равно интервалу, указанному в аргументе holdtime. Диапазон от 3 до 65535. | ||||
| update_source строка | Источник обновлений маршрутизации. | ||||
| router_id строка | Настройка значения router-id процесса маршрутизации BGP. | ||||
| operation строка |
| Указывает операцию, которая должна быть выполнена над процессом BGP, настроенным на устройстве. В случае слияния входная конфигурация будет объединена с существующей конфигурацией BGP на устройстве. В случае замены, если есть разница между существующей конфигурацией и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого параметра, который имеет разницу. В случае переопределения вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией. В случае удаления существующая конфигурация BGP будет удалена с устройства. | |||
Примечания
Примечание
- Проверено на программном обеспечении Cisco IOS XR версии 6.1.3
- Этот модуль работает с соединениями
network_cli. См. варианты платформы IOS-XR.
Примеры
- name: configure global bgp as 65000
cisco.iosxr.iosxr_bgp:
bgp_as: 65000
router_id: 1.1.1.1
neighbors:
- neighbor: 182.168.10.1
remote_as: 500
description: PEER_1
- neighbor: 192.168.20.1
remote_as: 500
update_source: GigabitEthernet 0/0/0/0
address_family:
- name: ipv4
cast: unicast
networks:
- network: 192.168.2.0/23
- network: 10.0.0.0/8
redistribute:
- protocol: ospf
id: 400
metric: 110
- name: remove bgp as 65000 from config
ios_bgp:
bgp_as: 65000
state: absent
Значения возврата
Общие значения возвращаемых данных документированы здесь, следующие — это поля, уникальные для данного модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| commands список / элементы=строка | всегда | Список команд режима конфигурации для отправки устройству Пример: ['router bgp 65000', 'bgp router-id 1.1.1.1', 'neighbor 182.168.10.1 remote-as 500', 'neighbor 182.168.10.1 description PEER_1', 'neighbor 192.168.20.1 remote-as 500', 'neighbor 192.168.20.1 update-source GigabitEthernet0/0/0/0', 'address-family ipv4 unicast', 'redistribute ospf 400 metric 110', 'network 192.168.2.0/23', 'network 10.0.0.0/8', 'exit'] |
Авторы
- Nilashish Chakraborty (@NilashishC)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/iosxr/iosxr_bgp_module.html
