computer-playbook/roles/sys-ctl-bkp-docker-2-loc
Kevin Veen-Birkenbach efa68cc1e0
sys-ctl: make service file generation deterministic and simplify ignore logic
- Added '| sort' to all service group lists and backup routine lists to ensure
  deterministic ordering and stable checksums across Ansible runs.
- Adjusted systemctl templates to use a single service variable
  ('SYS_SERVICE_BACKUP_RMT_2_LOC') instead of rejecting dynamic list entries,
  making the ignore logic simpler and more predictable.
- Fixed minor whitespace inconsistencies in Jinja templates to avoid
  unnecessary changes.

This change was made to prevent spurious 'changed' states in Ansible caused by
non-deterministic list order and to reduce complexity in service definitions.

See discussion: https://chatgpt.com/share/68a74c20-6300-800f-a44e-da43ae2f3dea
2025-08-21 18:43:17 +02:00
..

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:

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.