tenks/ansible/roles/veth-pair
Will Szumski 602fdfa26b Remove dependency on bridge-utils
bridge-utils is considered legacy and many distributions do
not ship it as default.

Change-Id: Id2f9d779d12a5135d7d7e7a4783c6f3a0c8647ca
Story: 2004302
Task: 27861
2018-11-08 15:15:30 +00:00
..
defaults Add 'teardown' action to veth-pair role 2018-09-10 14:19:06 +00:00
tasks Remove dependency on bridge-utils 2018-11-08 15:15:30 +00:00
README.md Remove dependency on bridge-utils 2018-11-08 15:15:30 +00:00

README.md

Veth Pair

This role manages a veth pair. Actions:

  • If veth_pair_state is present, it will create the veth pair and plug one end into the specified OVS bridge. If veth_pair_plug_into_source is enabled, it will also plug the other end into/from a source Linux bridge.

  • If veth_pair_state is absent, it will ensure the veth pair does not exist; if veth_pair_plug_into_source is also enabled, it will ensure the veth pair is not plugged into the source bridge.

Requirements

The host should have the ip and ovs-vsctl commands accessible.

Role Variables

  • veth_pair_ovs_link_name: The name to give the veth link that plugs into the OVS bridge.
  • veth_pair_ovs_bridge: The name of the OVS bridge to plug into.
  • veth_pair_source_link_name: The name to give the veth link that plugs into the source device.
  • veth_pair_source_bridge: The name of the source Linux bridge to plug into. Must be specified if and only if veth_pair_plug_into_source is enabled.
  • veth_pair_plug_into_source: Whether or not to plug the source end of the veth pair into a Linux bridge. If enabled, veth_pair_source_bridge must also be specified. Default is false.
  • veth_pair_state: Whether or not the veth pair should exist. Choose from present or absent. Default is present.