An Ansible role to manage Cumulus Linux through NCLU module.
Cumulus Linux version 3.2+ only, previous releases do not support NCLU.
| Variable | Description | Type | Default |
|---|---|---|---|
cl_license |
CumulusLinux license | String | '' |
cl_hostname |
Hostname of the device | String | cumulus |
cl_time_zone |
Timezone | String | Etc/UTC |
cl_time_ntp_servers |
NTP servers list, possibility to add iburst option | Array | [] |
cl_time_ntp_source |
NTP source interface | String | eth0 |
cl_locales |
Enable locale from locale-gen | Array | [] |
cl_dns_nameserver |
DNS nameserver from two subarray ipv4 and ipv6 | Hash | {} |
cl_commands |
Ansible nclu atomic commands using recursive lookup, permit del/add actions, played first | Hash | {} |
cl_snmp |
snmp-server settings from net add snmp-server using recursive lookup |
Hash | {} |
cl_syslog |
syslog setings from two subarray of hash ipv4 and ipv6, each entry need an ip + a port and optionaly a proto(udp/tcp) | Hash | {} |
cl_interface |
interface settings from net add interface using recursive lookup |
Hash | {} |
cl_bond |
bond settings from net add bond using recursive lookup |
Hash | {} |
cl_vlan |
vlan settings from net add vlan using recursive lookup |
Hash | {} |
None
To manage Cumulus Linux interface configuration with Ansible, I coded a lookup plugin to be able to construct the variables from a hash and it will recursivly read the nested hash to transform the hash into a list of strings.
Every depth into the variables will be added to the nclu command like that:
var:
cl_interface:
swp1:
ip:
address: 192.168.1.1/24
link:
speed: 100
swp2:
bridge:
trunk:
vlans:
- 1-5
- 10,12
results:
swp1 ip address 192.168.1.1/24
swp2 bridge trunk vlans 1-5
swp2 bridge trunk vlans 10,12
This way I find the structure of the variables more readable for complex settings.
- hosts: leaf01
roles:
- cumuluslinux
vars:
cl_license: [email protected]|thequickbrownfoxjumpsoverthelazydog312
cl_hostname: leaf01
cl_time_zone: Europe/Paris
cl_time_ntp_servers:
- 0.cumulusnetworks.pool.ntp.org iburst
- 1.cumulusnetworks.pool.ntp.org
- 2.cumulusnetworks.pool.ntp.org
- 3.cumulusnetworks.pool.ntp.org
cl_time_ntp_source: eth1
cl_locales:
- en_US.UTF-8 UTF-8
- fr_FR.UTF-8 UTF-8
cl_dns_nameserver:
ipv4:
- 9.9.9.9
- 1.1.1.1
ipv6:
- 2620:fe::fe
cl_interface:
swp1:
ip:
address: 192.168.1.1/24
link:
speed: 100
swp2:
bridge:
trunk:
vlans:
- 1-5
- 10,12
cl_snmp:
listening-address:
ip:
- 192.168.1.10
- 192.168.1.20
readonly-community:
my_rocommunity:
access: any
cl_commands:
add:
vrf: mgmt
del:
snmp-server: all
cl_syslog:
ipv4:
- ip: 192.168.1.10
port: 5000
proto: tcp
- ip: 192.168.1.20
port: 6000
ipv6:
- ip: 2001:db8::1
port: 5000
cl_bond:
uplink:
bond:
slaves:
- swp1
- swp2
cl_vlan:
100:
ip:
adress:
- 10.10.10.0/24MIT
Are welcome !