community.network.pn_vrouter_bgp – CLI command to add/modify/remove vrouter-bgp

Note

This plugin is part of the community.network collection (version 3.0.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 community.network.

To use it in a playbook, specify: community.network.pn_vrouter_bgp.

Synopsis

  • This module can be used to add Border Gateway Protocol neighbor to a vRouter modify Border Gateway Protocol neighbor to a vRouter and remove Border Gateway Protocol neighbor from a vRouter.

Parameters

Parameter Choices/Defaults Comments
pn_advertisement_interval
string
Minimum interval between sending BGP routing updates.
pn_allowas_in
boolean
    Choices:
  • no
  • yes
Allow/reject routes with local AS in AS_PATH.
pn_bfd
boolean
    Choices:
  • no ←
  • yes
BFD protocol support for fault detection.
pn_bfd_multihop
boolean
    Choices:
  • no
  • yes
always use BFD multi-hop port for fault detection.
pn_cliswitch
string
Target switch to run the CLI on.
pn_connect_retry_interval
string
BGP Connect retry interval (seconds).
pn_default_originate
boolean
    Choices:
  • no
  • yes
announce default routes to the neighbor or not.
pn_ebgp_multihop
string
value for external BGP from 1 to 255.
pn_interface
string
Interface to reach the neighbor.
pn_max_prefix
string
maximum number of prefixes.
pn_max_prefix_warn_only
boolean
    Choices:
  • no
  • yes
warn if the maximum number of prefixes is exceeded.
pn_multi_protocol
string
    Choices:
  • ipv4-unicast
  • ipv6-unicast
Multi-protocol features.
pn_neighbor
string / required
IP address for BGP neighbor.
pn_neighbor_holdtime
string
BGP Holdtime (seconds).
pn_neighbor_keepalive_interval
string
BGP Keepalive interval (seconds).
pn_next_hop_self
boolean
    Choices:
  • no
  • yes
BGP next hop is self or not.
pn_no_route_map_in
string
Remove ingress route-map from BGP neighbor.
pn_no_route_map_out
string
Remove egress route-map from BGP neighbor.
pn_override_capability
boolean
    Choices:
  • no
  • yes
override capability.
pn_password
string
password for MD5 BGP.
pn_prefix_list_in
string
prefixes used for filtering.
pn_prefix_list_out
string
prefixes used for filtering outgoing packets.
pn_remote_as
string
BGP remote AS from 1 to 4294967295.
pn_route_map_in
string
route map in for nbr.
pn_route_map_out
string
route map out for nbr.
pn_route_reflector_client
boolean
    Choices:
  • no
  • yes
set as route reflector client.
pn_send_community
boolean
    Choices:
  • no
  • yes
send any community attribute to neighbor.
pn_soft_reconfig_inbound
boolean
    Choices:
  • no
  • yes
soft reset to reconfigure inbound traffic.
pn_update_source
string
IP address of BGP packets required for peering over loopback interface.
pn_vrouter_name
string / required
name of service config.
pn_weight
string
default weight value between 0 and 65535 for the neighbor's routes.
state
string
    Choices:
  • present ←
  • absent
  • update
vrouter-bgp configuration command.

Examples

- name: "Add BGP to vRouter"
  community.network.pn_vrouter_bgp:
    state: 'present'
    pn_vrouter_name: 'sw01-vrouter'
    pn_neighbor: '105.104.104.1'
    pn_remote_as: 65000
    pn_bfd: true

- name: "Remove BGP to vRouter"
  community.network.pn_vrouter_bgp:
    state: 'absent'
    pn_vrouter_name: 'sw01-vrouter'
    pn_neighbor: '105.104.104.1'

- name: "Modify BGP to vRouter"
  community.network.pn_vrouter_bgp:
    state: 'update'
    pn_vrouter_name: 'sw01-vrouter'
    pn_neighbor: '105.104.104.1'
    pn_remote_as: 65000
    pn_bfd: false
    pn_allowas_in: true

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
changed
boolean
always
indicates whether the CLI caused changes on the target.

command
string
always
the CLI command run on the target node.

stderr
list / elements=string
on error
set of error responses from the vrouter-bgp command.

stdout
list / elements=string
always
set of responses from the vrouter-bgp command.



Authors

  • Pluribus Networks (@rajaspachipulusu17)