Модуль dellemc.enterprise_sonic.sonic_bgp_neighbors — управление соседом BGP и его параметрами

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install dellemc.enterprise_sonic.

Чтобы использовать её в плейбуке, укажите: dellemc.enterprise_sonic.sonic_bgp_neighbors.

Добавлено в dellemc.enterprise_sonic 1.0.0

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

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

Этот модуль обеспечивает управление конфигурацией глобальных параметров BGP_NEIGHBORS на устройствах под управлением Enterprise SONiC.
Параметры bgp_as и vrf_name необходимо предварительно создать на устройстве.

Параметры

Параметр	Комментарии
config list / elements=dictionary	Задает конфигурацию, связанную с соседями BGP.
bgp_as string / required	Задает номер автономной системы (AS) BGP, уже настроенный на устройстве.
neighbors list / elements=dictionary	Задает конфигурацию, связанную с соседями BGP.
advertisement_interval integer	Задает минимальный интервал между отправкой обновлений маршрутизации BGP. Диапазон значений: от 0 до 600.
auth_pwd dictionary	Конфигурация пароля аутентификации группы соседей.
encrypted boolean	Указывает, является ли пароль зашифрованным текстом. Варианты: `false` ← (по умолчанию) `true`
pwd string / required	Пароль аутентификации группы соседей.
bfd dictionary	Включает или отключает BFD.
check_failure boolean	Связывает состояние канала передачи данных с плоскостью управления. Варианты: `false` `true`
enabled boolean	Включает проверку активности BFD для соседа BGP. Варианты: `false` `true`
profile string	Имя профиля BFD.
capability dictionary	Задает атрибуты возможностей для этого соседа.
dynamic boolean	Включает или отключает динамические возможности для этого соседа. Варианты: `false` `true`
extended_nexthop boolean	Включает или отключает объявление узлу расширенной возможности next-hop. Варианты: `false` `true`
disable_connected_check boolean	Отключает проверку подключенного маршрута EBGP. Варианты: `false` `true`
dont_negotiate_capability boolean	Отключает согласование возможностей. Варианты: `false` `true`
ebgp_multihop dictionary	Разрешает подключение соседей EBGP, не находящихся в непосредственно подключенных сетях.
enabled boolean	Разрешает косвенное подключение указанной группы или соседей. Варианты: `false` ← (по умолчанию) `true`
multihop_ttl integer	Значение времени жизни пакетов, отправляемых указанной группе или соседям при включенном ebgp-multihop.
enforce_first_as boolean	Обеспечивает проверку первой AS для маршрутов EBGP. Варианты: `false` `true`
enforce_multihop boolean	Обеспечивает работу EBGP в режиме multihop для соседа. Варианты: `false` `true`
extended_link_bandwidth boolean добавлено в dellemc.enterprise_sonic 3.1.0	Настраивает расширенное сообщество Link Bandwidth для соседа BGP. Варианты: `false` `true`
local_address string	Задает локальный IP-адрес, используемый для сеанса при отправке сообщений обновления BGP.
local_as dictionary	Задает номер локальной автономной системы.
as string / required	Номер локальной автономной системы.
no_prepend boolean	Не добавлять номер local-as в объявления AS-Path. Варианты: `false` `true`
replace_as boolean	Заменяет настроенный номер AS номером local-as в объявлениях AS-Path. Варианты: `false` `true`
nbr_description string	Текстовое описание соседа.
neighbor string / required	Адрес маршрутизатора-соседа.
override_capability boolean	Переопределяет результат согласования возможностей. Варианты: `false` `true`
passive boolean	Не отправлять этому соседу сообщения open. Значение по умолчанию при добавлении нового соседа: `False`. Варианты: `false` `true`
peer_group string	Имя группы пиров, к которой относится сосед.
port integer	Порт BGP соседа.
remote_as dictionary	Удаленная AS настраиваемого соседа BGP. Параметры peer_as и peer_type являются взаимоисключающими.
peer_as string	Задает номер удаленной AS. Диапазон значений: от 1 до 4294967295.
peer_type string	Задает тип пира BGP. Варианты: `"internal"` `"external"`
shutdown_msg string	Добавляет сообщение о завершении работы.
solo boolean	Указывает, что маршруты, объявленные пиром, не следует отражать обратно этому пиру. Варианты: `false` `true`
strict_capability_match boolean	Включает строгое сопоставление согласованных возможностей. Варианты: `false` `true`
timers dictionary	Задает конфигурацию таймеров соседа BGP.
connect_retry integer	Интервал в секундах между попытками установить сеанс с пиром. Диапазон значений: от 1 до 65535.
holdtime integer	Интервал в секундах после неполучения сообщения keepalive, по истечении которого SONiC объявляет пир недоступным. Диапазон значений: от 0 до 65535.
keepalive integer	Частота отправки устройством сообщений keepalive пиру, в секундах. Диапазон значений: от 0 до 65535.
ttl_security integer	Разрешает установление соседства только с соседями, находящимися на указанном расстоянии в количестве переходов.
v6only boolean	Включает BGP только с локальными адресами канала IPv6. Варианты: `false` `true`
peer_group list / elements=dictionary	Задает список групп пиров.
address_family dictionary	Содержит список семейств адресов, связанных с группой пиров.
afis list / elements=dictionary	Список семейств адресов с параметрами afi, safi, activate и allowas-in. Параметры afi и safi необходимо указывать вместе.
activate boolean	Включает или отключает активацию. Варианты: `false` `true`
afi string / required	Содержит режим afi. Варианты: `"ipv4"` `"ipv6"` `"l2vpn"`
allowas_in dictionary	Критерий принятия полученных объявлений, содержащих номер AS экземпляра маршрутизатора BGP в AS PATH полученных объявлений. Параметру ‘origin’ нельзя присвоить значение true, если задан параметр ‘value’.
origin boolean	Принимать заданную AS этого экземпляра маршрутизатора BGP как исходную. Варианты: `false` `true`
value integer	Принимать до указанного количества вхождений заданной AS этого маршрутизатора BGP в AS-PATH полученных объявлений. (Укажите число в диапазоне от 1 до 10.)
ip_afi dictionary	Общие атрибуты конфигурации для семейств адресов одноадресной рассылки IPv4 и IPv6.
default_policy_name string	Задает определение политики маршрутизации.
send_default_route boolean	Включает или отключает отправку маршрута по умолчанию пиру. Варианты: `false` ← (по умолчанию) `true`
prefix_limit dictionary	Задает атрибуты ограничения префиксов для ipv4-unicast и ipv6-unicast.

