kpfleming.systemd_networkd.bridge role – Manages systemd-networkd bridged network devices.

Note

This role is part of the kpfleming.systemd_networkd collection (version 25.9.0).

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 kpfleming.systemd_networkd.

To use it in a playbook, specify: kpfleming.systemd_networkd.bridge.

Entry point main – Manages systemd-networkd bridged network devices.

New in kpfleming.systemd_networkd 25.7.0

Synopsis

  • This role will create (or update) a .netdev file in /etc/systemd/network for each specified bridged device.

  • Detailed descriptions of parameters and their behavior can be found in ‘man systemd.netdev’.

  • Sets fact named ‘systemd_networkd_bridge_changed’ to either true or false to indicate whether any changes were made.

Parameters

Parameter

Comments

bridges

list / elements=dictionary / required

Attributes of the bridge devices to be managed.

bridge

dictionary

Attributes of the bridge device.

ageing_time_sec

integer

Time that MAC addresses will be kept in the forwarding database.

forward_delay_sec

integer

Time spent in ‘listening’ and ‘learning’ before moving to ‘forwarding’ state.

priority

integer

Priority of bridge among its peers.

stp

boolean

Enable Spanning Tree Protocol.

Choices:

  • false

  • true

match

dictionary

Matching attributes of the bridge network device.

system

dictionary

System-specific attributes to be matched.

architecture

string

Match system architecture.

credential

string

Match service credential.

firmware

string

Match system firmware.

host

string

Match hostname or machine ID.

kernel_command_line

string

Match kernel command line option presence.

kernel_version

string

Match kernel version expression.

virtualization

string

Match virtualization type.

name

string / required

Name of the bridge device.

suppress_reload

boolean

Suppress the reloading of systemd-networkd if changes are made.

Choices:

  • false ← (default)

  • true

systemd_root

string

Root path of filesystem containing systemd-networkd configuration files.

Default: ""