openvswitch.openvswitch.openvswitch_bond – Manage Open vSwitch bonds

Note

This plugin is part of the openvswitch.openvswitch collection (version 2.1.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install openvswitch.openvswitch.

To use it in a playbook, specify: openvswitch.openvswitch.openvswitch_bond.

New in version 1.0.0: of openvswitch.openvswitch

Synopsis

  • Manage Open vSwitch bonds and associated options.

Requirements

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

  • ovs-vsctl

Parameters

Parameter Choices/Defaults Comments
bond_downdelay
integer
Number of milliseconds a link must be down to be deactivated to prevent flapping.
bond_mode
string
    Choices:
  • active-backup
  • balance-tcp
  • balance-slb
Sets the bond mode
bond_updelay
integer
Number of milliseconds a link must be up to be activated to prevent flapping.
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.
interfaces
list / elements=string
List of interfaces to add to the bond
lacp
string
    Choices:
  • active
  • passive
  • off
Sets LACP mode
other_config
dictionary
Default:
{}
Dictionary of other_config applied to a port.
port
string / required
Name of port to manage on the bridge
set
list / elements=string
Sets one or more properties on a port.
state
string
    Choices:
  • present ←
  • absent
Whether the port should exist
timeout
integer
Default:
5
How long to wait for ovs-vswitchd to respond in seconds

Examples

- name: Create an active-backup bond using eth4 and eth5 on bridge br-ex
  openvswitch.openvswitch.openvswitch_bond:
    bridge: br-ex
    port: bond1
    interfaces:
      - eth4
      - eth5
    state: present
- name: Delete the bond from bridge br-ex
  openvswitch.openvswitch.openvswitch_bond:
    bridge: br-ex
    port: bond1
    state: absent
- name: Create an active LACP bond using eth4 and eth5 on bridge br-ex
  openvswitch.openvswitch.openvswitch_bond:
    bridge: br-ex
    port: bond1
    interfaces:
      - eth4
      - eth5
    lacp: active
    state: present
# NOTE: other_config values of integer type must be represented
# as literal strings
- name: Configure bond with miimon link monitoring at 100 millisecond intervals
  openvswitch.openvswitch.openvswitch_bond:
    bridge: br-ex
    port: bond1
    interfaces:
      - eth4
      - eth5
    bond_updelay: 100
    bond_downdelay: 100
    state: present
  args:
    other_config:
      bond-detect-mode: miimon
      bond-miimon-interval: '"100"'
- name: Create an active LACP bond using DPDK interfaces
  openvswitch.openvswitch.openvswitch_bond:
    bridge: br-provider
    port: dpdkbond
    interfaces:
      - "0000:04:00.0"
      - "0000:04:00.1"
    lacp: active
    set:
      - "interface 0000:04:00.0 type=dpdk options:dpdk-devargs=0000:04:00.0"
      - "interface 0000:04:00.1 type=dpdk options:dpdk-devargs=0000:04:00.1"
    state: present
- name: Create an active-backup bond using eth4 and eth5 on bridge br-ex in second OVS database
  openvswitch.openvswitch.openvswitch_bond:
    bridge: br-ex
    port: bond1
    interfaces:
      - eth4
      - eth5
    state: present
    database_socket: unix:/opt/second.sock

Authors

  • James Denton (@busterswt)