cisco.ios.ios_bgp – Настройка глобальных параметров протокола BGP на Cisco IOS.
Примечание
Этот плагин входит в коллекцию cisco.ios (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install cisco.ios.
Для использования в книге задач укажите: 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. Для операции замещения этот параметр взаимоисключающий с параметром root level networks. | ||||
| masklen целое число | Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.). | ||||
| prefix строка / обязательно | Идентификатор сети для объявления через BGP. | ||||
| route_map строка | Карта маршрутов для изменения атрибутов. | ||||
| redistribute список / элементы=словарь | Указывает информацию о перераспределении из другого протокола маршрутизации. | ||||
| id строка | Идентификатор протокола маршрутизации для настройки информации о перераспределении. Действительно для протоколов 'ospf', 'ospfv3' и 'eigrp'. | ||||
| metric целое число | Указывает метрику для перераспределенных маршрутов. | ||||
| protocol строка / обязательно |
| Указывает протокол для настройки информации о перераспределении. | |||
| route_map строка | Указывает ссылку на карту маршрутов. | ||||
| safi строка |
| Указывает тип рассылки для семейства адресов. | |||
| synchronization логическое значение |
| Включить/выключить синхронизацию IGP. | |||
| bgp_as целое число / обязательно | Указывает номер автономной системы (AS) BGP, которую нужно настроить на устройстве. | ||||
| 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 своему peer. Диапазон значений от 0 до 65535. | ||||
| min_neighbor_holdtime целое число | Интервал (в секундах), определяющий минимальное допустимое время удержания от соседа BGP. Минимальное допустимое время удержания должно быть меньше или равно интервалу, указанному в аргументе holdtime. Диапазон значений от 0 до 65535. | ||||
| update_source строка | Источник маршрутных обновлений. | ||||
| networks список / элементы=словарь | Укажите сети для объявления через BGP. Для операции replace этот параметр взаимоисключающий с параметром networks в address_family. Для операции replace, если на устройстве уже активирована адресная семья, этот параметр запрещён. | ||||
| 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/ios/ios_bgp_module.html
