frr_bgp – Настройка глобальных параметров BGP в Free Range Routing (FRR)

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

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

Обзор

Этот модуль обеспечивает управление конфигурацией глобальных параметров BGP на устройствах, работающих под управлением Free Range Routing (FRR).

Параметры

Параметр				Варианты/Значения по умолчанию	Комментарии
config -					Указывает конфигурацию, связанную с BGP.
	address_family -				Указывает конфигурации, связанные с семейством адресов BGP.
		afi - / обязательно		Варианты: ipv4 ipv6	Тип семейства адресов для настройки.
		neighbors -			Указывает конфигурации, связанные с соседями BGP в режиме конфигурации семейства адресов.
			activate boolean	Варианты: no yes	Включить семейство адресов для этого соседа.
			maximum_prefix целое число		Максимальное количество префиксов, принимаемых от этого узла. Диапазон от 1 до 4294967295.
			neighbor - / обязательно		Адрес маршрутизатора соседа.
			next_hop_self boolean	Варианты: no yes	Включить/выключить вычисление следующего перехода для этого соседа.
			remove_private_as boolean	Варианты: no yes	Удалить частный номер AS из исходящих обновлений.
			route_reflector_client boolean	Варианты: no yes	Указать соседа как клиента рефлетора маршрутов.
			route_server_client boolean	Варианты: no yes	Указать соседа как клиента сервера маршрутов.
		networks -			Указать сети, которые нужно объявить через BGP. Для операции replace этот параметр взаимоисключающий с параметром root level networks.
			masklen -		Длина маски подсети для объявления сети (например, 8, 16, 24 и т.д.).
			network - / обязательно		Идентификатор сети для объявления через BGP.
			route_map -		Карта маршрутов для изменения атрибутов.
		redistribute -			Указывает информацию о перераспределении из другого протокола маршрутизации.
			id -		Указывает идентификатор экземпляра/идентификатор таблицы для этого протокола. Действительно для ospf и таблицы
			metric -		Указывает метрику для перераспределенных маршрутов.
			protocol - / обязательно	Варианты: ospf ospf6 eigrp isis table static connected sharp nhrp kernel babel rip	Указывает протокол для настройки информации о перераспределении.
			route_map -		Указывает ссылку на карту маршрутов.
		safi -		Варианты: flowspec unicast ← multicast labeled-unicast	Указывает тип доставки для семейства адресов.
	bgp_as целое число / обязательно				Указывает номер автономной системы BGP (AS) для настройки на устройстве.
	log_neighbor_changes boolean			Варианты: no yes	Включить/выключить протоколирование соседа up/down и причину сброса.
	neighbors -				Указывает конфигурации, связанные с соседями BGP.
		advertisement_interval целое число			Минимальный интервал между отправкой обновлений маршрутизации BGP для этого соседа.
		description -			Описание, специфичное для соседа.
		ebgp_multihop целое число			Указывает максимальное количество переходов для соседей EBGP, не находящихся в непосредственно подключенных сетях. Диапазон от 1 до 255.
		enabled boolean		Варианты: no yes	Административно отключить или включить соседа.
		local_as целое число			Местный номер AS для соседа.
		neighbor - / обязательно			Адрес маршрутизатора соседа.
		password -			Пароль для аутентификации соединения соседа BGP.
		peer_group -			Имя группы коллег, членом которой является сосед.
		port целое число			Номер TCP-порта для этого соседа. Диапазон от 0 до 65535.
		remote_as целое число / обязательно			Удаленный AS соседа BGP для настройки.

		таймеры -			Указывает конфигурацию таймеров соседа BGP.
			holdtime целое число / обязательно		Интервал (в секундах) после того, как не получено сообщение keepalive, что FRR объявляет пир мертвым. Диапазон от 0 до 65535.
			keepalive целое число / обязательно		Частота (в секундах) отправки сообщений keepalive FRR своему пиру. Диапазон от 0 до 65535.
		update_source -			Источник маршрутных обновлений.
	сети -				Укажите сети, которые необходимо объявить через BGP. Для операции замены этот параметр взаимоисключает параметр сетей в разделе address_family. Для операции замены, если на устройстве уже активирована адресная семья, этот параметр запрещён.
		masklen -			Длина подсети маски для объявления сети (например, 8, 16, 24 и т. д.).
		префикс - / обязательно			Идентификатор сети для объявления через BGP.
		route_map -			Карта маршрутов для изменения атрибутов.
	router_id -			По умолчанию: null	Настройка значения идентификатора маршрутизатора процесса маршрутизации BGP.
операция -				Варианты: merge ← replace override delete	Определяет операцию, которая должна быть выполнена над процессом BGP, настроенным на устройстве. В случае объединения входная конфигурация будет объединена с существующей конфигурацией BGP на устройстве. В случае замены, если есть разница между существующей и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого параметра, в котором есть разница. В случае переопределения вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией. В случае удаления существующая конфигурация BGP будет удалена с устройства.

Примечания

Примечание

Тестировалось на FRRouting 6.0.

Примеры

- name: configure global bgp as 64496
  frr_bgp:
    config:
      bgp_as: 64496
      router_id: 192.0.2.1
      log_neighbor_changes: True
      neighbors:
        - neighbor: 192.51.100.1
          remote_as: 64497
          timers:
            keepalive: 120
            holdtime: 360
        - neighbor: 198.51.100.2
          remote_as: 64498
      networks:
        - prefix: 192.0.2.0
          masklen: 24
          route_map: RMAP_1
        - prefix: 198.51.100.0
          masklen: 24
      address_family:
        - afi: ipv4
          safi: unicast
          redistribute:
            - protocol: ospf
              id: 223
              metric: 10
    operation: merge

- name: Configure BGP neighbors
  frr_bgp:
    config:
      bgp_as: 64496
      neighbors:
        - neighbor: 192.0.2.10
          remote_as: 64496
          password: ansible
          description: IBGP_NBR_1
          timers:
            keepalive: 120
            holdtime: 360
        - neighbor: 192.0.2.15
          remote_as: 64496
          description: IBGP_NBR_2
          advertisement_interval: 120
    operation: merge

- name: Configure BGP neighbors under address family mode
  frr_bgp:
    config:
      bgp_as: 64496
      address_family:
        - afi: ipv4
          safi: multicast
          neighbors:
            - neighbor: 203.0.113.10
              activate: yes
              maximum_prefix: 250

            - neighbor: 192.0.2.15
              activate: yes
              route_reflector_client: True
    operation: merge

- name: Configure root-level networks for BGP
  frr_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: remove bgp as 64496 from config
  frr_bgp:
    config:
      bgp_as: 64496
    operation: delete

Значения возврата

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

Ключ	Возвращаемое значение	Описание
команды список	всегда	Список команд режима конфигурации для отправки на устройство Пример: ['router bgp 64496', 'bgp router-id 192.0.2.1', 'neighbor 192.51.100.1 remote-as 64497', 'neighbor 192.51.100.1 timers 120 360', 'neighbor 198.51.100.2 remote-as 64498', 'address-family ipv4 unicast', 'redistribute ospf 223 metric 10', 'exit-address-family', 'bgp log-neighbor-changes', 'network 192.0.2.0/24 route-map RMAP_1', 'network 198.51.100.0/24', 'exit']

Статус

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

Поддержка 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.8/modules/frr_bgp_module.html