kpfleming.systemd_networkd.dummy role – Manages systemd-networkd dummy virtual 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.dummy.

Entry point main – Manages systemd-networkd dummy virtual network devices.

Synopsis

  • This role will create (or update) one item in /etc/systemd/network for each specified dummy: a .netdev file for the dummy device

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

Parameters

Parameter

Comments

dummies

list / elements=dictionary / required

Attributes of the dummy devices to be managed.

match

dictionary

Matching attributes of the 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 dummy 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: ""