Forge Home

cumulus_interfaces

Configures Cumulus Linux interfaces

13,699 downloads

4,570 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.2.5 (latest)
  • 1.2.4 (deleted)
  • 1.2.3
released Mar 13th 2019
This version is compatible with:
  • CumulusLinux

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'odivlad-cumulus_interfaces', '1.2.5'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add odivlad-cumulus_interfaces
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install odivlad-cumulus_interfaces --version 1.2.5

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

odivlad/cumulus_interfaces — version 1.2.5 Mar 13th 2019

This is a fork of dead official Cumulus Network repo (http://github.com/cumulusNetworks/cumulus-cl-interfaces-puppet).

Actual puppet forge page: https://forge.puppet.com/odivlad/cumulus_interfaces

Feel free to send patches to http://github.com/odivlad/cumulus-cl-interfaces-puppet/

cumulus_interface

Table of Contents

Overview

This module provides three resource types that can configure most types of interfaces available on Cumulus Linux.

Module Description

The module consists of three resources types:

cumulus_interface

This resource type configures a network interface using ifupdown2. The configuration for the interface is written to a file in the interface configuration file directory. This resource type does not configure VXLAN, bond, or bridge interfaces.

For bridge configuration use the cumulus_bridge module.

For bond configuration use the cumulus_bond module.

cumulus_bond

This resource type configures a network bond using ifupdown2. The configuration for the interface is written to a file in the interface configuration file directory.

cumulus_bridge

This resource type configures a bridge using ifupdown2. The configuration for the interface is written to a file in the interface configuration file directory.

Setup

What cumulus_interface affects

  • This module affects the configuration files located in the interfaces folder and managed by ifupdown2. By default this is /etc/network/interfaces.d.

  • You need to add source /etc/network/interfaces.d/* to /etc/network/interfaces to make use of the new files.

  • To activate the changes, run /sbin/ifreload -a.

NOTE: Reloading the interface configuration is not disruptive if there is no change in the configuration.

Usage

cumulus_interface Examples:

Loopback interface and the management interface eth0 using DHCP:

cumulus_interface { 'lo':
  addr_method => 'loopback',
}

cumulus_interface { 'eth0':
  addr_method => 'dhcp',
}

cumulus_interface { 'eth0':
  ipv4    => ['192.168.0.10/24'],
  gateway => '192.168.0.1',
}

swp33 as a 1GbE port with a single IPv4 address:

cumulus_interface { 'swp33':
  ipv4  => ['10.30.1.1/24'],
  speed => 1000,
}

peerlink.4094, a bond sub-interface, as the CLAG peer interface:

cumulus_interface { 'peerlink.4094':
  ipv4          => ['10.100.1.0/31'],
  clagd_enable  => true,
  clagd_peer_ip => '10.100.1.1/31',
  clagd_sys_mac => '44:38:39:ff:20:94',
}

cumulus_bond Examples:

Bond named peerlink with the interfaces swp1 and swp2 as bond members:

cumulus_bond { 'peerlink':
  slaves => ['swp1-2'],
}

Bond named bond0 with the interfaces swp3 and swp4 as bond members, the minimum link count is set to 2 and the CLAG ID is set:

cumulus_bond { 'bond0':
  slaves    => ['swp3-4'],
  min_links => 2,
  clag_id   => 1,
}

cumulus_bridge Examples:

Default ("traditional") bridge driver:

cumulus_bridge { 'br10':
  ports            => ['swp11-12.1', 'swp32.1'],
  ipv4             => ['10.1.1.1/24', '10.20.1.1/24'],
  ipv6             => ['2001:db8:abcd::/48'],
  alias_name       => 'classic bridge',
  mtu              => 9000,
  mstpctl_treeprio => 4096,
}

VLAN-aware bridge:

cumulus_bridge { 'bridge':
  vlan_aware       => true,
  ports            => ['peerlink', 'downlink', 'swp10'],
  vids             => ['1-4094'],
  pvid             => 1,
  stp              => true,
  mstpctl_treeprio => 4096,
}

Reference

###Types

cumulus_interface

####Parameters

  • name - Identifier for the interface.
  • ipv4 - Array of IPv4 addresses to be applied to the interface.
  • ipv6 - Array of IPv6 addresses to be applied to the interface.
  • gateway - String of default gateway to be added with the interface.
  • alias_name - Interface alias.
  • addr_method - Address assignment method, dhcp or loopback. Default is empty (no address method is set).
  • speed - The interface link speed.
  • mtu - The interface Maximum Transmission Unit (MTU).
  • virtual_ip - VRR virtual IP address.
  • virtual_mac - VRR virtual MAC address.
  • vids - Array of VLANs to be configured for a VLAN-aware trunk interface.
  • pvid - Native VLAN for a VLAN-aware trunk interface.
  • location - Location of the configuration snippets directory. Default is /etc/network/interfaces.d/.
  • mstpctl_portnetwork - Enables bridge assurance on a VLAN-aware trunk.
  • mstpctl_bpduguard - Enables BPDU guard on a VLAN-aware trunk.
  • mstpctl_portadminedge - Enables admin edgeport
  • vlan_raw_device - Vlan-aware bridge name, which is a master device for this interface.
  • vlan_id - Interface's vlan id in vlan-aware bridge

The following CLAG-related attributes are also available. If CLAG is enabled, you must specify clagd_enable,clagd_priority, clagd_peer_id and clagd_sys_mac:

  • clagd_enable - Enable the clagd daemon.
  • clagd_priority - Set the CLAG priority for this switch.
  • clagd_peer_id - Address of the CLAG peer switch.
  • clagd_sys_mac - CLAG system MAC address. The MAC address must be identical on both CLAG peers.
  • clagd_args - Any additional arguments to be passed to the clagd deamon.
  • clagd_backup_ip - backup IP address to communicate with the peer switch, in case the peer link is down but the peer switch is up.
  • clagd_vxlan_anycast_ip - VXLAN anycast IP for CLAG.

cumulus_bond

#####Parameters

  • name - Identifier for the bond interface.
  • slaves - Bond members.
  • min_links - Minimum number of slave links for the bond to be considered up. Default is 1.
  • mode - Bond mode. Default is 802.3ad.
  • miimon - MII link monitoring interval. Default is 100.
  • xmit_hash_policy - TX hashing policy. Default is layer3+4.
  • lacp_rate - LACP bond rate. Default is 1 (fast LACP timeout).
  • ipv4 - Array of IPv4 addresses to be applied to the interface.
  • ipv6 - Array of IPv6 addresses to be applied to the interface.
  • gateway - String of default gateway to be added with the interface.
  • alias_name - Interface alias.
  • addr_method - Address assignment method. May be dhcp or empty. Default is empty (no address method is set).
  • mtu - The interface Maximum Transmission Unit (MTU).
  • virtual_ip - VRR virtual IP address.
  • virtual_mac - VRR virtual MAC address.
  • vids - Array of VLANs to be configured for a VLAN-aware trunk interface.
  • pvid - Native VLAN for a VLAN-aware trunk interface.
  • location - Location of the configuration snippets directory. Default is /etc/network/interfaces.d/.
  • mstpctl_portnetwork - Enable bridge assurance on a VLAN-aware trunk.
  • mstpctl_bpduguard - Enable BPDU guard on a VLAN-aware trunk.
  • mstpctl_portadminedge - Enables admin edgeport
  • clag_id - Define which bond is in the CLAG. The ID must be the same on both CLAG peers.
  • lacp_bypass_allow - Enable LACP bypass, valid options are 0 or 1.
  • lacp_bypass_period - Period for enable lacp_bypass.
  • lacp_bypass_priority - Array of ports and priority
  • lacp_bypass_all_active - Activate all interfaces for bypass: 0 or 1.
  • use_carrier - Specifies whether or not miimon should use MII or Ethtool ioctls. Default is 1.
  • vlan_raw_device - Vlan-aware bridge name, which is a master device for this interface.
  • vlan_id - Interface's vlan id in vlan-aware bridge

cumulus_bridge

Parameters:
  • name - Identifier for the bridge interface.
  • ipv4 - Array of IPv4 addresses to be applied to the interface.
  • ipv6 - Array of IPv6 addresses to be applied to the interface.
  • gateway - String of default gateway to be added with the interface.
  • alias_name - Interface alias.
  • addr_method - Address assignment method. May be dhcp or empty. Default is empty (no address method is set).
  • mtu - The interface Maximum Transmission Unit (MTU).
  • stp - Enable spanning tree. Default is true.
  • mstpctl_treeprio - Bridge tree root priority. Must be a multiple of 4096.
  • vlan_aware - Use the VLAN-aware bridge driver. Default is false.
  • virtual_ip - VRR virtual IP address.
  • virtual_mac - VRR virtual MAC address.
  • vids - Array of VLANs to be configured for a VLAN-aware trunk interface.
  • pvid - Native VLAN for a VLAN-aware trunk interface.
  • location - Location of the configuration snippets directory. Default is /etc/network/interfaces.d/.
  • mcsnoop - Enables IGMP/MLD Snooping on the bridge. Default is 0.

Limitations

This module only works on Cumulus Linux.

The puppet resource command for cumulus_interface, cumulus_bond and cumulus_bridge is currently not supported. It may be added in a future release.

Development

  1. Fork it.
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Commit your changes (git commit -am 'Add some feature').
  4. Push to the branch (git push origin my-new-feature).
  5. Create new Pull Request.

Cumulus Linux

Cumulus Networks Icon

Cumulus Linux is a software distribution that runs on top of industry-standard networking hardware. It enables the latest Linux applications and automation tools on networking gear while delivering new levels of innovation and flexibility to the data center.

For further details, please see http://cumulusnetworks.com.