mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-08-26 21:45:20 +02:00

History

refactor: improve service handling and introduce MODE_ASSERT

- Improved get_service_name filter plugin (clearer suffix handling, consistent var names).
- Added MODE_ASSERT flag to optionally execute validation/assertion tasks.
- Fixed systemd unit handling: consistent use of %I instead of %i, correct escaping of instance names.
- Unified on_failure behavior and alarm composer scripts.
- Cleaned up redundant logging, handlers, and debug config.
- Strengthened sys-service template resolution with assert (only active when MODE_ASSERT).
- Simplified timer and suffix handling with get_service_name filter.
- Hardened sensitive tasks with no_log.
- Added conditional asserts across roles (Keycloak, DNS, Mailu, Discourse, etc.).

These changes improve consistency, safety, and validation across the automation stack.

Conversation: https://chatgpt.com/share/68a4ae28-483c-800f-b2f7-f64c7124c274

2025-08-19 19:02:52 +02:00

config

Optimized svc-bkp-loc-2-usb

2025-07-15 20:29:01 +02:00

files

Refactor systemctl services and timers

2025-08-18 21:22:16 +02:00

handlers

refactor(systemd-services): migrate SYS_SERVICE_SUFFIX usage to get_service_name filter

2025-08-18 22:24:33 +02:00

README.md

Backup to USB

Description

This Ansible role automates backups to a removable USB device on Arch Linux systems. It ensures that a custom Python backup script is deployed, the necessary systemd units are configured, and backups are triggered whenever the specified USB mount point becomes available.

Overview

Designed for Arch Linux, this role validates configuration variables (mount, target, source), installs the backup script, generates a systemd service, and sets up a corresponding mount unit. When the USB device is mounted, the service runs the script to synchronize files from the source directory to the USB target, preserving previous snapshots via hard links.

Purpose

The purpose of this role is to provide a reliable, idempotent solution for local backups to a swappable USB drive. By automating the entire workflow—from variable checks and script deployment to service orchestration and snapshot management—it reduces manual intervention and integrates seamlessly with other Infinito.Nexus roles for comprehensive system automation.

Features

Configuration Validation: Fails early if any of backup_to_usb_mount, backup_to_usb_target, or backup_to_usb_source is empty.
Script Deployment: Copies the svc-bkp-loc-2-usb.py backup script to the target path with correct ownership and permissions.
Systemd Integration: Generates and installs a systemd mount unit for the USB device and a oneshot service that triggers backup upon mount.
Snapshot Backups: Uses rsync --link-dest to create incremental snapshots and preserve previous versions without duplicating unchanged files.
Idempotent Runs: Ensures tasks only run when needed and leverages Ansible’s assert and state management for consistent behavior.
Service Reload Handlers: Automatically reloads the systemd service when template changes occur.

Credits

Developed and maintained by Kevin Veen-Birkenbach. Visit veen.world for more information.

Part of the Infinito.Nexus Project License: Infinito.Nexus NonCommercial License

README.md Unescape Escape