arista.eos.eos_bgp – Настройка глобальных параметров протокола BGP на устройствах Arista EOS.
Примечание
Этот плагин входит в коллекцию arista.eos (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install arista.eos.
Для использования в плейбуке укажите: arista.eos.eos_bgp.
Новое в версии 1.0.0: плагина arista.eos
Описание
- Этот модуль предоставляет управление конфигурацией глобальных параметров BGP на устройствах Arista EOS.
Примечание
Данный модуль имеет соответствующий плагин действий.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |||
|---|---|---|---|---|---|
| config словарь | Указывает конфигурацию, связанную с BGP. | ||||
| address_family список / элементы=словарь | Указывает конфигурации, связанные с семейством адресов BGP. | ||||
| afi строка / обязательно |
| Тип семейства адресов для конфигурации. | |||
| neighbors список / элементы=словарь | Указывает конфигурации, связанные с соседями BGP, в режиме конфигурации семейства адресов. | ||||
| activate логическое значение |
| Включить семейство адресов для этого соседа. | |||
| default_originate логическое значение |
| Создать маршрут по умолчанию для этого соседа. | |||
| graceful_restart логическое значение |
| Включить/отключить режим плавного перезапуска для этого соседа. | |||
| neighbor строка / обязательно | Адрес маршрутизатора соседа. | ||||
| weight целое число | Назначить вес маршрутам, полученным от этого соседа. Диапазон от 0 до 65535 | ||||
| networks список / элементы=словарь | Укажите сети для объявления через BGP. При операции замены этот параметр взаимоисключающий с опцией сетей на уровне корня. | ||||
| masklen целое число | Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.). | ||||
| prefix строка / обязательно | Идентификатор сети для объявления через BGP. | ||||
| route_map строка | Карта маршрутов для изменения атрибутов. | ||||
| redistribute список / элементы=словарь | Указывает информацию о перераспределении из другого протокола маршрутизации. | ||||
| protocol строка / обязательно |
| Указывает протокол для конфигурации информации о перераспределении. | |||
| route_map строка | Указывает ссылку на карту маршрутов. | ||||
| bgp_as целое число / обязательно | Указывает номер автономной системы BGP (AS), который необходимо сконфигурировать на устройстве. | ||||
| log_neighbor_changes логическое значение |
| Включить/отключить протоколирование соседей up/down и причин сброса. | |||
| neighbors список / элементы=словарь | Указывает конфигурации, связанные с соседями BGP. | ||||
| description строка | Описание, специфичное для соседа. | ||||
| ebgp_multihop целое число | Указывает максимальное количество хопов для соседей EBGP, которые не находятся на непосредственно подключенных сетях. Диапазон от 1 до 255. | ||||
| enabled логическое значение |
| Административно отключает или включает соседа. | |||
| maximum_prefix целое число | Максимальное количество префиксов, принимаемых от этого участника. Диапазон от 0 до 4294967294. | ||||
| neighbor строка / обязательно | Адрес маршрутизатора соседа. | ||||
| password строка | Пароль для аутентификации соединения BGP-партнера. | ||||
| peer_group строка | Имя группы партнеров, членом которой является сосед. | ||||
| remote_as целое число / обязательно | Удаленная AS соседа BGP для конфигурации. | ||||
| remove_private_as логическое значение |
| Удалить частный номер AS из исходящих обновлений. | |||
| route_reflector_client целое число | Указать соседа как клиента отражателя маршрутов. | ||||
| timers словарь | Указывает конфигурации таймеров BGP соседа. | ||||
| holdtime целое число / обязательно | Интервал (в секундах) после того, как не получено сообщение keepalive, что устройство объявляет партнера неработающим. Диапазон от 3 до 7200. Установка этого значения в 0 не будет отправлять keep-alive (всегда активен). | ||||
| keepalive целое число / обязательно | Частота (в секундах) с которой устройство отправляет сообщения keepalive своему партнеру. Диапазон от 0 до 3600. | ||||
| update_source строка | Источник обновлений маршрутизации. | ||||
| networks список / элементы=словарь | Укажите сети для объявления через BGP. При операции замены этот параметр взаимоисключающий с опцией сетей в address_family. При операции замены, если на устройстве уже активировано семейство адресов, эта опция недопустима. | ||||
| masklen целое число | Длина маски подсети для объявления сети (например, 8, 16, 24 и т. д.). | ||||
| prefix строка / обязательно | Идентификатор сети для объявления через BGP. | ||||
| route_map строка | Карта маршрутов для изменения атрибутов. | ||||
| redistribute список / элементы=словарь | Указывает информацию о перераспределении из другого протокола маршрутизации. | ||||
| protocol строка / обязательно |
| Указывает протокол для конфигурации информации о перераспределении. | |||
| route_map строка | Указывает ссылку на карту маршрутов. | ||||
| router_id строка | Настраивает значение идентификатора маршрутизатора для процесса маршрутизации BGP. | ||||
| операция строка |
| Указывает операцию, которая должна быть выполнена с конфигурацией процесса BGP на устройстве. В случае слияния входная конфигурация будет слита с существующей конфигурацией BGP на устройстве. В случае замены, если есть разница между существующей и входной конфигурацией, существующая конфигурация будет заменена входной конфигурацией для каждого параметра, имеющего разницу. В случае переопределения вся существующая конфигурация BGP будет удалена с устройства и заменена входной конфигурацией. В случае удаления существующая конфигурация BGP будет удалена с устройства. | |||
Примечания
Примечание
- Проверено на Arista vEOS Версии 4.15.9M.
Примеры
- name: configure global bgp as 64496
arista.eos.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
arista.eos.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
arista.eos.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
arista.eos.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
arista.eos.eos_bgp:
config:
bgp_as: 64496
operation: delete
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| команды список / элементы=строка | всегда | Список команд режима конфигурации, которые необходимо отправить на устройство Пример: ['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'] |
Авторы
- 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/arista/eos/eos_bgp_module.html
