956351629f
* Don't delete the OVS bridge specified, as it will already be deleted when the role is called. * Clarify the behaviour of the role for each value of `cmd` in the README. * Succintify main.yml.
1.4 KiB
1.4 KiB
Veth Pair
This role manages a veth pair. Actions:
-
If
veth_pair_stateispresent, it will create the veth pair and plug one end into the specified OVS bridge. Ifveth_pair_plug_into_sourceis enabled, it will also plug the other end into/from a source Linux bridge. -
If
veth_pair_stateisabsent, it will ensure the veth pair does not exist; ifveth_pair_plug_into_sourceis 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. If
veth_pair_plug_into_source is enabled, the command brctl must also be
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 ifveth_pair_plug_into_sourceis 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_bridgemust also be specified. Default isfalse.veth_pair_state: Whether or not the veth pair should exist. Choose frompresentorabsent. Default ispresent.