Files
computer-playbook/roles/sys-ctl-rpr-btrfs-balancer
Kevin Veen-Birkenbach 23353ac878 infra(sys-service): centralize async control + pre-deploy backup safeguard
- Added MODE_BACKUP to trigger backup before the rest of the deployment

- sys-ctl-bkp-docker-2-loc: force linear sync and force flush when MODE_BACKUP is true

- Unified name resolution via system_service_name across handlers and tasks

- Introduced system_service_force_linear_sync and system_service_force_flush (rename from system_force_flush)

- Drive async/poll via system_service_async/system_service_poll using omit when disabled

- Propagated per-role overrides (cleanup, repair, cert tasks) for clarity and safety

- Minor formatting and consistency cleanups

Why: Ensure the backup runs before the deployment routine to safeguard data integrity.

Refs: Conversation https://chatgpt.com/share/68de4c41-b6e4-800f-85cd-ce6949097b5e
Signed-off-by: Kevin Veen-Birkenbach <kevin@veen.world>
2025-10-02 11:58:23 +02:00
..

System Btrfs Auto Balancer

Description

This role automates the management and balancing of Btrfs file systems. It clones the latest version of the auto-btrfs-balancer repository and configures a systemd service and timer to run the balancing script automatically.

Overview

Optimized for automated file system management, this role:

  • Clones the auto-btrfs-balancer repository.
  • Configures a systemd service to run the balancing script.
  • Integrates a systemd timer for regular execution.
  • Notifies via systemd in case of errors during the balancing process.

Purpose

The primary purpose of this role is to maintain optimal performance of Btrfs file systems by automating balancing tasks, ensuring efficient storage allocation and performance.

Features

  • Repository Cloning: Automatically fetches the latest auto-btrfs-balancer repository.
  • Service Configuration: Sets up a systemd service for running the balancing script.
  • Timer Integration: Schedules the balancing process via a systemd timer.
  • Error Notification: Notifies on failure using sys-ctl-alm-compose.