dellemc.enterprise_sonic.sonic_bgp_af module – Manage global BGP address-family and its parameters
Note
This module is part of the dellemc.enterprise_sonic collection (version 3.2.0).
You might already have this collection installed if you are using the ansible package.
It is not included in ansible-core.
To check whether it is installed, run ansible-galaxy collection list.
To install it, use: ansible-galaxy collection install dellemc.enterprise_sonic.
To use it in a playbook, specify: dellemc.enterprise_sonic.sonic_bgp_af.
New in dellemc.enterprise_sonic 1.0.0
Synopsis
This module provides configuration management of global BGP_AF parameters on devices running Enterprise SONiC.
bgp_as and vrf_name must be created in advance on the device.
Parameters
Parameter |
Comments |
|---|---|
Specifies the BGP_AF related configuration. |
|
Specifies BGP address family related configurations. |
|
List of address families, such as ipv4, ipv6, and l2vpn. afi and safi are required together. |
|
Specifies the advertise all vni flag. Choices:
|
|
Specifies the advertise default gateway flag. Choices:
|
|
Enables advertise PIP Choices:
|
|
PIP IPv4 address |
|
PIP peer IPv4 address |
|
Enables advertise SVI MACIP routes Choices:
|
|
Type of address family to configure. Choices:
|
|
Aggregate address configuration |
|
Enables/disables generation of AS set path information Choices:
|
|
Preconfigured routing policy (route map name) to be applied to aggregate network |
|
Aggregate address prefix |
|
Enables/disables restriction of route information included in updates Choices:
|
|
Enable route flap dampening if set to true Choices:
|
|
Duplicate address detection configuration. max_moves and time are required together. |
|
Enable duplicate address detection. Choices:
|
|
Specifies duplicate address detection freeze. Value can be
|
|
Specifies the max allowed moves before address is detected as duplicate. The range is from 2 to 1000. |
|
Specifies the duplicate address detection time. The range is from 2 to 1800. |
|
Specifies the routes to be imported to this address family. |
|
Import routes from other VRFs. |
|
Specifies the route-map. |
|
Specifies the VRFs to import routes from. |
|
Specifies the maximum paths of ibgp and ebgp count. |
|
Specifies the count of the ebgp multipaths count. |
|
Specifies the count of the ibgp multipaths count. |
|
Enable routing on an IP network for each prefix provided in the network |
|
Specifies the route distiguisher to be used by the VRF instance. |
|
Specifies the redistribute information from another routing protocol. |
|
Specifies the metric for redistributed routes. |
|
Specifies the protocol for configuring redistribute information. Choices:
|
|
Specifies the route map reference. |
|
List of advertise routes |
|
Specifies the address family Choices:
|
|
Specifies the route-map reference |
|
Route-targets to be imported. |
|
Route-targets to be exported. |
|
Specifies the type of communication for the address family. Choices:
|
|
VNI configuration for the EVPN. |
|
Specifies the advertise default gateway flag. Choices:
|
|
Enables advertise SVI MACIP routes Choices:
|
|
Specifies the route distiguisher to be used by the VRF instance. |
|
Route-targets to be imported. |
|
Route-targets to be exported. |
|
Specifies the VNI number. |
|
Specifies the BGP autonomous system (AS) number which is already configured on the device. |
|
Specifies the VRF name which is already configured on the device. Default: |
|
Specifies the operation to be performed on the BGP_AF process configured on the device. In case of merged, the input configuration is merged with the existing BGP_AF configuration on the device. In case of deleted, the existing BGP_AF configuration is removed from the device. In case of replaced, the existing BGP_AF of specified BGP AS will be replaced with provided configuration. In case of overridden, the existing BGP_AF configuration will be overridden with the provided configuration. Choices:
|
Notes
Note
Tested against Enterprise SONiC Distribution by Dell Technologies.
Supports
check_mode.
Examples
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# network 3.3.3.3/16
# aggregate-address 1.1.1.1/1
# aggregate-address 5.5.5.5/5 as-set summary-only route-map rmap-1
# dampening
# import vrf route-map rmap-1
# import vrf default
# !
# router bgp 51
# router-id 111.2.2.41
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# dampening
# !
# address-family ipv6 unicast
# redistribute connected route-map bb metric 21
# redistribute ospf route-map aa metric 27
# redistribute static route-map bb metric 26
# maximum-paths 4
# maximum-paths ibgp 5
# !
# address-family l2vpn evpn
# advertise-svi-ip
# advertise ipv6 unicast route-map aa
# rd 3.3.3.3:33
# route-target import 22:22
# route-target export 33:33
# dup-addr-detection
# advertise-pip ip 1.1.1.1 peer-ip 2.2.2.2
# !
# vni 1
# advertise-default-gw
# advertise-svi-ip
# rd 5.5.5.5:55
# route-target import 88:88
# route-target export 77:77
#
- name: Delete BGP Address family configuration from the device
dellemc.enterprise_sonic.sonic_bgp_af:
config:
- bgp_as: 51
address_family:
afis:
- afi: l2vpn
safi: evpn
advertise_pip: true
advertise_pip_ip: "1.1.1.1"
advertise_pip_peer_ip: "2.2.2.2"
advertise_svi_ip: true
advertise_all_vni: false
advertise_default_gw: false
route_advertise_list:
- advertise_afi: ipv6
route_map: aa
rd: "3.3.3.3:33"
rt_in:
- "22:22"
rt_out:
- "33:33"
vnis:
- vni_number: 1
- afi: ipv4
safi: unicast
- afi: ipv6
safi: unicast
max_path:
ebgp: 2
ibgp: 5
redistribute:
- metric: "21"
protocol: connected
route_map: bb
- metric: "27"
protocol: ospf
route_map: aa
- metric: "26"
protocol: static
route_map: bb
- bgp_as: 51
vrf_name: VrfReg1
address_family:
afis:
- afi: ipv4
safi: unicast
import:
vrf:
vrf_list:
- default
route_map: rmap-1
aggregate_address_config:
- prefix: "1.1.1.1/1"
- prefix: "5.5.5.5/5"
as_set: true
policy_name: rmap-1
summary_only: true
state: deleted
# After state:
# ------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# network 3.3.3.3/16
# aggregate-address 5.5.5.5/5
# dampening
# !
# router bgp 51
# router-id 111.2.2.41
# timers 60 180
# !
# address-family ipv6 unicast
# !
# address-family l2vpn evpn
# dup-addr-detection
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# network 3.3.3.3/16
# aggregate-address 5.5.5.5/5 as-set summary-only route-map rmap-1
# dampening
# import vrf route-map rmap-1
# import vrf default
# !
# router bgp 51
# router-id 111.2.2.41
# timers 60 180
# !
# address-family ipv6 unicast
# !
# address-family l2vpn evpn
#
- name: Delete All BGP address family configurations
dellemc.enterprise_sonic.sonic_bgp_af:
config:
state: deleted
# After state:
# ------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# router bgp 51
# router-id 111.2.2.41
# timers 60 180
#
# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# router bgp 51
# router-id 111.2.2.41
# timers 60 180
# !
# address-family l2vpn evpn
# dup-addr-detection
#
- name: Merge provided BGP address family configuration on the device.
dellemc.enterprise_sonic.sonic_bgp_af:
config:
- bgp_as: 51
address_family:
afis:
- afi: l2vpn
safi: evpn
advertise_pip: true
advertise_pip_ip: "3.3.3.3"
advertise_pip_peer_ip: "4.4.4.4"
advertise_svi_ip: true
advertise_all_vni: false
advertise_default_gw: false
dup_addr_detection:
freeze: permanent
max_moves: 10
time: 600
route_advertise_list:
- advertise_afi: ipv4
route_map: bb
rd: "1.1.1.1:11"
rt_in:
- "12:12"
rt_out:
- "13:13"
vnis:
- vni_number: 1
advertise_default_gw: true
advertise_svi_ip: true
rd: "5.5.5.5:55"
rt_in:
- "88:88"
rt_out:
- "77:77"
- afi: ipv4
safi: unicast
network:
- 2.2.2.2/16
- 192.168.10.1/32
dampening: true
aggregate_address_config:
- prefix: 1.1.1.1/1
as_set: true
policy_name: bb
summary_only: true
- afi: ipv6
safi: unicast
max_path:
ebgp: 4
ibgp: 5
redistribute:
- metric: "21"
protocol: connected
route_map: bb
- metric: "27"
protocol: ospf
route_map: aa
- metric: "26"
protocol: static
route_map: bb
- bgp_as: 51
vrf_name: VrfReg1
address_family:
afis:
- afi: ipv4
safi: unicast
import:
vrf:
vrf_list:
- default
route_map: rmap-1
state: merged
# After state:
# ------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# import vrf route-map rmap-1
# import vrf default
# !
# router bgp 51
# router-id 111.2.2.41
# timers 60 180
# !
# address-family ipv4 unicast
# network 2.2.2.2/16
# network 192.168.10.1/32
# aggregate-address 1.1.1.1/1 as-set summary-only route-map bb
# dampening
# !
# address-family ipv6 unicast
# redistribute connected route-map bb metric 21
# redistribute ospf route-map aa metric 27
# redistribute static route-map bb metric 26
# maximum-paths 4
# maximum-paths ibgp 5
# !
# address-family l2vpn evpn
# advertise-svi-ip
# advertise ipv4 unicast route-map bb
# rd 1.1.1.1:11
# route-target import 12:12
# route-target import 13:13
# dup-addr-detection max-moves 10 time 600
# dup-addr-detection freeze permanent
# advertise-pip ip 3.3.3.3 peer-ip 4.4.4.4
# !
# vni 1
# advertise-default-gw
# advertise-svi-ip
# rd 5.5.5.5:55
# route-target import 88:88
# route-target export 77:77
#
# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# network 3.3.3.3/16
# dampening
# !
# router bgp 51 vrf VrfReg2
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# import vrf route-map rmap-1
# import vrf default
# !
# router bgp 51
# router-id 111.2.2.41
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# redistribute connected route-map bb metric 21
# redistribute ospf route-map bb metric 27
# maximum-paths 1
# maximum-paths ibgp 1
# network 2.2.2.2/16
# network 192.168.10.1/32
# aggregate-address 5.5.5.5/5 as-set summary-only route-map bb
# dampening
# !
# address-family ipv6 unicast
# redistribute static route-map aa metric 26
# maximum-paths 4
# maximum-paths ibgp 5
# !
# address-family l2vpn evpn
# advertise-all-vni
# advertise-svi-ip
# advertise ipv4 unicast route-map bb
# rd 1.1.1.1:11
# route-target import 12:12
# route-target export 13:13
# advertise-pip ip 3.3.3.3 peer-ip 4.4.4.4
# no dup-addr-detection
# !
# vni 1
# advertise-default-gw
# advertise-svi-ip
# rd 5.5.5.5:55
# route-target import 88:88
# route-target export 77:77
#
- name: Replace device configuration of address families of specified BGP AS with provided configuration.
dellemc.enterprise_sonic.sonic_bgp_af:
config:
- bgp_as: 51
address_family:
afis:
- afi: l2vpn
safi: evpn
advertise_pip: true
advertise_pip_ip: "3.3.3.3"
advertise_pip_peer_ip: "4.4.4.4"
advertise_svi_ip: true
advertise_all_vni: true
advertise_default_gw: false
route_advertise_list:
- advertise_afi: ipv4
route_map: bb
rd: "1.1.1.1:11"
rt_in:
- "22:22"
rt_out:
- "13:13"
vnis:
- vni_number: 5
advertise_default_gw: true
advertise_svi_ip: true
rd: "10.10.10.10:55"
rt_in:
- "88:88"
rt_out:
- "77:77"
- afi: ipv4
safi: unicast
network:
- 2.2.2.2/16
- 192.168.10.1/32
dampening: true
redistribute:
- protocol: connected
- protocol: ospf
metric: 30
aggregate-address-config:
- prefix: '5.5.5.5/5'
as_set: true
- bgp_as: 51
vrf_name: VrfReg2
address_family:
afis:
- afi: ipv4
safi: unicast
import:
vrf:
vrf_list:
- VrfReg1
route_map: rmap-reg1
state: replaced
# After state:
# ------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# network 3.3.3.3/16
# dampening
# !
# router bgp 51 vrf VrfReg2
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# import vrf route-map rmap-reg1
# import vrf VrfReg1
# !
# router bgp 51
# router-id 111.2.2.41
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# redistribute connected
# redistribute ospf metric 30
# maximum-paths 1
# maximum-paths ibgp 1
# network 2.2.2.2/16
# network 192.168.10.1/32
# aggregate-address 5.5.5.5/5 as-set
# dampening
# !
# address-family ipv6 unicast
# redistribute static route-map aa metric 26
# maximum-paths 4
# maximum-paths ibgp 5
# !
# address-family l2vpn evpn
# advertise-all-vni
# advertise-svi-ip
# advertise ipv4 unicast route-map bb
# rd 1.1.1.1:11
# route-target import 22:22
# route-target export 13:13
# dup-addr-detection
# advertise-pip ip 3.3.3.3 peer-ip 4.4.4.4
# !
# vni 5
# advertise-default-gw
# advertise-svi-ip
# rd 10.10.10.10:55
# route-target import 88:88
# route-target export 77:77
#
# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# maximum-paths 1
# maximum-paths ibgp 1
# network 3.3.3.3/16
# dampening
# import vrf route-map rmap-1
# import vrf default
# !
# router bgp 51
# router-id 111.2.2.41
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# redistribute connected route-map bb metric 21
# redistribute ospf route-map bb metric 27
# maximum-paths 1
# maximum-paths ibgp 1
# network 2.2.2.2/16
# network 192.168.10.1/32
# dampening
# !
# address-family ipv6 unicast
# redistribute static route-map aa metric 26
# maximum-paths 4
# maximum-paths ibgp 5
# !
# address-family l2vpn evpn
# advertise-all-vni
# advertise-svi-ip
# advertise ipv4 unicast route-map bb
# rd 1.1.1.1:11
# route-target import 12:12
# route-target export 13:13
# dup-addr-detection max-moves 10 time 600
# dup-addr-detection freeze permanent
# advertise-pip ip 3.3.3.3 peer-ip 4.4.4.4
# !
# vni 1
# advertise-default-gw
# advertise-svi-ip
# rd 5.5.5.5:55
# route-target import 88:88
# route-target export 77:77
#
- name: Override device configuration of BGP address families with provided configuration.
dellemc.enterprise_sonic.sonic_bgp_af:
config:
- bgp_as: 51
address_family:
afis:
- afi: l2vpn
safi: evpn
advertise_pip: true
advertise_pip_ip: "3.3.3.3"
advertise_pip_peer_ip: "4.4.4.4"
advertise_svi_ip: true
advertise_all_vni: true
advertise_default_gw: false
dup_addr_detection:
freeze: '600'
route_advertise_list:
- advertise_afi: ipv4
route_map: bb
rd: "1.1.1.1:11"
rt_in:
- "22:22"
rt_out:
- "13:13"
vnis:
- vni_number: 5
advertise_default_gw: true
advertise_svi_ip: true
rd: "10.10.10.10:55"
rt_in:
- "88:88"
rt_out:
- "77:77"
- afi: ipv4
safi: unicast
network:
- 2.2.2.2/16
- 192.168.10.1/32
dampening: true
redistribute:
- protocol: connected
- protocol: ospf
metric: 30
aggregate_address_config:
- prefix: 4.4.4.4/4
as_set: true
policy_name: bb
summary_only: true
state: overridden
# After state:
# ------------
#
# sonic# show running-configuration bgp
# !
# router bgp 51 vrf VrfReg1
# log-neighbor-changes
# timers 60 180
# !
# router bgp 51
# router-id 111.2.2.41
# log-neighbor-changes
# timers 60 180
# !
# address-family ipv4 unicast
# redistribute connected
# redistribute ospf metric 30
# maximum-paths 1
# maximum-paths ibgp 1
# network 2.2.2.2/16
# network 192.168.10.1/32
# aggregate-address 4.4.4.4/4 as-set summary-only route-map bb
# dampening
# !
# address-family l2vpn evpn
# advertise-all-vni
# advertise-svi-ip
# advertise ipv4 unicast route-map bb
# rd 1.1.1.1:11
# route-target import 22:22
# route-target export 13:13
# dup-addr-detection
# dup-addr-detection freeze 600
# advertise-pip ip 3.3.3.3 peer-ip 4.4.4.4
# !
# vni 5
# advertise-default-gw
# advertise-svi-ip
# rd 10.10.10.10:55
# route-target import 88:88
# route-target export 77:77
#
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
|---|---|
The resulting configuration module invocation. Returned: when changed Sample: |
|
The configuration prior to the module invocation. Returned: always Sample: |
|
The set of commands pushed to the remote device. Returned: always Sample: |