discard_extra boolean	Включить или отключить отбрасывание дополнительных маршрутов в сеансе BGP при превышении максимального предела префиксов. Варианты: `false` ← (по умолчанию) `true`
max_prefixes integer	Максимальное количество префиксов, принимаемых от узла-пира.
prevent_teardown boolean	Включить или отключить разрыв сеанса BGP при превышении максимального предела префиксов. Варианты: `false` ← (по умолчанию) `true`
restart_timer integer	Интервал времени в секундах, по истечении которого сеанс BGP устанавливается заново после разрыва.
warning_threshold integer	Порог количества префиксов, которые можно получить от узла-пира до выдачи предупреждений. Задаётся в процентах от max-prefixes.
prefix_list_in string	Политика фильтрации входящих маршрутов для узла-пира.
prefix_list_out string	Политика фильтрации исходящих маршрутов для узла-пира.
safi string	Задаёт режим safi. Варианты: `"unicast"` `"evpn"`
advertisement_interval integer	Задаёт минимальный интервал между отправкой обновлений маршрутизации BGP. Диапазон: от 0 до 600.
auth_pwd dictionary	Настройки пароля аутентификации группы узлов-пиров.
encrypted boolean	Указывает, является ли пароль зашифрованным текстом. Варианты: `false` ← (по умолчанию) `true`
pwd string / обязательный	Пароль аутентификации группы узлов-пиров.
bfd dictionary	Включает или отключает BFD.
check_failure boolean	Связывает состояние канального уровня плоскости передачи данных с плоскостью управления. Варианты: `false` `true`
enabled boolean	Включает проверку активности BFD для узла-пира BGP. Варианты: `false` `true`
profile string	Имя профиля BFD.
capability dictionary	Задаёт атрибуты возможностей для этой группы узлов-пиров.
dynamic boolean	Включает или отключает динамические возможности для этой группы узлов-пиров. Варианты: `false` `true`
extended_nexthop boolean	Включает или отключает объявление узлу-пиру возможности расширенного следующего перехода. Варианты: `false` `true`
disable_connected_check boolean	Отключает проверку подключённого маршрута EBGP. Варианты: `false` `true`
dont_negotiate_capability boolean	Отключает согласование возможностей. Варианты: `false` `true`
ebgp_multihop dictionary	Разрешает узлам-пирам EBGP, не находящимся в непосредственно подключённых сетях, устанавливать соединение.
enabled boolean	Разрешает указанной группе или узлам-пирам подключаться опосредованно. Варианты: `false` ← (по умолчанию) `true`
multihop_ttl integer	Значение времени жизни (TTL), используемое при отправке пакетов указанной группе или узлам-пирам, если включён ebgp-multihop.
enforce_first_as boolean	Обеспечивает проверку первого номера AS в маршрутах EBGP. Варианты: `false` `true`
enforce_multihop boolean	Обеспечивает использование многопереходного EBGP для узла-пира. Варианты: `false` `true`
extended_link_bandwidth boolean добавлено в dellemc.enterprise_sonic 3.1.0	Настраивает расширенное сообщество Link Bandwidth для узла-пира BGP. Варианты: `false` `true`
local_address string	Задаёт локальный IP-адрес, используемый для сеанса при отправке сообщений обновления BGP.
local_as dictionary	Задаёт локальный номер автономной системы.
as string / обязательный	Локальный номер автономной системы.
no_prepend boolean	Не добавлять номер local-as в начало списка AS-Path в объявлениях маршрутов. Варианты: `false` `true`
replace_as boolean	Заменять настроенный номер AS номером local-as в объявлениях маршрутов AS-Path. Варианты: `false` `true`
name string / обязательный	Имя группы узлов-пиров.
override_capability boolean	Переопределяет результат согласования возможностей. Варианты: `false` `true`
passive boolean	Не отправлять этому узлу-пиру сообщения open. Значение по умолчанию при добавлении новой группы узлов-пиров — `False`. Варианты: `false` `true`
pg_description string	Текстовое описание группы узлов-пиров.
remote_as dictionary	Удалённая AS настраиваемой группы узлов-пиров BGP. Параметры peer_as и peer_type взаимоисключающие.
peer_as string	Задаёт номер удалённой AS. Диапазон: от 1 до 4294967295.
peer_type string	Задаёт тип узла-пира BGP. Варианты: `"internal"` `"external"`
shutdown_msg string	Добавляет сообщение о завершении работы.
solo boolean	Указывает, что маршруты, объявленные узлом-пиром, не следует отражать обратно этому узлу-пиру. Варианты: `false` `true`
strict_capability_match boolean	Включает строгое сопоставление при согласовании возможностей. Варианты: `false` `true`
timers dictionary	Задаёт настройки таймеров группы узлов-пиров BGP.
connect_retry integer	Интервал времени в секундах между попытками установить сеанс с узлом-пиром. Диапазон: от 1 до 65535.
holdtime integer	Интервал в секундах без получения сообщения keepalive, по истечении которого Enterprise SONiC считает узел-пир недоступным. Диапазон: от 0 до 65535.
keepalive integer	Частота отправки устройством сообщений keepalive узлу-пиру, в секундах. Диапазон: от 0 до 65535.
ttl_security integer	Разрешает устанавливать отношения пиринга только узлам-пирам, находящимся на указанном расстоянии в переходах.
vrf_name string	Задаёт имя VRF, уже настроенной на устройстве. По умолчанию: `"default"`
state string	Задаёт операцию, выполняемую над процессом BGP, настроенным на устройстве. При значении merged входная конфигурация объединяется с существующей конфигурацией BGP на устройстве. При значении deleted существующая конфигурация BGP удаляется с устройства. При значении replaced существующая конфигурация BGP на устройстве заменяется входной конфигурацией BGP. При значении overridden существующая конфигурация BGP на устройстве переопределяется входной конфигурацией BGP. Варианты: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

