ios_bgp – Настройка глобальных параметров протокола BGP на Cisco IOS

Новая в версии 2.8.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Этот модуль обеспечивает управление настройкой глобальных параметров BGP на устройствах, работающих под управлением Cisco IOS

Параметры

Параметр				Варианты/Значения по умолчанию	Комментарии
config -					Указывает конфигурацию, связанную с BGP.
	address_family -				Указывает конфигурации, связанные с семейством адресов BGP.
		afi - / обязательно		Варианты: ipv4 ipv6	Тип семейства адресов для конфигурации.
		auto_summary boolean		Варианты: no yes	Включить/выключить автоматическое обобщение сетевых номеров.
		neighbors -			Указывает конфигурации, связанные с соседями BGP, в режиме конфигурации семейства адресов.
			activate boolean	Варианты: no yes	Включить семейство адресов для этого соседа.
			advertisement_interval integer		Минимальный интервал между отправкой обновлений маршрутизации BGP для этого соседа.
			maximum_prefix integer		Максимальное количество префиксов для приема от этого узла. Диапазон от 1 до 2147483647.
			neighbor - / обязательно		Адрес маршрутизатора-соседа.
			next_hop_self boolean	Варианты: no yes	Включить/выключить вычисление следующего перехода для этого соседа.
			next_hop_unchanged boolean	Варианты: no yes	Передать следующий переход без изменений для путей iBGP к этому соседу.
			remove_private_as boolean	Варианты: no yes	Удалить частный номер AS из исходящих обновлений.
			route_reflector_client boolean	Варианты: no yes	Указать соседа как клиента маршрутизатора-отражателя.
			route_server_client boolean	Варианты: no yes	Указать соседа как клиента сервера маршрутов.
		networks -			Указать сети для объявления через BGP. Для замены, этот параметр взаимоисключает опцию сетей на уровне корня.
			masklen -		Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.).
			prefix - / обязательно		Идентификатор сети для объявления через BGP.
			route_map -		Карта маршрутов для изменения атрибутов.
		redistribute -			Указывает информацию о перераспределении из другого протокола маршрутизации.
			id -		Идентификатор протокола маршрутизации для настройки информации о перераспределении. Допустимо для протоколов 'ospf', 'ospfv3' и 'eigrp'.
			metric -		Указывает метрику для перераспределенных маршрутов.
			protocol - / обязательно	Варианты: ospf ospfv3 eigrp isis static connected odr lisp mobile rip	Указывает протокол для настройки информации о перераспределении.
			route_map -		Указывает ссылку на карту маршрутов.
		safi -		Варианты: flowspec unicast ← multicast labeled-unicast	Указывает тип широковещания для семейства адресов.
		synchronization boolean		Варианты: no yes	Включить/выключить синхронизацию IGP.
	bgp_as integer / обязательно				Указывает номер автономной системы BGP (AS), который необходимо настроить на устройстве.
	log_neighbor_changes boolean			Варианты: no yes	Включить/выключить протоколирование изменения состояния соседей и причины сброса.
	neighbors -				Указывает конфигурации, связанные с соседями BGP.
		description -			Описание, специфичное для соседа.
		ebgp_multihop integer			Указывает максимальное число переходов для соседей EBGP, которые не находятся в сетях, подключенных напрямую. Диапазон от 1 до 255.
		enabled boolean		Варианты: no yes	Административно выключить или включить соседа.
		local_as integer			Местный номер AS для соседа.
		neighbor - / обязательно			Адрес маршрутизатора-соседа.

		пароль -			Пароль для аутентификации подключения BGP-пира.
		группа_пиров -			Имя группы пиров, членом которой является сосед.
		удаленный_as целое_число / требуется			Удалённый AS BGP-соседа для настройки.
		таймеры -			Указывает настройки таймеров BGP-соседа.
			время_удержания целое_число / требуется		Интервал (в секундах) после того, как не было получено сообщение keepalive, IOS объявляет пира неактуальным. Диапазон от 0 до 65535.
			keepalive целое_число / требуется		Частота (в секундах), с которой устройство отправляет сообщения keepalive своему пиру. Диапазон от 0 до 65535.
			min_время_удержания_соседа целое_число		Интервал (в секундах), указывающий минимально допустимое время удержания от BGP-соседа. Минимально допустимое время удержания должно быть меньше или равно интервалу, указанному в аргументе holdtime. Диапазон от 0 до 65535.
		источник_обновления -			Источник маршрутных обновлений.
	сети -				Укажите сети для объявления через BGP. Для операции replace этот параметр исключает возможность использования параметра networks в address_family. Для операции replace, если на устройстве уже активирована семейство адресов, этот параметр запрещён.
		длина_маски -			Длина подсети маски для объявления сети (например, 8, 16, 24 и т. д.).
		префикс - / требуется			Идентификатор сети для объявления через BGP.
		карта_маршрутов -			Карта маршрутов для изменения атрибутов.
	id_маршрутизатора -			По умолчанию: null	Настраивает значение id маршрутизатора процесса маршрутизации BGP.
операция -				Варианты: слияние ← замена переопределение удаление	Указывает операцию, которую нужно выполнить с конфигурируемым на устройстве процессом BGP. В случае слияния входная конфигурация будет слита с существующей конфигурацией BGP на устройстве. В случае замены, если есть разница между существующей конфигурацией и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого параметра, который имеет разницу. В случае переопределения вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией. В случае удаления существующая конфигурация BGP будет удалена с устройства.

Примечания

Примечание

Тестировалось с Cisco IOS Версия 15.6(3)M2

Примеры

- name: configure global bgp as 64496
  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
  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
  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
  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
  ios_bgp:
    config:
      bgp_as: 64496
    operation: delete

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Возвращается	Описание
команды список	всегда	Список команд конфигурации режима, которые нужно отправить устройству Пример: ['маршрутизатор bgp 64496', 'bgp id_маршрутизатора 192.0.2.1', 'bgp логировать_изменения_соседа', 'сосед 203.0.113.5 удаленный_as 64511', 'сосед 203.0.113.5 таймеры 300 360 360', 'сосед 198.51.100.2 удаленный_as 64498', 'сеть 198.51.100.0 карта_маршрутов RMAP_1', 'сеть 192.0.2.0 маска 255.255.254.0', 'семейство_адресов ipv4', 'перераспределять ospf 223 метрика 70', 'выход_из_семейства_адресов']

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается командой Ansible Network Team. [сеть]

Поддержка Red Hat

Дополнительную информацию о поддержке данного модуля Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

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.9/modules/ios_bgp_module.html