eos_bgp – Настройка глобальных параметров протокола BGP на устройствах Arista EOS

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

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Краткое описание

Этот модуль предоставляет управление конфигурацией глобальных параметров BGP на устройствах Arista EOS.

Параметры

Параметр				Варианты/Значения по умолчанию	Комментарии
config -					Указывает конфигурацию, связанную с BGP.
	address_family -				Указывает конфигурации, связанные с семействами адресов BGP.
		afi - / обязательно		Варианты: ipv4 ipv6	Тип семейства адресов для настройки.
		neighbors -			Указывает конфигурации, связанные с соседями BGP в режиме настройки семейства адресов.
			activate boolean	Варианты: no yes	Включить семейство адресов для данного соседа.
			default_originate boolean	Варианты: no yes	Создавать маршрут по умолчанию для этого соседа.
			graceful_restart boolean	Варианты: no yes	Включить/выключить режим плавного перезапуска для этого соседа.
			neighbor - / обязательно		Адрес маршрутизатора соседа.
			weight integer		Присвоить вес маршрутам, полученным от этого соседа. Диапазон значений от 0 до 65535
		networks -			Указать сети для объявления через BGP. Для замены, этот параметр взаимоисключающий с параметром root-level networks.
			masklen -		Длина маски подсети для объявления сети (например, 8, 16, 24 и т.д.).
			prefix - / обязательно		Идентификатор сети для объявления через BGP.
			route_map -		Карта маршрутов для изменения атрибутов.
		redistribute -			Указывает информацию о перераспределении из другого протокола маршрутизации.
			protocol - / обязательно		Указывает протокол для настройки информации о перераспределении.
			route_map -		Указывает ссылку на карту маршрутов.
	bgp_as integer / обязательно				Указывает номер автономной системы BGP (AS), который необходимо настроить на устройстве.
	log_neighbor_changes boolean			Варианты: no yes	Включить/выключить протоколирование событий подключения/отключения соседей и причины перезапуска.
	neighbors -				Указывает конфигурации, связанные с соседями BGP.
		description -			Описание, специфичное для соседа.
		ebgp_multihop integer			Указывает максимальное количество переходов для соседей EBGP, которые не находятся в напрямую подключенных сетях. Диапазон от 1 до 255.
		enabled -			Административно отключить или включить соседа.
		maximum_prefix integer			Максимальное количество префиксов, принимаемых от этого узла. Диапазон от 0 до 4294967294.
		neighbor - / обязательно			Адрес маршрутизатора соседа.
		password -			Пароль для аутентификации соединения BGP с узлом.
		peer_group -			Имя группы узлов, к которой принадлежит сосед.
		remote_as integer / обязательно			Удаленная AS соседа BGP для настройки.
		remove_private_as boolean		Варианты: no yes	Удалить частный номер AS из исходящих обновлений.
		route_reflector_client boolean		Варианты: no yes	Указать соседа как клиента отражателя маршрутов.
		timers -			Указывает конфигурации таймеров соседей BGP.
			holdtime integer / обязательно		Интервал (в секундах) после того, как не было получено сообщение keepalive, что устройство объявляет соседа мертвым. Диапазон от 3 до 7200. Установка этого значения в 0 не будет отправлять keep-alive (hold forever).
			keepalive integer / обязательно		Частота (в секундах), с которой устройство отправляет сообщения keepalive своему соседу. Диапазон от 0 до 3600.
		update_source -			Источник маршрутных обновлений.
	networks -				Укажите сети для объявления через BGP. Для замены, этот параметр взаимоисключающий с параметром networks в address_family. Для замены, если на устройстве уже активировано семейство адресов, этот параметр не разрешен.
		masklen -			Длина маски подсети для объявления сети (например, 8, 16, 24 и т.д.).

		prefix - / обязательно		Идентификатор сети для объявления через BGP.
		route_map -		Карта маршрутов для изменения атрибутов.
	redistribute -			Указывает информацию о перераспределении из другого протокола маршрутизации.
		protocol - / обязательно		Указывает протокол для настройки информации о перераспределении.
		route_map -		Указывает ссылку на карту маршрутов.
	router_id -		По умолчанию: null	Настраивает значение идентификатора маршрутизатора процесса маршрутизации BGP.
operation -			Варианты: merge ← replace override delete	Указывает операцию, которая должна быть выполнена для процесса BGP, настроенного на устройстве. В случае merge входная конфигурация будет слита с существующей конфигурацией BGP на устройстве. В случае replace, если есть разница между существующей конфигурацией и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого варианта, у которого есть разница. В случае override вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией. В случае delete существующая конфигурация BGP будет удалена с устройства.

Примечания

Примечание

Проверено на Arista vEOS версии 4.15.9M.

Примеры

- name: configure global bgp as 64496
  eos_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
        - 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: isis
              route_map: RMAP_1
    operation: merge

- name: Configure BGP neighbors
  eos_bgp:
    config:
      bgp_as: 64496
      neighbors:
        - neighbor: 192.0.2.10
          remote_as: 64496
          description: IBGP_NBR_1
          ebgp_multihop: 100
          timers:
            keepalive: 300
            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
  eos_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
  eos_bgp:
    config:
      bgp_as: 64496
      address_family:
        - afi: ipv4
          neighbors:
            - neighbor: 203.0.113.10
              activate: yes
              default_originate: True

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

- name: remove bgp as 64496 from config
  eos_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', '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 isis route-map RMAP_1', 'exit-address-family']

Статус

Не гарантируется обратная совместимость интерфейса этого модуля. [превью]
Этот модуль поддерживается командой 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/eos_bgp_module.html