Проверено на Enterprise SONiC Distribution от Dell Technologies.
Поддерживает check_mode.

Примеры

# Using "deleted" state
#
# Before state:
# -------------
# router bgp 11 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
#  !
#  neighbor interface Eth1/3
# !
# router bgp 11
# network import-check
# timers 60 180
# !
# neighbor 192.168.1.4
# !
# peer-group SP1
#  timers connect 30
#  advertisement-interval 0
#  bfd
#  capability dynamic
# !
# peer-group SP2
#  timers connect 30
#  advertisement-interval 0
# !
#

- name: Deletes all BGP neighbors
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
    state: deleted

#
# After state:
# -------------
# router bgp 11 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# router bgp 11
#  network import-check
#  timers 60 180
# !
#

# Using "merged" state
#
# Before state:
# ------------
# router bgp 11 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# router bgp 11
#  network import-check
#  timers 60 180
# !

- name: "Adds sonic_bgp_neighbors"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        neighbors:
          - neighbor: Eth1/2
            auth_pwd:
              pwd: 'pw123'
              encrypted: false
            dont_negotiate_capability: true
            ebgp_multihop:
              enabled: true
              multihop_ttl: 1
            enforce_first_as: true
            enforce_multihop: true
            local_address: 'Ethernet4'
            local_as:
              as: 2
              no_prepend: true
              replace_as: true
            nbr_description: "description 1"
            override_capability: true
            passive: true
            port: 3
            shutdown_msg: 'msg1'
            solo: true
          - neighbor: 1.1.1.1
            disable_connected_check: true
            ttl_security: 5
      - bgp_as: 51
        vrf_name: VrfReg1
        peer_group:
          - name: SPINE
            bfd:
              check_failure: true
              enabled: true
              profile: 'profile 1'
            capability:
              dynamic: true
              extended_nexthop: true
            auth_pwd:
              pwd: 'U2FsdGVkX1/4sRsZ624wbAJfDmagPLq2LsGDOcW/47M='
              encrypted: true
            dont_negotiate_capability: true
            ebgp_multihop:
              enabled: true
              multihop_ttl: 1
            enforce_first_as: true
            enforce_multihop: true
            extended_link_bandwidth: true
            local_address: 'Ethernet4'
            local_as:
              as: 2
              no_prepend: true
              replace_as: true
            pg_description: 'description 1'
            override_capability: true
            passive: true
            solo: true
            remote_as:
              peer_as: 4
          - name: SPINE1
            disable_connected_check: true
            shutdown_msg: "msg1"
            strict_capability_match: true
            timers:
              keepalive: 30
              holdtime: 15
              connect_retry: 25
            ttl_security: 5
            address_family:
              afis:
                - afi: ipv4
                  safi: unicast
                  activate: true
                  allowas_in:
                    origin: true
                - afi: ipv6
                  safi: unicast
                  activate: true
                  allowas_in:
                    value: 5
        neighbors:
          - neighbor: Eth1/3
            remote_as:
              peer_as: 10
            peer_group: SPINE
            advertisement_interval: 15
            extended_link_bandwidth: true
            timers:
              keepalive: 30
              holdtime: 15
              connect_retry: 25
            bfd:
              check_failure: true
              enabled: true
              profile: 'profile 1'
            capability:
              dynamic: true
              extended_nexthop: true
            auth_pwd:
              pwd: 'U2FsdGVkX199MZ7YOPkOR9O6wEZmtGSgiDfnlcN9hBg='
              encrypted: true
            nbr_description: 'description 2'
            strict_capability_match: true
            v6only: true
          - neighbor: 192.168.1.4
    state: merged

