mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-11-02 03:08:05 +00:00

Files

Kevin Veen-Birkenbach 630fd43382 refactor(services): unify service/timer runtime control and cleanup handling

- Introduce SYS_SERVICE_ALL_ENABLED and SYS_TIMER_ALL_ENABLED runtime flags
- Add SYS_SERVICE_DEFAULT_STATE for consistent default handling
- Ensure all on-failure service names use lowercase software_name
- Load sys-svc-cln-anon-volumes role during Docker cleanup
- Allow forced service refresh when SYS_SERVICE_ALL_ENABLED is true
- Replace ACTIVATE_ALL_TIMERS with SYS_TIMER_ALL_ENABLED
- Use SYS_SERVICE_DEFAULT_STATE in sys-systemctl vars
- Remove redundant MIG build job fail check

Related to service/timer process control refactoring.

2025-08-19 01:27:37 +02:00

filter_plugins

…

handlers

refactor: improve get_service_name suffix handling and handler usage

2025-08-18 22:36:31 +02:00

README.md

sys-systemctl

Utility role to reset/clean up systemd units for a given software stack.
It can install a unit-file remover tool, delete units that match a configured suffix, and reload the systemd daemon. The role is designed to run once per play and is commonly included by other roles (e.g., timer/service roles) to ensure a clean state before (re)deployment.

Overview

When MODE_RESET is enabled, the role will:

Install the configured remover tool/package (via pkgmgr-install).
Remove all unit files that match the configured suffix for the current software.
Reload the systemd daemon to apply changes.

A run-once guard (run_once_sys_systemctl) prevents repeated execution within the same play run.

Features

Idempotent cleanup of systemd unit files based on a suffix.
Pluggable remover tool via UNIT_SUFFIX_REMOVER_PACKAGE.
Daemon reload to immediately apply changes.
Run-once safety across the play to avoid redundant work.

Variables

Variable	Type	Default	Description
`MODE_RESET`	bool	`false`	If `true`, executes the reset/cleanup tasks.
`SYS_SERVICE_SUFFIX`	string	required	Suffix used to identify unit files belonging to the software stack (e.g., `.infinito.nexus`).
`SOFTWARE_NAME`	string	required	Logical software identifier passed to the remover tool.
`UNIT_SUFFIX_REMOVER_PACKAGE`	string	`"unsure"`	Package/command used to remove the unit files. Must provide a CLI compatible with `-s`.

Note: The role expects the remover tool to support a command pattern like:
<UNIT_SUFFIX_REMOVER_PACKAGE> -s '<SOFTWARE_NAME>'
Replace UNIT_SUFFIX_REMOVER_PACKAGE with your actual utility (or wrapper script) that removes all matching unit files.

Tasks Flow

tasks/main.yml
- Includes tasks/01_reset.yml only when MODE_RESET is true.
- Loads utils/run_once.yml once to set run_once_sys_systemctl.
tasks/01_reset.yml
- Installs UNIT_SUFFIX_REMOVER_PACKAGE via pkgmgr-install.
- Executes the remover command to purge unit files for SOFTWARE_NAME / SYS_SERVICE_SUFFIX.
- Runs systemctl daemon-reload.

Dependencies

pkgmgr-install (role): used to install UNIT_SUFFIX_REMOVER_PACKAGE.