Documentation

openvswitch_bridge - Manage Open vSwitch bridges

New in version 1.4.

Synopsis

  • Manage Open vSwitch bridges

Options

parameter required default choices comments
bridge
 yes
Name of bridge or fake bridge to manage
external_ids
(added in 2.0)
 no None
A dictionary of external-ids. Omitting this parameter is a No-op. To clear all external-ids pass an empty value.
fail_mode
(added in 2.0)
 no None
  • secure
  • standalone
Set bridge fail-mode. The default value (None) is a No-op.
parent
(added in 2.3)
 no None
Bridge parent of the fake bridge to manage
set
(added in 2.3)
 no None
Set a single property on a bridge.
state
 no present
  • present
  • absent
Whether the bridge should exist
timeout
 no 5
How long to wait for ovs-vswitchd to respond
vlan
(added in 2.3)
 no None
The VLAN id of the fake bridge to manage (must be between 0 and 4095)

Examples

# Create a bridge named br-int
- openvswitch_bridge:
    bridge: br-int
    state: present

# Create a fake bridge named br-int within br-parent on the VLAN 405
- openvswitch_bridge:
    bridge: br-int
    parent: br-parent
    vlan: 405
    state: present

# Create an integration bridge
- openvswitch_bridge:
    bridge: br-int
    state: present
    fail_mode: secure
  args:
    external_ids:
      bridge-id: br-int

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

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