Resource Type: cumulus_interface

Defined in:

lib/puppet/type/cumulus_interface.rb

Providers:

cumulus

Overview

Config front panel ports, SVI, loopback, mgmt ports on Cumulus Linux. To configure a bond use the cumulus_bond module. To configure a bridge interface use the cumulus_bridge module.

Properties

• ensure

  The basic property that the resource should be in.

  Supported values:

  • outofsync
  • insync

Parameters

• access

  For bridging, a type of port that is non-trunking. For dot1x, an IP source address or network that will be serviced. (An integer from 1 to 4094)

• addr_method

  address assignment method

  Supported values:

  • dhcp
  • loopback
• alias_name

  interface description

• allow_untagged

  A bridge port interface may allow untagged packets

• clagd_args

  additional Clag parameters. must be configured with other clagd parameters. It is optional

• clagd_backup_ip

  Specify a backup link for your peers in the event that the peer link goes down. clagd_enable must be enabled for this config to work

• clagd_enable

  enable CLAG on the interface. Interface must be in vlan \ aware mode. clagd_enable, clagd_peer_ip, clagd_backup_ip, clagd_sys_mac must be configured together

  Supported values:

  • true
  • false
  • yes
  • no
• clagd_peer_ip

  clagd peerlink adjacent port IP. clagd_enable, clagd_peer_ip, clagd_sys_mac and clagd_sys_mac must be configured together

• clagd_priority

  determines which switch is the primary role. The lower priority switch will assume the primary role. Range can be between 0-65535. clagd_priority, requires clagd_enable to be defined

• clagd_sys_mac

  clagd system mac. Must the same across both Clag switches. range should start with 44:38:39:ff. clagd_enable, clagd_peer_ip, clagd_sys_mac, must be configured together

• clagd_vxlan_anycast_ip

  Anycast IP address used with MLAG

• gateway

  default gateway

• ipv4

  list of ipv4 addresses ip address must be in CIDR format and subnet mask included Example: [“10.1.1.1/30”]

• ipv6

  list of ipv6 addresses ip address must be in CIDR format and subnet mask included Example: [“10:1:1::1/127”]

• location (defaults to: /etc/network/interfaces.d)

  location of interface files

• mstpctl_bpduguard

  configures bpdu guard. Ensure that the port is in vlan aware mode

  Supported values:

  • true
  • false
  • yes
  • no
• mstpctl_portadminedge

  configures port adminedge.

  Supported values:

  • true
  • false
  • yes
  • no
• mstpctl_portnetwork

  configures bridge assurance. Ensure that port is in vlan aware mode

  Supported values:

  • true
  • false
  • yes
  • no
• mtu

  link mtu. Can be 1500 to 9000 KBs

• name (namevar)

  interface name

• provider

  The specific backend to use for this ‘cumulus_interface` resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.

• pvid

  vlan transmitted untagged across the link (native vlan)

• speed

  link speed in MB. Example “1000” means 1G

• vids

  list of vlans. Only configured on vlan aware ports

• virtual_ip

  virtual IP component of Cumulus Linux VRR config

• virtual_mac

  virtual MAC component of Cumulus Linux VRR config

• vlan_id

  vlan id

• vlan_raw_device

  vlan raw device

• vrf

  Virtual Routing and Forwarding table name.

• vrf_table

  Virtual Routing and Forwarding table id. Supply ‘auto` to Cumulus Linux auto-assign table id.