#
# After state:
# ------------
# !
# router bgp 11 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE1
#  timers 15 30
#  timers connect 25
#  advertisement-interval 0
#  shutdown message msg1
#  disable-connected-check
#  strict-capability-match
#  ttl-security hops 5
# !
# peer-group SPINE
#  description "description 1"
#  ebgp-multihop 1
#  remote-as 4
#  timers connect 30
#  advertisement-interval 0
#  bfd check-control-plane-failure profile "profile 1"
#  update-source interface Ethernet4
#  capability dynamic
#  capability extended-nexthop
#  dont-capability-negotiate
#  enforce-first-as
#  enforce-multihop
#  extended-link-bandwidth
#  local-as 2 no-prepend replace-as
#  override-capability
#  passive
#  password U2FsdGVkX1/4sRsZ624wbAJfDmagPLq2LsGDOcW/47M= encrypted
#  solo
#  address-family ipv4 unicast
#   activate
#   allowas-in origin
#   send-community both
# !
#  address-family ipv6 unicast
#   activate
#   allowas-in 5
#   send-community both
# !
# neighbor interface Eth1/3
#  description "description 2"
#  peer-group SPINE
#  remote-as 10
#  timers 15 30
#  timers connect 25
#  bfd check-control-plane-failure profile "profile 1"
#  advertisement-interval 15
#  capability extended-nexthop
#  capability dynamic
#  extended-link-bandwidth
#  v6only
#  password U2FsdGVkX199MZ7YOPkOR9O6wEZmtGSgiDfnlcN9hBg= encrypted
#  strict-capability-match
# !
# neighbor 192.168.1.4
# !
# router bgp 51
#  network import-check
#  timers 60 180
# !
# neighbor interface Eth1/2
#  description "description 1"
#  shutdown message msg1
#  ebgp-multihop 1
#  remote-as external
#  update-source interface Ethernet4
#  dont-capability-negotiate
#  enforce-first-as
#  enforce-multihop
#  local-as 2 no-prepend replace-as
#  override-capability
#  passive
#  password U2FsdGVkX1+bxMf9TKOhaXRNNaHmywiEVDF2lJ2c000= encrypted
#  port 3
#  solo
# neighbor 1.1.1.1
#  disable-connected-check
#  ttl-security hops 5
# router bgp 11
#  network import-check
#  timers 60 180
#

