systemd
The systemd
module streamlines the management of systemd units during image building. Units are divided into system
and user
categories, with system
units managed directly using systemctl
and user
units using systemctl --global
. You can specify which units to enable/disable or unmask/mask under each category.
You can also include your systemd units to be copied into system directories into these locations,
depending if your unit is system
or user
based:
config/systemd/system
config/systemd/user
Those units are then copied into these folders (depending on unit base):
/usr/lib/systemd/system
/usr/lib/systemd/user
Supported management operations are enabling, disabling, masking and unmasking.
Example configuration
type: systemdsystem: enabled: - example.service # Enabled (runs on system boot) disabled: - example.target # Disabled (does not run on system boot, unless other unit strictly requires it) masked: - example.service # Masked (does not run on system boot, under any circumstances) unmasked: - example.service # Unmasked (runs on system boot, even if previously masked)user: enabled: - example.timer # Enabled (runs for the user) disabled: - example.service # Disabled (does not run for the user, unless other unit strictly requires it) masked: - example.service # Masked (does not run for the user, under any circumstances) unmasked: - example.service # Unmasked (runs for the user, even if previously masked)