cisco.ios.ios_bgp – Настройка глобальных параметров протокола BGP на Cisco IOS.
Примечание
Этот плагин входит в коллекцию cisco.ios (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install cisco.ios
Для использования в playbook, укажите: cisco.ios.ios_bgp
Новое в версии 1.0.0: коллекции cisco.ios
Обзор
- Этот модуль обеспечивает управление конфигурацией глобальных параметров BGP на устройствах, работающих под управлением Cisco IOS.
Примечание
Для этого модуля есть соответствующий плагин действий.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |||
|---|---|---|---|---|---|
| config словарь | Указывает конфигурацию, связанную с BGP. | ||||
| address_family список / элементы=словарь | Указывает конфигурацию, связанную с семейством адресов BGP. | ||||
| afi строка / обязательно |
| Тип семейства адресов для настройки. | |||
| auto_summary булево |
| Включить/отключить автоматическое обобщение сетевых номеров. | |||
| neighbors список / элементы=словарь | Указывает конфигурацию, связанную с соседями BGP в режиме конфигурации семейства адресов. | ||||
| activate булево |
| Включить семейство адресов для этого соседа. | |||
| advertisement_interval целое число | Минимальный интервал между отправкой обновлений маршрутизации BGP для этого соседа. | ||||
| maximum_prefix целое число | Максимальное количество префиксов для приема от этого узла. Диапазон от 1 до 2147483647. | ||||
| neighbor строка / обязательно | Адрес маршрутизатора соседа. | ||||
| next_hop_self булево |
| Включить/отключить вычисление следующего узла для этого соседа. | |||
| next_hop_unchanged булево |
| Передавать следующий узел без изменений для iBGP путей к этому соседу. | |||
| prefix_list_in строка | Имя списка префиксов ip для применения к входящим префиксам. | ||||
| prefix_list_out строка | Имя списка префиксов ip для применения к исходящим префиксам. | ||||
| remove_private_as булево |
| Удалить частный номер AS из исходящих обновлений. | |||
| route_reflector_client булево |
| Указать соседа как клиента рефлектора маршрутов. | |||
| route_server_client булево |
| Указать соседа как клиента сервера маршрутов. | |||
| networks список / элементы=словарь | Указать сети для объявления через BGP. Для операции замены этот параметр является взаимоисключающим с параметром сетей на уровне корня. | ||||
| masklen целое число | Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.). | ||||
| prefix строка / обязательно | Идентификатор сети для объявления через BGP. | ||||
| route_map строка | Карта маршрутов для изменения атрибутов. | ||||
| redistribute список / элементы=словарь | Указывает информацию о перераспределении из другого протокола маршрутизации. | ||||
| id строка | Идентификатор протокола маршрутизации для настройки информации о перераспределении. Действительно для протоколов 'ospf', 'ospfv3' и 'eigrp'. | ||||
| metric целое число | Указывает метрику для перераспределенных маршрутов. | ||||
| protocol строка / обязательно |
| Указывает протокол для настройки информации о перераспределении. | |||
| route_map строка | Указывает ссылку на карту маршрутов. | ||||
| safi строка |
| Указывает тип адресации для семейства адресов. | |||
| synchronization булево |
| Включить/отключить синхронизацию IGP. | |||
| bgp_as целое число / обязательно | Указывает номер автономной системы BGP (AS) для настройки на устройстве. | ||||
| log_neighbor_changes булево |
| Включить/отключить протоколирование установления/отключения соседей и причины сброса. | |||
| neighbors список / элементы=словарь | Указывает конфигурацию, связанную с соседями BGP. | ||||
| description строка | Описание, специфичное для соседа. | ||||
| ebgp_multihop целое число | Указывает максимальное число переходов для соседей EBGP, не находящихся на непосредственно подключенных сетях. Диапазон от 1 до 255. | ||||
| enabled булево |
| Административно выключить или включить соседа. | |||
| local_as целое число | Местный номер AS для соседа. | ||||
| neighbor строка / обязательно | Адрес маршрутизатора соседа. | ||||
| password строка | Пароль для аутентификации соединения BGP. | ||||
| peer_group строка | Имя группы узлов, членом которой является сосед. | ||||
| remote_as целое число / обязательно | Удаленный AS соседа BGP для настройки. | ||||
| timers словарь | Указывает конфигурацию таймеров, связанных с соседями BGP. | ||||
| holdtime целое число / обязательно | Интервал (в секундах) после того, как не получено сообщение keepalive, что IOS объявляет соседа неактивным. Диапазон от 0 до 65535. | ||||
| keepalive целое число / обязательно | Частота (в секундах), с которой устройство отправляет сообщения keepalive своему партнеру. Диапазон значений от 0 до 65535. | ||||
| min_neighbor_holdtime целое число | Интервал (в секундах), определяющий минимально допустимое время удержания от соседа по BGP. Минимально допустимое время удержания должно быть меньше или равно интервалу, указанному в аргументе holdtime. Диапазон значений от 0 до 65535. | ||||
| update_source строка | Источник маршрутных обновлений. | ||||
| networks список / элементы=словарь | Укажите сети для объявления через BGP. Для операции замены этот параметр взаимоисключающий с параметром networks в блоке address_family. Для операции замены, если на устройстве уже активирована семейство адресов, этот параметр недопустим. | ||||
| masklen целое число | Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.). | ||||
| prefix строка / обязательно | Идентификатор сети для объявления через BGP. | ||||
| route_map строка | Карта маршрутов для изменения атрибутов. | ||||
| router_id строка | Настраивает значение router-id процесса маршрутизации BGP. | ||||
| operation строка |
| Определяет операцию, которая должна быть выполнена над процессом BGP, настроенным на устройстве. В случае merge, входная конфигурация будет объединена с существующей конфигурацией BGP на устройстве. В случае replace, если есть разница между существующей и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого параметра, у которого есть эта разница. В случае override, вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией. В случае delete существующая конфигурация BGP будет удалена с устройства. | |||
Примечания
Примечание
- Проверено на Cisco IOS версии 15.6(3)M2
Примеры
- name: configure global bgp as 64496
cisco.ios.ios_bgp:
config:
bgp_as: 64496
router_id: 192.0.2.1
log_neighbor_changes: true
neighbors:
- neighbor: 203.0.113.5
remote_as: 64511
timers:
keepalive: 300
holdtime: 360
min_neighbor_holdtime: 360
- neighbor: 198.51.100.2
remote_as: 64498
networks:
- prefix: 198.51.100.0
route_map: RMAP_1
- prefix: 192.0.2.0
masklen: 23
address_family:
- afi: ipv4
safi: unicast
redistribute:
- protocol: ospf
id: 223
metric: 10
operation: merge
- name: Configure BGP neighbors
cisco.ios.ios_bgp:
config:
bgp_as: 64496
neighbors:
- neighbor: 192.0.2.10
remote_as: 64496
password: ansible
description: IBGP_NBR_1
ebgp_multihop: 100
timers:
keepalive: 300
holdtime: 360
min_neighbor_holdtime: 360
- neighbor: 192.0.2.15
remote_as: 64496
description: IBGP_NBR_2
ebgp_multihop: 150
operation: merge
- name: Configure root-level networks for BGP
cisco.ios.ios_bgp:
config:
bgp_as: 64496
networks:
- prefix: 203.0.113.0
masklen: 27
route_map: RMAP_1
- prefix: 203.0.113.32
masklen: 27
route_map: RMAP_2
operation: merge
- name: Configure BGP neighbors under address family mode
cisco.ios.ios_bgp:
config:
bgp_as: 64496
address_family:
- afi: ipv4
safi: unicast
neighbors:
- neighbor: 203.0.113.10
activate: yes
maximum_prefix: 250
advertisement_interval: 120
- neighbor: 192.0.2.15
activate: yes
route_reflector_client: true
operation: merge
- name: remove bgp as 64496 from config
cisco.ios.ios_bgp:
config:
bgp_as: 64496
operation: delete
Значения возврата
Общие значения возврата описаны здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список / элементы=строка | всегда | Список команд конфигурации режима, которые необходимо отправить на устройство Пример: ['router bgp 64496', 'bgp router-id 192.0.2.1', 'bgp log-neighbor-changes', 'neighbor 203.0.113.5 remote-as 64511', 'neighbor 203.0.113.5 timers 300 360 360', 'neighbor 198.51.100.2 remote-as 64498', 'network 198.51.100.0 route-map RMAP_1', 'network 192.0.2.0 mask 255.255.254.0', 'address-family ipv4', 'redistribute ospf 223 metric 70', 'exit-address-family'] |
Авторы
- 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/ios/ios_bgp_module.html