# Using "deleted" state
#
# Before state:
# ------------
# !
# router bgp 11 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE
#  bfd
#  remote-as 4
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#  peer-group SPINE
#  remote-as 10
#  timers 15 30
#  advertisement-interval 15
#  bfd
#  capability extended-nexthop
#  capability dynamic
# !
# neighbor 192.168.1.4
# !
# router bgp 11
#  network import-check
#  timers 60 180
# !
# peer-group SP
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#

- name: "Deletes sonic_bgp_neighbors and peer-groups specific to vrfname"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        vrf_name: VrfReg1
    state: deleted

# After state:
# ------------
# !
# router bgp 11 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# router bgp 11
#  network import-check
#  timers 60 180
# !
# peer-group SP
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#

# Using "deleted" state
#
# Before state:
# -------------
#
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE
#  bfd
#  remote-as 4
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#  peer-group SPINE
#  remote-as 10
#  timers 15 30
#  advertisement-interval 15
#  bfd
#  capability extended-nexthop
#  capability dynamic
#  extended-link-bandwidth
# !
# neighbor 192.168.1.4
# !

- name: "Deletes specific sonic_bgp_neighbors"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        neighbors:
          - neighbor: Eth1/2
            auth_pwd:
              pwd: 'pw123'
              encrypted: false
            dont_negotiate_capability: true
            ebgp_multihop:
              enabled: true
              multihop_ttl: 1
            enforce_first_as: true
            enforce_multihop: true
            local_address: 'Ethernet4'
            local_as:
              as: 2
              no_prepend: true
              replace_as: true
            nbr_description: 'description 1'
            override_capability: true
            passive: true
            port: 3
            shutdown_msg: 'msg1'
            solo: true
          - neighbor: 1.1.1.1
            disable_connected_check: true
            ttl_security: 5
      - bgp_as: 51
        vrf_name: VrfReg1
        peer_group:
          - name: SPINE
            bfd:
              check_failure: true
              enabled: true
              profile: 'profile 1'
            capability:
              dynamic: true
              extended_nexthop: true
            auth_pwd:
              pwd: 'U2FsdGVkX1/4sRsZ624wbAJfDmagPLq2LsGDOcW/47M='
              encrypted: true
            dont_negotiate_capability: true
            ebgp_multihop:
              enabled: true
              multihop_ttl: 1
            enforce_first_as: true
            enforce_multihop: true
            local_address: 'Ethernet4'
            local_as:
              as: 2
              no_prepend: true
              replace_as: true
            pg_description: 'description 1'
            override_capability: true
            passive: true
            solo: true
            remote_as:
              peer_as: 4
          - name: SPINE1
            disable_connected_check: true
            shutdown_msg: "msg1"
            strict_capability_match: true
            timers:
              keepalive: 30
              holdtime: 15
              connect_retry: 25
            ttl_security: 5
        neighbors:
          - neighbor: Eth1/3
            remote_as:
              peer_as: 10
            peer_group: SPINE
            advertisement_interval: 15
            timers:
              keepalive: 30
              holdtime: 15
              connect_retry: 25
            bfd:
              check_failure: true
              enabled: true
              profile: 'profile 1'
            capability:
              dynamic: true
              extended_nexthop: true
            auth_pwd:
              pwd: 'U2FsdGVkX199MZ7YOPkOR9O6wEZmtGSgiDfnlcN9hBg='
              encrypted: true
            extended_link_bandwidth: true
            nbr_description: 'description 2'
            strict_capability_match: true
            v6only: true
          - neighbor: 192.168.1.4
    state: deleted

