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	Варианты: нет да	Включить семейство адресов для этого соседа.
			maximum_prefix целое число		Максимальное количество префиксов, принимаемых от этого узла. Диапазон от 1 до 4294967295.
			neighbor - / обязательно		Адрес маршрутизатора соседа.
			next_hop_self boolean	Варианты: нет да	Включить/выключить вычисление следующего узла для этого соседа.
			remove_private_as boolean	Варианты: нет да	Удалить частный номер AS из исходящих обновлений.
			route_reflector_client boolean	Варианты: нет да	Указать соседа как клиента отражателя маршрутов.
			route_server_client boolean	Варианты: нет да	Указать соседа как клиента сервера маршрутов.
		networks -			Указать сети для объявления через BGP. В режиме работы замена, этот параметр несовместим с опцией сетей на корневом уровне.
			masklen -		Длина маски подсети для объявления сети (например, 8, 16, 24 и т.д.).
			network - / обязательно		Идентификатор сети для объявления через BGP.
			route_map -		Карта маршрутов для изменения атрибутов.
		redistribute -			Указывает информацию о перераспределении из другого протокола маршрутизации.
			id -		Указывает идентификатор экземпляра/таблицы для этого протокола. Действительно для ospf и таблицы
			metric -		Указывает метрику для перераспределенных маршрутов.
			protocol - / обязательно	Варианты: ospf ospf6 eigrp isis таблица статический подключенный sharp nhrp ядро babel rip	Указывает протокол для настройки информации о перераспределении.
			route_map -		Указывает ссылку на карту маршрутов.
		safi -		Варианты: flowspec одноадресные ← многоадресные меченые одноадресные	Указывает тип адресации для семейства адресов.
	bgp_as целое число / обязательно				Указывает номер автономной системы (AS) BGP для настройки на устройстве.
	log_neighbor_changes boolean			Варианты: нет да	Включить/выключить протоколирование установления/разъединения соседей и причину сброса.
	neighbors -				Указывает конфигурации, связанные с соседями BGP.
		advertisement_interval целое число			Минимальный интервал между отправкой обновлений маршрутизации BGP для этого соседа.
		description -			Описание, специфичное для соседа.
		ebgp_multihop целое число			Указывает максимальное количество переходов для соседей EBGP, не подключенных напрямую. Диапазон от 1 до 255.
		enabled boolean		Варианты: нет да	Административно выключить или включить соседа.
		local_as целое число			Местный номер AS для соседа.
		neighbor - / обязательно			Адрес маршрутизатора соседа.
		password -			Пароль для аутентификации подключения к BGP-узлу.
		peer_group -			Имя группы узлов, членом которой является сосед.
		port целое число			Номер TCP-порта, используемый для этого соседа. Диапазон от 0 до 65535.
		remote_as целое число / обязательно			Удаленный AS соседа BGP для настройки.

		timers -			Указывает конфигурации таймеров соседа BGP.
			holdtime целое число / обязательно		Интервал (в секундах) после того, как не получено сообщение keepalive, что FRR объявляет соседа мертвым. Диапазон от 0 до 65535.
			keepalive целое число / обязательно		Частота (в секундах), с которой FRR отправляет сообщения keepalive своему соседу. Диапазон от 0 до 65535.
		update_source -			Источник маршрутных обновлений.
	networks -				Укажите сети, которые необходимо анонсировать через BGP. Для операции replace этот параметр взаимоисключающий с параметром networks в address_family. Для операции replace, если на устройстве уже активирована address family, этот параметр недопустим.
		masklen -			Длина маски подсети для анонсируемой сети (например, 8, 16, 24 и т.д.).
		prefix - / обязательно			Идентификатор сети, который необходимо анонсировать через BGP.
		route_map -			Карта маршрутов для изменения атрибутов.
	router_id -			По умолчанию: null	Настраивает значение router-id процесса маршрутизации BGP.
operation -				Варианты: merge ← replace override delete	Указывает операцию, которая должна быть выполнена над процессом BGP, настроенным на устройстве. В случае merge входная конфигурация будет слита с существующей конфигурацией BGP на устройстве. В случае replace, если есть разница между существующей и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого параметра, в котором есть разница. В случае override вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией. В случае delete существующая конфигурация 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

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

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

Ключ	Возвращается	Описание
commands список	всегда	Список команд конфигурации режима, которые нужно отправить устройству Пример: ['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 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/frr_bgp_module.html