W3cubDocs

/Ansible

openvswitch_bridge - Manage Open vSwitch bridges

New in version 1.4.

Synopsis

Manage Open vSwitch bridges

Requirements (on host that executes module)

  • ovs-vsctl

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

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_bridge_module.html