#
# After state:
# -------------
#
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE1
#  timers connect 30
#  advertisement-interval 0
# !
# peer-group SPINE
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
# !
# neighbor interface Eth1/2
# !
# neighbor 1.1.1.1
#

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp peer-group vrf default
# (No bgp peer-group configuration present)

- name: "Configure BGP peer-group prefix-list attributes"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        peer_group:
          - name: SPINE
            address_family:
              afis:
                - afi: ipv4
                  safi: unicast
                  ip_afi:
                    default_policy_name: rmap_reg1
                    send_default_route: true
                  prefix_limit:
                    max_prefixes: 1
                    prevent_teardown: true
                    warning_threshold: 80
                  prefix_list_in: p1
                  prefix_list_out: p2
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration bgp peer-group vrf default
# !
# peer-group SPINE
#  timers connect 30
#  advertisement-interval 0
#  !
#  address-family ipv4 unicast
#   default-originate route-map rmap_reg1
#   prefix-list p1 in
#   prefix-list p2 out
#   send-community both
#   maximum-prefix 1 80 warning-only
#

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp peer-group vrf default
# (No bgp peer-group configuration present)

- name: "Configure BGP peer-group prefix-list attributes"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        peer_group:
          - name: SPINE
            address_family:
              afis:
                - afi: ipv4
                  safi: unicast
                  ip_afi:
                    default_policy_name: rmap_reg1
                    send_default_route: true
                  prefix_limit:
                    max_prefixes: 2
                    discard_extra: true
                    warning_threshold: 86
                  prefix_list_in: p1
                  prefix_list_out: p2
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration bgp peer-group vrf default
# !
# peer-group SPINE
#  timers connect 30
#  advertisement-interval 0
#  !
#  address-family ipv4 unicast
#   default-originate route-map rmap_reg1
#   prefix-list p1 in
#   prefix-list p2 out
#   send-community both
#   maximum-prefix 2 86 discard-extra
#

# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp peer-group vrf default
# !
# peer-group SPINE
#  timers connect 30
#  advertisement-interval 0
#  !
#  address-family ipv6 unicast
#   default-originate route-map rmap_reg2
#   prefix-list p1 in
#   prefix-list p2 out
#   send-community both
#   maximum-prefix 5 90 restart 2

- name: "Delete BGP peer-group prefix-list attributes"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        peer_group:
          - name: SPINE
            address_family:
              afis:
                - afi: ipv6
                  safi: unicast
                  ip_afi:
                    default_policy_name: rmap_reg2
                    send_default_route: true
                  prefix_limit:
                    max_prefixes: 5
                    warning_threshold: 90
                    restart-timer: 2
                  prefix_list_in: p1
                  prefix_list_out: p2
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration bgp peer-group vrf default
# !
# peer-group SPINE
#  timers connect 30
#  advertisement-interval 0
#  !
#  address-family ipv6 unicast
#    send-community both
#  !

#
# Using "replaced" state
#
# Before state:
# ------------
# !
# router bgp 51 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE3
#  bfd
#  remote-as 4
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#  remote-as 10
#  timers 15 30
#  advertisement-interval 15
#  bfd
#  capability extended-nexthop
#  capability dynamic
# !
# neighbor 192.168.1.4
# !
# router bgp 51
#  network import-check
#  timers 60 18
# !
# peer-group SP
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#

