Resource Type: vs_port

Defined in:
lib/puppet/type/vs_port.rb
Providers:
ovs
ovs_redhat

Overview

A Virtual Switch Port

Properties

  • bond_mode (defaults to: "")

    Interface bonding mode for this port.

    Possible values are ‘active-backup’, ‘balance-tcp’ or ‘balance-slb’. By default no bonding mode is set (bond_mode=”).

    Supported values:
    • active-backup
    • balance-tcp
    • balance-slb
    • ""
  • ensure (defaults to: present)

    The basic property that the resource should be in.

    Supported values:
    • present
    • absent
  • interface

    The interfaces to attach to the bridge. Defaults to the interface with the same name as the port.

  • interface_type (defaults to: system)

    The type of network interface connected to this port.

    Supported types are ‘system’, ‘internal’ and ‘tap’. Currently the interface configuration required for tunnel ports is not supported.

    Currently all interfaces on a port are set to the same type. Bonding configurations with different types on the same port are not supported.

    Supported values:
    • system
    • internal
    • tap
  • lacp (defaults to: off)

    LACP configuration for this port.

    Possible values are ‘active’, ‘passive’ or ‘off’. The default is ‘off’.

    Supported values:
    • active
    • passive
    • off
  • lacp_time (defaults to: "")

    The LACP timing which should be used on this Port.

    Possible values are ‘slow’ and ‘fast’. The default is ‘slow’.

    When configured to be fast LACP heartbeats are requested at a rate of once per second causing connectivity problems to be detected more quickly. In slow mode, heartbeats are requested at a rate of once every 30 seconds.

    Supported values:
    • fast
    • slow
    • ""
  • vlan_mode (defaults to: "")

    VLAN mode for this port.

    Possible values are ‘access’, ‘native-tagged’, ‘native-untagged’ or ‘trunk’. By default no mode is set (vlan_mode=”).

    Supported values:
    • access
    • native-tagged
    • native-untagged
    • trunk
    • ""
  • vlan_tag (defaults to: "")

    VLAN id for this port.

    For an access port this is the ports implicit VLAN id, for a for a ‘native_tagged’ of ‘native_untagged’ port it’s the ports native VLAN. By default no VLAN id is assigned (vlan_tag=”).

  • vlan_trunks (defaults to: [])

    Allowed VLAN ids on this port.

    This parameter is only meaningful for no access ports. Ports in native-tagged or native-untagged mode always allow their native VLAN id.

    VLAN ids may be specified as a list of integers. Defaults to [].

Parameters

  • bridge

    The bridge to attach to

  • fail_mode (defaults to: standalone)

    Set fail mode for this port.

    Possible values are ‘standalone’ or ‘secure’. By default standalone is used.

    Supported values:
    • standalone
    • secure
  • port

    Name of the port.

  • provider

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

Features

  • bonding —

    The provider supports bonded interfaces