mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-09-11 21:07:16 +02:00

Files

Kevin Veen-Birkenbach 91ce097a0a feat(sys-service): migrate cleanup/backup services to generic units; harden disk-space cleanup

Services: add SYS_SERVICE_CLEANUP_BACKUPS and SYS_SERVICE_CLEANUP_DISC_SPACE in group vars.

sys-ctl-bkp-docker-2-loc: switch to sys-service; add ExecStartPre lock; ExecStartPost triggers backup cleanup; OnFailure → cleanup-failed; fix shell quoting.

sys-ctl-cln-bkps: switch to sys-service; pass CLI args via ExecStart; add ExecStartPre lock; set OnFailure; copy files; remove role-specific service template.

sys-ctl-cln-disc-space: switch to sys-service; enable timer; set OnFailure; provide ExecStart/ExecStartPre; copy files; remove role-specific service template.

script.sh (disc-space): non-interactive docker exec; consistent threshold message (use parameter); guard docker/pacman via command checks; robust container check; fix typo; use POSIX '='.

svc-opt-keyboard-color: minor formatting cleanup.

sys-ctl-hlth-disc-space: chain OnFailure to cleanup-disc-space service.

Context: ChatGPT conversation (Sep 10, 2025, Europe/Berlin) — https://chatgpt.com/share/68c1982e-bdc8-800f-bf13-a8b9f084f90e

2025-09-10 17:24:56 +02:00

filter_plugins

Implement filter checks: ensure all defined filters are used and remove dead code

2025-09-01 11:47:51 +02:00

README.md

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.