- name: "Replaces peer-groups specific to vrfname"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        vrf_name: VrfReg1
        peer_group:
          - name: SPINE3
            remote_as:
              peer_type: internal
          - name: SPINE4
            address_family:
              afis:
                - afi: ipv4
                  safi: unicast
                  allowas_in:
                    origin: true
    state: replaced

# After state:
# ------------
# !
# router bgp 51 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE3
#  remote-as internal
#  timers connect 30
#  advertisement-interval 0
# !
# peer-group SPINE4
#  timers connect 30
#  advertisement-interval 0
#  !
#  address-family ipv4 unicast
#   allowas-in origin
#   send-community both
# !
#  neighbor interface Eth1/3
#   remote-as 10
#   timers 15 30
#   advertisement-interval 15
#   bfd
#   capability extended-nexthop
#   capability dynamic
#  !
#  neighbor 192.168.1.4
# !
# router bgp 51
# network import-check
# timers 60 18
# !
# peer-group SP
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#
#

# Using "replaced" state
#
# Before state:
# ------------
# !
# router bgp 51 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE
#  bfd
#  remote-as 4
#  timers connect 30
#  advertisement-interval 0
#  extended-link-bandwidth
# !
# neighbor 192.168.1.1
#  peer-group SPINE
#  remote-as 10
#  timers 15 30
#  advertisement-interval 15
#  bfd
#  capability extended-nexthop
#  capability dynamic
# !
# neighbor 192.168.1.4
# !
# router bgp 51
#  network import-check
#  timers 60 18
# !
# peer-group SP
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#

- name: "Replaces sonic_bgp_neighbors specific to vrfname"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        vrf_name: VrfReg1
        neighbors:
          - neighbor: 192.168.1.1
            bfd:
              enabled: true
            capability:
              extended_nexthop: true
              dynamic: true
    state: replaced

# After state:
# ------------
# !
# router bgp 51 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE
#  bfd
#  remote-as 4
#  timers connect 30
#  advertisement-interval 0
#  extended-link-bandwidth
# !
# neighbor 192.168.1.1
#  bfd
#  capability extended-nexthop
#  capability dynamic
# !
# neighbor 192.168.1.4
# !
# router bgp 51
#  network import-check
#  timers 60 18
# !
# peer-group SP
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#

# Using "overridden" state
#
# Before state:
# ------------
# !
# router bgp 51 vrf VrfCheck2
#  network import-check
#  timers 60 180
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE
#  bfd
#  remote-as 4
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#  peer-group SPINE
#  remote-as 10
#  timers 15 30
#  advertisement-interval 15
#  bfd
#  capability extended-nexthop
#  capability dynamic
# !
# neighbor 192.168.1.4
# !
# router bgp 51
#  network import-check
#  timers 60 18
# !
# peer-group SP
#  timers connect 30
#  advertisement-interval 0
# !
# neighbor interface Eth1/3
#

- name: "Override sonic_bgp_neighbors and peer-groups specific to vrfname"
  dellemc.enterprise_sonic.sonic_bgp_neighbors:
    config:
      - bgp_as: 51
        vrf_name: VrfReg1
        peer_group:
          - name: SPINE3
            remote_as:
              peer_type: internal
          - name: SPINE4
            address_family:
              afis:
                - afi: ipv4
                  safi: unicast
                  allowas_in:
                    origin: true
    state: overridden

# After state:
# ------------
# !
# router bgp 51 vrf VrfReg1
#  network import-check
#  timers 60 180
# !
# peer-group SPINE3
#  remote-as internal
#  timers connect 30
#  advertisement-interval 0
# !
# peer-group SPINE4
#  timers connect 30
#  advertisement-interval 0
#  !
#  address-family ipv4 unicast
#   allowas-in origin
#   send-community both
# !
#

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

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

Ключ	Описание
after list / elements=string	Конфигурация, полученная в результате вызова модуля. Возвращается: при изменении Пример: `["The configuration returned is always in the same format as the parameters above.\n"]`
after(generated) list / elements=string	Сгенерированная конфигурация для вызова модуля. Возвращается: при `check_mode` Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
before list / elements=string	Конфигурация до вызова модуля. Возвращается: всегда Пример: `["The configuration returned is always in the same format as the parameters above.\n"]`
commands list / elements=string	Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

Abirami N (@abirami-n)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_bgp_neighbors_module.html