From 0950739c06afc4f1fe7ba62c2fe76e5832cfb4b4 Mon Sep 17 00:00:00 2001
From: L3D <l3d@c3woc.de>
Date: Sat, 21 Feb 2026 17:06:15 +0100
Subject: [PATCH] Prepare ansible setup

---
 .gitignore       |  1 +
 .yamllint        |  8 ++++++++
 README.md        | 27 ++++++++++++++++++++++++++-
 requirements.txt |  3 +++
 site.yml         |  1 +
 5 files changed, 39 insertions(+), 1 deletion(-)
 create mode 100644 .yamllint
 create mode 100644 requirements.txt
 create mode 100644 site.yml

diff --git a/.gitignore b/.gitignore
index 2c47751..1d1351f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,6 +21,7 @@ tags
 
 # ---> Ansible
 *.retry
+*.ansible/
 
 # ---> macOS
 # General
diff --git a/.yamllint b/.yamllint
new file mode 100644
index 0000000..6f4fce2
--- /dev/null
+++ b/.yamllint
@@ -0,0 +1,8 @@
+---
+extends: default
+
+rules:
+  # 150 chars should be enough, but don't fail if a line is longer
+  line-length:
+    max: 180
+    level: warning
diff --git a/README.md b/README.md
index 50f2226..50cc750 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,31 @@
 # arch-obs-setup
 
-Ansible-Managed Arch Linux OBS Setup
+**Ansible-Managed Arch Linux OBS Setup**
+
+In diesem Git-Repository entsteht ein Linux OBS Setup. Aktuell ist das alles noch sehr **WORK IN PROGRESS**!
+
+
+# Allgemeine Hinweise
+
+Das git Repository verwendet git Submodule. Zum auschecken macht es also ggf. sinn, folgende git commands einzusetzen:
+
+```bash
+git submodule update --init --recursive
+git config submodule.recurse true
+```
+
+Git submodule werden hier zum Beispiel verwendet und ansible rollen und collections zu integrieren.
+
+## Ansible
+
+Das **inventory** des ansible findet sich in der ``hosts.ini``. Um das Setup für andere hosts anzuwenden, ist das auf jeden Fall ein Blick wert.
+Natürlich im zusammenspiel mit den ``host_vars`` und den ``group_vars``.
+
+Das spannenste **Playbook** ist vermutlich das ``site.yml``, hier wird das gesamte Setup aufgesetzt.
+
+## Requirements
+
+Dieses Ansible Setup setzt ein vorinstalliertes Arch-Linux vorraus, in das die ausführende Person per ssh ansible ausrollen kann.
 
 # License
 
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..14b7649
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,3 @@
+ansible-core>=2.20.2
+ansible-lint>=26.1.1
+yamllint>=1.38.0
diff --git a/site.yml b/site.yml
new file mode 100644
index 0000000..ed97d53
--- /dev/null
+++ b/site.yml
@@ -0,0 +1 @@
+---