From ded892e34378c3675717384decebbf87e3f70039 Mon Sep 17 00:00:00 2001
From: Ahmed Abdelhalim <pm@a14m.dev>
Date: Mon, 22 Jun 2026 16:55:49 +0200
Subject: Add garage to rpi to use as s3-compatible backend for backups

---
 roles/garage/meta/argument_specs.yml | 48 ++++++++++++++++++++++++++++++++++++
 roles/garage/meta/main.yml           | 17 +++++++++++++
 2 files changed, 65 insertions(+)
 create mode 100644 roles/garage/meta/argument_specs.yml
 create mode 100644 roles/garage/meta/main.yml

(limited to 'roles/garage/meta')

diff --git a/roles/garage/meta/argument_specs.yml b/roles/garage/meta/argument_specs.yml
new file mode 100644
index 00000000..a98f9991
--- /dev/null
+++ b/roles/garage/meta/argument_specs.yml
@@ -0,0 +1,48 @@
+---
+argument_specs:
+  main:
+    options:
+      garage_version:
+        type: "str"
+        description: "Garage release version to install"
+        default: "2.3.0"
+      garage_data_dir:
+        type: "str"
+        description: "Directory for Garage object data"
+        default: "/mnt/backup/garage/data"
+      garage_meta_dir:
+        type: "str"
+        description: "Directory for Garage metadata"
+        default: "/mnt/backup/garage/meta"
+      garage_rpc_secret:
+        type: "str"
+        description: "32-byte hex RPC secret shared across nodes"
+        required: true
+      garage_s3_port:
+        type: "str"
+        description: "Port for S3 API"
+        default: "3900"
+      garage_admin_port:
+        type: "str"
+        description: "Port for admin API"
+        default: "3903"
+      garage_rpc_bind_addr:
+        type: "str"
+        description: "RPC bind address"
+        default: "127.0.0.1:3901"
+      garage_capacity:
+        type: "str"
+        description: "Storage capacity for this node (e.g. 100G, 200G)"
+        default: "100G"
+      garage_bucket:
+        type: "str"
+        description: "Bucket name to create for restic backups"
+        default: "restic"
+      garage_access_key_id:
+        type: "str"
+        description: "S3 access key ID"
+        required: true
+      garage_secret_access_key:
+        type: "str"
+        description: "S3 secret access key"
+        required: true
diff --git a/roles/garage/meta/main.yml b/roles/garage/meta/main.yml
new file mode 100644
index 00000000..e59db6e0
--- /dev/null
+++ b/roles/garage/meta/main.yml
@@ -0,0 +1,17 @@
+---
+dependencies: []
+galaxy_info:
+  author: "a14m"
+  description: "Install Garage S3-compatible object store"
+  license: "MIT"
+  min_ansible_version: "2.18"
+  platforms:
+    - name: "ArchLinux"
+      versions:
+        - "all"
+    - name: "Ubuntu"
+      versions:
+        - "noble"
+    - name: "Debian"
+      versions:
+        - "bookworm"
-- 
cgit v1.2.3