Try SpotterConfigure global BGP settings on Free Range Routing(FRR).
| "added in version" 2.8 of ansible.builtin"
Authors: Nilashish Chakraborty (@NilashishC)
preview | supported by network
pipInstall with pip install ansible==2.9.27
This module provides configuration management of global BGP parameters on devices running Free Range Routing(FRR).
- 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
config:
description:
- Specifies the BGP related configuration.
suboptions:
address_family:
description:
- Specifies BGP address family related configurations.
suboptions:
afi:
choices:
- ipv4
- ipv6
description:
- Type of address family to configure.
required: true
neighbors:
description:
- Specifies BGP neighbor related configurations in Address Family configuration
mode.
suboptions:
activate:
description:
- Enable the address family for this neighbor.
type: bool
maximum_prefix:
description:
- Maximum number of prefixes to accept from this peer.
- The range is from 1 to 4294967295.
type: int
neighbor:
description:
- Neighbor router address.
required: true
next_hop_self:
description:
- Enable/disable the next hop calculation for this neighbor.
type: bool
remove_private_as:
description:
- Remove the private AS number from outbound updates.
type: bool
route_reflector_client:
description:
- Specify a neighbor as a route reflector client.
type: bool
route_server_client:
description:
- Specify a neighbor as a route server client.
type: bool
networks:
description:
- Specify networks to announce via BGP.
- For operation replace, this option is mutually exclusive with root level
networks option.
suboptions:
masklen:
description:
- Subnet mask length for the network to announce(e.g, 8, 16, 24, etc.).
network:
description:
- Network ID to announce via BGP.
required: true
route_map:
description:
- Route map to modify the attributes.
redistribute:
description:
- Specifies the redistribute information from another routing protocol.
suboptions:
id:
description:
- Specifies the instance ID/table ID for this protocol
- Valid for ospf and table
metric:
description:
- Specifies the metric for redistributed routes.
protocol:
choices:
- ospf
- ospf6
- eigrp
- isis
- table
- static
- connected
- sharp
- nhrp
- kernel
- babel
- rip
description:
- Specifies the protocol for configuring redistribute information.
required: true
route_map:
description:
- Specifies the route map reference.
safi:
choices:
- flowspec
- unicast
- multicast
- labeled-unicast
default: unicast
description:
- Specifies the type of cast for the address family.
bgp_as:
description:
- Specifies the BGP Autonomous System (AS) number to configure on the device.
required: true
type: int
log_neighbor_changes:
description:
- Enable/disable logging neighbor up/down and reset reason.
type: bool
neighbors:
description:
- Specifies BGP neighbor related configurations.
suboptions:
advertisement_interval:
description:
- Minimum interval between sending BGP routing updates for this neighbor.
type: int
description:
description:
- Neighbor specific description.
ebgp_multihop:
description:
- Specifies the maximum hop count for EBGP neighbors not on directly connected
networks.
- The range is from 1 to 255.
type: int
enabled:
description:
- Administratively shutdown or enable a neighbor.
type: bool
local_as:
description:
- The local AS number for the neighbor.
type: int
neighbor:
description:
- Neighbor router address.
required: true
password:
description:
- Password to authenticate the BGP peer connection.
peer_group:
description:
- Name of the peer group that the neighbor is a member of.
port:
description:
- The TCP Port number to use for this neighbor.
- The range is from 0 to 65535.
type: int
remote_as:
description:
- Remote AS of the BGP neighbor to configure.
required: true
type: int
timers:
description:
- Specifies BGP neighbor timer related configurations.
suboptions:
holdtime:
description:
- Interval (in seconds) after not receiving a keepalive message that FRR
declares a peer dead.
- The range is from 0 to 65535.
required: true
type: int
keepalive:
description:
- Frequency (in seconds) with which the FRR sends keepalive messages to
its peer.
- The range is from 0 to 65535.
required: true
type: int
update_source:
description:
- Source of the routing updates.
networks:
description:
- Specify networks to announce via BGP.
- For operation replace, this option is mutually exclusive with networks option
under address_family.
- For operation replace, if the device already has an address family activated,
this option is not allowed.
suboptions:
masklen:
description:
- Subnet mask length for the network to announce(e.g, 8, 16, 24, etc.).
prefix:
description:
- Network ID to announce via BGP.
required: true
route_map:
description:
- Route map to modify the attributes.
router_id:
default: null
description:
- Configures the BGP routing process router-id value.
operation:
choices:
- merge
- replace
- override
- delete
default: merge
description:
- Specifies the operation to be performed on the BGP process configured on the device.
- In case of merge, the input configuration will be merged with the existing BGP configuration
on the device.
- In case of replace, if there is a diff between the existing configuration and the
input configuration, the existing configuration will be replaced by the input configuration
for every option that has the diff.
- In case of override, all the existing BGP configuration will be removed from the
device and replaced with the input configuration.
- In case of delete the existing BGP configuration will be removed from the device.
commands: description: The list of configuration mode commands to send to the device returned: always sample: - 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 type: list