Documentation

cl_bridge - Configures a bridge port on Cumulus Linux

New in version 2.1.

DEPRECATED

Removed in Ansible:
 version: 2.5
Why:The nclu module is designed to be easier to use for individuals who are new to Cumulus Linux by exposing the NCLU interface in an automatable way.
Alternative:Use nclu instead.

Synopsis

  • Configures a bridge interface on Cumulus Linux To configure a bond port use the cl_bond module. To configure any other type of interface use the cl_interface module. Follow the guidelines for bridging found in the Cumulus User Guide at http://docs.cumulusnetworks.com

Requirements

The below requirements are needed on the host that executes this module.

  • Alternate Debian network interface manager ifupdown2 @ github.com/CumulusNetworks/ifupdown2

Parameters

Parameter
Choices/Defaults
Comments
addr_method
    Choices:
  • dhcp
Configures the port to use DHCP. To enable this feature use the option dhcp.
alias_name
Description of the port.
ipv4
List of IPv4 addresses to configure on the interface. In the form X.X.X.X/YY.
ipv6
List of IPv6 addresses to configure on the interface. In the form X:X:X::X/YYY.
location
Default:
[u'/etc/network/interfaces.d']
Interface directory location.
mstpctl_treeprio
Set spanning tree root priority. Must be a multiple of 4096.
mtu
Set MTU. Configure Jumbo Frame by setting MTU to 9000.
name
required
Name of the interface.
ports
required
List of bridge members.
pvid
In vlan-aware mode, defines vlan that is the untagged vlan.
stp
    Choices:
  • yes ←
  • no
Enables spanning tree Protocol. As of Cumulus Linux 2.5 the default bridging mode, only per vlan RSTP or 802.1d is supported. For the vlan aware mode, only common instance STP is supported
vids
In vlan-aware mode, lists VLANs defined under the interface.
virtual_ip
Define IPv4 virtual IP used by the Cumulus Linux VRR feature.
virtual_mac
Define Ethernet mac associated with Cumulus Linux VRR feature.
vlan_aware
    Choices:
  • yes
  • no
Enables vlan-aware mode.

Notes

Note

  • As this module writes the interface directory location, ensure that /etc/network/interfaces has a ‘source /etc/network/interfaces.d/*’ or whatever path is mentioned in the location attribute.
  • For the config to be activated, i.e installed in the kernel, “service networking reload” needs be be executed. See EXAMPLES section.

Examples

# Options ['virtual_mac', 'virtual_ip'] are required together
# configure a bridge vlan aware bridge.
- cl_bridge:
    name: br0
    ports: 'swp1-12'
    vlan_aware: 'yes'
  notify: reload networking

# configure bridge interface to define a default set of vlans
- cl_bridge:
    name: bridge
    ports: 'swp1-12'
    vlan_aware: 'yes'
    vids: '1-100'
  notify: reload networking

# define cl_bridge once in tasks file
# then write interface config in variables file
# with just the options you want.
- cl_bridge:
    name: "{{ item.key }}"
    ports: "{{ item.value.ports }}"
    vlan_aware: "{{ item.value.vlan_aware|default(omit) }}"
    ipv4:  "{{ item.value.ipv4|default(omit) }}"
    ipv6: "{{ item.value.ipv6|default(omit) }}"
    alias_name: "{{ item.value.alias_name|default(omit) }}"
    addr_method: "{{ item.value.addr_method|default(omit) }}"
    mtu: "{{ item.value.mtu|default(omit) }}"
    vids: "{{ item.value.vids|default(omit) }}"
    virtual_ip: "{{ item.value.virtual_ip|default(omit) }}"
    virtual_mac: "{{ item.value.virtual_mac|default(omit) }}"
    mstpctl_treeprio: "{{ item.value.mstpctl_treeprio|default(omit) }}"
  with_dict: "{{ cl_bridges }}"
  notify: reload networking

# In vars file
# ============
---
cl_bridge:
  br0:
    alias_name: 'vlan aware bridge'
    ports: ['swp1', 'swp3']
    vlan_aware: true
    vids: ['1-100']

Return Values

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

Key
Returned
Description
changed
bool
changed
whether the interface was changed

Sample:
True
msg
string
always
human-readable report of success or failure

Sample:
interface bond0 config updated


Status

This module is flagged as deprecated and will be removed in version { deprecated[‘removed_in’] | default(‘’) | string | convert_symbols_to_format }@. For more information see DEPRECATED.

Author

  • Cumulus Networks (@CumulusNetworks)

Hint

If you notice any issues in this documentation you can edit this document to improve it.