Skip to content

Latest commit

 

History

History
236 lines (203 loc) · 7.63 KB

openvswitch.openvswitch.openvswitch_port_module.rst

File metadata and controls

236 lines (203 loc) · 7.63 KB
Raw

openvswitch.openvswitch.openvswitch_port

Manage Open vSwitch ports

Version added: 1.0.0

Synopsis

  • Manage Open vSwitch ports

Requirements

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

  • ovs-vsctl

Parameters

Parameter Choices/Defaults Comments
bridge
string / required
Name of bridge to manage
database_socket
string
Path/ip to datbase socket to use
Default path is used if not specified
Path should start with 'unix:' prefix
external_ids
dictionary
Default:
{}
Dictionary of external_ids applied to a port.
port
string / required
Name of port to manage on the bridge
set
list / elements=string
Set multiple properties on a port.
state
string
    Choices:
  • present ←
  • absent
Whether the port should exist
tag
string
VLAN tag for this port. Must be a value between 0 and 4095.
timeout
integer
Default:
5
How long to wait for ovs-vswitchd to respond

Examples

# Creates port eth2 on bridge br-ex
- openvswitch.openvswitch.openvswitch_port:
    bridge: br-ex
    port: eth2
    state: present

# Creates port eth6
- openvswitch.openvswitch.openvswitch_port:
    bridge: bridge-loop
    port: eth6
    state: present
    set: Interface eth6

# Creates port vlan10 with tag 10 on bridge br-ex
- openvswitch.openvswitch.openvswitch_port:
    bridge: br-ex
    port: vlan10
    tag: 10
    state: present
    set: Interface vlan10

# Assign interface id server1-vifeth6 and mac address 00:00:5E:00:53:23
# to port vifeth6 and setup port to be managed by a controller.
- openvswitch.openvswitch.openvswitch_port:
    bridge: br-int
    port: vifeth6
    state: present
  args:
    external_ids:
      iface-id: '{{ inventory_hostname }}-vifeth6'
      attached-mac: 00:00:5E:00:53:23
      vm-id: '{{ inventory_hostname }}'
      iface-status: active

# Plugs port veth0 into brdige br0 for database for OVSDB instance
# with socket unix:/opt/second_ovsdb.sock
- openvswitch.openvswitch.openvswitch_port:
    bridge: br0
    port: veth0
    state: present
    database_socket: unix:/opt/second_ovsdb.sock

Status

Authors

  • David Stygstra (@stygstra)