From abdddc0d42a3b063161ed533fb2ffa14c4cb7e45 Mon Sep 17 00:00:00 2001
From: Kevin Veen-Birkenbach <kevin@veen.world>
Date: Fri, 14 Mar 2025 13:36:44 +0100
Subject: [PATCH] Optimized .mds and meta/main.yml for backups-provider

---
 roles/backups-provider/README.md     | 43 +++++++++++++++++++++-------
 roles/backups-provider/meta/main.yml | 28 ++++++++++++++++--
 2 files changed, 59 insertions(+), 12 deletions(-)

diff --git a/roles/backups-provider/README.md b/roles/backups-provider/README.md
index f7d6d94b..ac16a480 100644
--- a/roles/backups-provider/README.md
+++ b/roles/backups-provider/README.md
@@ -1,12 +1,35 @@
-# role backups-provider-host
+# Backups Provider
 
-## todo
-- add full system backup
+## Description
 
-## see
-- https://www.thegeekstuff.com/2012/03/chroot-sftp-setup/
-- https://serverfault.com/questions/135618/is-it-possible-to-use-rsync-over-sftp-without-an-ssh-shell
-- https://forum.duplicati.com/t/sftp-ssh-backups-to-a-linux-server-with-added-security/7334
-- https://serverfault.com/questions/287578/trying-to-setup-chrootd-rsync
-- http://ramblings.narrabilis.com/using-rsync-with-ssh
-- https://wiki.archlinux.org/index.php/rsync
+This role sets up and manages the host as a backup provider. It establishes the framework for secure backup operations and integrates with other roles to facilitate reliable backup data management.
+
+## Overview
+
+Optimized for automated backup processes, this role:
+- Configures the host to provide backup services.
+- Integrates seamlessly with the [backups-provider-user](../backups-provider-user/README.md) and [cleanup-backups-timer](../cleanup-backups-timer/README.md) roles.
+- Lays the foundation for secure and extensible backup operations.
+
+## Purpose
+
+The primary purpose of this role is to enable the host to act as a backup provider, ensuring that backup data is securely stored and managed. Future enhancements will include full system backup capabilities.
+
+## Features
+
+- **Backup Framework:** Establishes the necessary configuration for hosting backups.
+- **Role Integration:** Works in conjunction with related roles to provide a comprehensive backup solution.
+- **Extensibility:** Designed to accommodate future features, such as full system backups.
+
+## Todo
+
+- Add full system backup functionality.
+
+## See Also
+
+- [Chroot SFTP Setup](https://www.thegeekstuff.com/2012/03/chroot-sftp-setup/)
+- [Rsync over SFTP without an SSH Shell](https://serverfault.com/questions/135618/is-it-possible-to-use-rsync-over-sftp-without-an-ssh-shell)
+- [SFTP SSH Backups with Added Security](https://forum.duplicati.com/t/sftp-ssh-backups-to-a-linux-server-with-added-security/7334)
+- [Chrootd Rsync Setup](https://serverfault.com/questions/287578/trying-to-setup-chrootd-rsync)
+- [Using Rsync with SSH](http://ramblings.narrabilis.com/using-rsync-with-ssh)
+- [Rsync on Arch Linux](https://wiki.archlinux.org/index.php/rsync)
diff --git a/roles/backups-provider/meta/main.yml b/roles/backups-provider/meta/main.yml
index ef0085c3..28d56040 100644
--- a/roles/backups-provider/meta/main.yml
+++ b/roles/backups-provider/meta/main.yml
@@ -1,3 +1,27 @@
+---
+galaxy_info:
+  author: "Kevin Veen-Birkenbach"
+  description: "Configures the host as a backup provider to facilitate secure backup operations."
+  license: "CyMaIS NonCommercial License (CNCL)"
+  license_url: "https://s.veen.world/cncl"
+  company: |
+    Kevin Veen-Birkenbach
+    Consulting & Coaching Solutions
+    https://www.veen.world
+  min_ansible_version: "2.9"
+  platforms:
+    - name: Linux
+      versions:
+        - all
+  galaxy_tags:
+    - backups
+    - provider
+    - backup
+    - automation
+    - security
+  repository: "https://s.veen.world/cymais"
+  issue_tracker_url: "https://s.veen.world/cymaisissues"
+  documentation: "https://s.veen.world/cymais"
 dependencies:
-- backups-provider-user
-- cleanup-backups-timer
+  - backups-provider-user
+  - cleanup-backups-timer