Server IP : 85.214.239.14 / Your IP : 18.221.217.100 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /proc/self/root/lib/python3/dist-packages/ansible_collections/frr/frr/plugins/modules/ |
Upload File : |
#!/usr/bin/python # -*- coding: utf-8 -*- # # (c) 2019, Ansible by Red Hat, inc # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) # from __future__ import absolute_import, division, print_function __metaclass__ = type DOCUMENTATION = """ module: frr_bgp author: Nilashish Chakraborty (@NilashishC) short_description: Configure global BGP settings on Free Range Routing(FRR). description: - This module provides configuration management of global BGP parameters on devices running Free Range Routing(FRR). version_added: 1.0.0 notes: - Tested against FRRouting 6.0. options: config: description: - Specifies the BGP related configuration. type: dict suboptions: bgp_as: description: - Specifies the BGP Autonomous System (AS) number to configure on the device. type: int required: true router_id: description: - Configures the BGP routing process router-id value. type: str log_neighbor_changes: description: - Enable/disable logging neighbor up/down and reset reason. type: bool neighbors: description: - Specifies BGP neighbor related configurations. type: list elements: dict suboptions: neighbor: description: - Neighbor router address. required: true type: str remote_as: description: - Remote AS of the BGP neighbor to configure. type: int required: true update_source: description: - Source of the routing updates. type: str password: description: - Password to authenticate the BGP peer connection. type: str enabled: description: - Administratively shutdown or enable a neighbor. type: bool description: description: - Neighbor specific description. type: str 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 peer_group: description: - Name of the peer group that the neighbor is a member of. type: str timers: description: - Specifies BGP neighbor timer related configurations. type: dict suboptions: keepalive: description: - Frequency (in seconds) with which the FRR sends keepalive messages to its peer. - The range is from 0 to 65535. type: int required: true holdtime: description: - Interval (in seconds) after not receiving a keepalive message that FRR declares a peer dead. - The range is from 0 to 65535. type: int required: true advertisement_interval: description: - Minimum interval between sending BGP routing updates for this neighbor. type: int local_as: description: - The local AS number for the neighbor. type: int port: description: - The TCP Port number to use for this neighbor. - The range is from 0 to 65535. type: int 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. type: list elements: dict suboptions: prefix: description: - Network ID to announce via BGP. required: true type: str masklen: description: - Subnet mask length for the network to announce(e.g, 8, 16, 24, etc.). required: true type: int route_map: description: - Route map to modify the attributes. type: str address_family: description: - Specifies BGP address family related configurations. type: list elements: dict suboptions: afi: description: - Type of address family to configure. choices: - ipv4 - ipv6 required: true type: str safi: description: - Specifies the type of cast for the address family. choices: - flowspec - unicast - multicast - labeled-unicast default: unicast type: str redistribute: description: - Specifies the redistribute information from another routing protocol. type: list elements: dict suboptions: protocol: description: - Specifies the protocol for configuring redistribute information. choices: - ospf - ospf6 - eigrp - isis - table - static - connected - sharp - nhrp - kernel - babel - rip required: true type: str id: description: - Specifies the instance ID/table ID for this protocol - Valid for ospf and table type: str metric: description: - Specifies the metric for redistributed routes. type: int route_map: description: - Specifies the route map reference. type: str networks: description: - Specify networks to announce via BGP. - For operation replace, this option is mutually exclusive with root level networks option. type: list elements: dict suboptions: prefix: description: - Network ID to announce via BGP. required: true type: str masklen: description: - Subnet mask length for the network to announce(e.g, 8, 16, 24, etc.). required: true type: int route_map: description: - Route map to modify the attributes. type: str neighbors: description: - Specifies BGP neighbor related configurations in Address Family configuration mode. type: list elements: dict suboptions: neighbor: description: - Neighbor router address. required: true type: str 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 activate: description: - Enable the address family for this neighbor. type: bool remove_private_as: description: - Remove the private AS number from outbound updates. type: bool next_hop_self: description: - Enable/disable the next hop calculation 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 operation: 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. default: merge choices: - merge - replace - override - delete type: str """ EXAMPLES = """ - name: configure global bgp as 64496 frr.frr.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.frr.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.frr.frr_bgp: config: bgp_as: 64496 address_family: - afi: ipv4 safi: multicast neighbors: - neighbor: 203.0.113.10 activate: true maximum_prefix: 250 - neighbor: 192.0.2.15 activate: true route_reflector_client: true operation: merge - name: Configure root-level networks for BGP frr.frr.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.frr.frr_bgp: config: bgp_as: 64496 operation: delete """ RETURN = """ commands: description: The list of configuration mode commands to send to the device returned: always type: list 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 """ from ansible.module_utils._text import to_text from ansible_collections.frr.frr.plugins.module_utils.network.frr.providers.cli.config.bgp.process import ( REDISTRIBUTE_PROTOCOLS, ) from ansible_collections.frr.frr.plugins.module_utils.network.frr.providers.module import ( NetworkModule, ) def main(): """main entry point for module execution""" network_spec = { "prefix": dict(required=True), "masklen": dict(type="int", required=True), "route_map": dict(), } redistribute_spec = { "protocol": dict(choices=REDISTRIBUTE_PROTOCOLS, required=True), "id": dict(), "metric": dict(type="int"), "route_map": dict(), } timer_spec = { "keepalive": dict(type="int", required=True), "holdtime": dict(type="int", required=True), } neighbor_spec = { "neighbor": dict(required=True), "remote_as": dict(type="int", required=True), "advertisement_interval": dict(type="int"), "local_as": dict(type="int"), "port": dict(type="int"), "update_source": dict(), "password": dict(no_log=True), "enabled": dict(type="bool"), "description": dict(), "ebgp_multihop": dict(type="int"), "timers": dict(type="dict", options=timer_spec), "peer_group": dict(), } af_neighbor_spec = { "neighbor": dict(required=True), "activate": dict(type="bool"), "remove_private_as": dict(type="bool"), "next_hop_self": dict(type="bool"), "route_reflector_client": dict(type="bool"), "route_server_client": dict(type="bool"), "maximum_prefix": dict(type="int"), } address_family_spec = { "afi": dict(choices=["ipv4", "ipv6"], required=True), "safi": dict( choices=["flowspec", "labeled-unicast", "multicast", "unicast"], default="unicast", ), "networks": dict(type="list", elements="dict", options=network_spec), "redistribute": dict(type="list", elements="dict", options=redistribute_spec), "neighbors": dict(type="list", elements="dict", options=af_neighbor_spec), } config_spec = { "bgp_as": dict(type="int", required=True), "router_id": dict(), "log_neighbor_changes": dict(type="bool"), "neighbors": dict(type="list", elements="dict", options=neighbor_spec), "address_family": dict(type="list", elements="dict", options=address_family_spec), "networks": dict(type="list", elements="dict", options=network_spec), } argument_spec = { "config": dict(type="dict", options=config_spec), "operation": dict(default="merge", choices=["merge", "replace", "override", "delete"]), } module = NetworkModule(argument_spec=argument_spec, supports_check_mode=True) try: result = module.edit_config(config_filter=" bgp") except Exception as exc: module.fail_json(msg=to_text(exc)) module.exit_json(**result) if __name__ == "__main__": main()