ansible / ansible.builtin / v2.6.17 / module / nclu Configure network interfaces using NCLU | "added in version" 2.3 of ansible.builtin" Authors: Cumulus Networks preview | supported by communityansible.builtin.nclu (v2.6.17) — module
pip
Install with pip install ansible==2.6.17
Interface to the Network Command Line Utility, developed to make it easier to configure operating systems running ifupdown2 and Quagga, such as Cumulus Linux. Command documentation is available at U(https://docs.cumulusnetworks.com/display/DOCS/Network+Command+Line+Utility)
- name: Add two interfaces without committing any changes nclu: commands: - add int swp1 - add int swp2
- name: Modify hostname to Cumulus-1 and commit the change nclu: commands: - add hostname Cumulus-1 commit: true
- name: Add 48 interfaces and commit the change. nclu: template: | {% for iface in range(1,49) %} add int swp{{iface}} {% endfor %} commit: true description: "Ansible - add swps1-48"
- name: Atomically add an interface nclu: commands: - add int swp1 atomic: true description: "Ansible - add swp1"
- name: Configure BGP AS and add 2 EBGP neighbors using BGP Unnumbered nclu: commands: - add bgp autonomous-system 65000 - add bgp neighbor swp51 interface remote-as external - add bgp neighbor swp52 interface remote-as external commit: true
abort: default: false description: - Boolean. When true, perform a 'net abort' before the block. This cleans out any uncommitted changes in the buffer. Mutually exclusive with I(atomic). atomic: default: false description: - When true, equivalent to both I(commit) and I(abort) being true. Mutually exclusive with I(commit) and I(atomic). commit: default: false description: - When true, performs a 'net commit' at the end of the block. Mutually exclusive with I(atomic). commands: description: - A list of strings containing the net commands to run. Mutually exclusive with I(template). template: description: - A single, multi-line string with jinja2 formatting. This string will be broken by lines, and each line will be run through net. Mutually exclusive with I(commands). description: default: Ansible-originated commit description: - Commit description that will be recorded to the commit log if I(commit) or I(atomic) are true.
changed: description: whether the interface was changed returned: changed sample: true type: bool msg: description: human-readable report of success or failure returned: always sample: interface bond0 config updated type: string