Kevin Veen-Birkenbach
26b392ea76
- Swap role includes: sys-systemctl → sys-service in all roles
- Rename variables everywhere: systemctl_* → system_service_* (incl. systemctl_id → system_service_id)
- Templates: ExecStart now uses {{ system_service_script_exec }}; add optional RuntimeMaxSec via SYS_SERVICE_DEFAULT_RUNTIME
- Move SYS_SERVICE defaults into roles/sys-service/defaults (remove SYS_SERVICE_ALL_ENABLED & SYS_SERVICE_DEFAULT_STATE from group_vars/07_services.yml)
- Tidy group_vars/all/08_timer.yml formatting
- Introduce roles/sys-daemon:
- default manager timeouts (timeouts.conf)
- optional purge of /etc/systemd/system.conf.d
- validation via systemd-analyze verify
- handlers for daemon-reload & daemon-reexec
- Refactor sys-timer to system_service_* variables (docs and templates updated)
- Move filter_plugins/filetype.py under sys-service
- Update meta/README to point to official systemd docs
- Touch many roles (backup/cleanup/health/repair/certs/nginx/csp/wireguard/ssd-hdd/keyboard/update-docker/alarm compose/email/telegram/etc.) to new naming
BREAKING CHANGE:
- Role path/name change: use `sys-service` instead of `sys-systemctl`
- All `systemctl_*` vars are now `system_service_*` (e.g., on_calendar, state, timer_enabled, script_exec, id)
- If you have custom templates, adopt RuntimeMaxSec and new variable names
Chat context: https://chatgpt.com/share/68a47568-312c-800f-af3f-e98575446327
Backup Docker to Local
Description
This Ansible role automates the process of backing up Docker volumes to a local folder. It pulls the backup-docker-to-local, installs required software, configures systemd services for both standard and "everything" backup modes, and seeds backup database entries as needed.
Overview
Optimized for Archlinux, this role ensures that Docker volume backups are performed reliably with minimal manual intervention. It integrates with several dependent roles to verify backup success and manage related tasks, including:
- sys-svc-directory-validator – Validates backup directories.
- sys-ctl-cln-faild-bkps – Cleans up unsuccessful backup attempts.
- sys-timer – Schedules recurring backup tasks.
- sys-bkp-provider – Manages backup sources.
- sys-lock – Ensures coordinated maintenance operations.
Purpose
Backup Docker Volumes to Local is a comprehensive solution that leverages rsync to create incremental backups of Docker volumes, providing seamless recovery for both file and database data. Ideal for ensuring the integrity and security of your container data, this role sets up the necessary environment to safeguard your Docker volumes.
Features
- Required Software Installation: Installs necessary packages (e.g., lsof, python-pandas) via pacman.
- Git Repository Pull: Automatically pulls the latest version of the backup-docker-to-local.
- Systemd Service Configuration: Deploys and reloads two systemd service templates to manage backup tasks.
- Database Seeding: Includes tasks to seed and manage a backup database (
databases.csv) for tracking backup details. - Dependency Integration: Works in conjunction with the dependent roles listed above to verify and manage backups.