The Ansible FRR collection includes a variety of Ansible content to help automate the management of FRR network appliances.
This collection has been tested against FRR 6.0.
The FRR collection supports network_cli
connections.
Name | Description |
---|---|
frr.frr.frr | Use frr cliconf to run command on Free Range Routing platform |
Name | Description |
---|---|
frr.frr.frr_bgp | Configure global BGP settings on Free Range Routing(FRR). |
frr.frr.frr_facts | Collect facts from remote devices running Free Range Routing (FRR). |
Click the Content
button to see the list of content included in this collection.
You can install the FRR collection with the Ansible Galaxy CLI:
ansible-galaxy collection install frr.frr
You can also include it in a requirements.yml
file and install it with ansible-galaxy collection install -r requirements.yml
, using the format:
---
collections:
- name: frr.frr
You can call modules by their Fully Qualified Collection Namespace (FQCN), such as frr.frr.frr_bgp
.
The following example task replaces configuration changes in the existing configuration on a FRR network device, using the FQCN:
---
- 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
Alternately, you can call modules by their short name if you list the frr.frr
collection in the playbook's collections
, as follows:
---
- hosts: frr01
gather_facts: false
connection: network_cli
collections:
- frr.frr
tasks:
- name: Collect all facts from the device
frr_facts:
gather_subset: all
- FRR Platform Options
- Ansible Using collections for more details.
We welcome community contributions to this collection. If you find problems, please open an issue or create a PR against the FRR collection repository.
You can also join us on:
- Freenode IRC -
#ansible-network
Freenode channel - Slack - https://ansiblenetwork.slack.com
See the Ansible Community Guide for details on contributing to Ansible.
- Ansible network resources
- Ansible Collection overview
- Ansible User guide
- Ansible Developer guide
- Ansible Community code of conduct
GNU General Public License v3.0 or later.
See LICENSE to see the full text.