W3cubDocs

/Ansible

openvswitch_port - Manage Open vSwitch ports

New in version 1.4.

Synopsis

Manage Open vSwitch ports

Requirements (on host that executes module)

  • ovs-vsctl

Options

parameter required default choices comments
bridge
yes
Name of bridge to manage
external_ids
(added in 2.0)
no
Dictionary of external_ids applied to a port.
port
yes
Name of port to manage on the bridge
set
(added in 2.0)
no None
Set a single property on a port.
state
no present
  • present
  • absent
Whether the port should exist
tag
(added in 2.2)
no
VLAN tag for this port
timeout
no 5
How long to wait for ovs-vswitchd to respond

Examples

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

# Creates port eth6 and set ofport equal to 6.
- openvswitch_port: bridge=bridge-loop port=eth6 state=present
                    set="Interface eth6 ofport_request=6"

# Creates port vlan10 with tag 10 on bridge br-ex
- openvswitch_port: bridge=br-ex port=vlan10 tag=10 state=present
                    set="Interface vlan10 type=internal"

# 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_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"

This is an Extras Module

For more information on what this means please read Extras Modules

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/openvswitch_port_module.html