Autoinstall and Forgejo

Infrastructure as Code
Dieses Repository beinhaltet die Ansible-Playbooks und Konfigurationsdateien zur Verwaltung meines Arch Linux Laptops (Hyprland) sowie meiner Server-Infrastruktur. Ziel ist es, die Einrichtung neuer Maschinen zu automatisieren und Konfigurationen konsistent zu halten. 
 Struktur des Repositories 
 
 setup.yml : Haupt-Playbook für den lokalen Laptop (Arch Linux). Installiert Pakete und verteilt Dotfiles. 
 server_setup.yml : Playbook für die Server-Verwaltung (Docker, Security, Updates). 
 inventory : Inventar-Datei für den lokalen Host (Laptop). 
 inventory_server : Inventar-Datei für Remote-Server (Hetzner, Home-Server). 
 files/ : Enthält die originalen Konfigurationsdateien (Hyprland, Waybar, Skripte etc.), die von Ansible verteilt werden. 
 
 
 Anleitung: Laptop (Neuinstallation) 
 Voraussetzung: Eine minimale Arch Linux Installation mit funktionierendem Internetzugang. 
 1. Vorbereitung 
 Zunächst müssen Git und Ansible manuell installiert werden, um das Repository zu klonen. 
 sudo pacman -S git ansible
 
 2. Repository klonen 
 Das Repository wird in das Home-Verzeichnis geklont. 
 mkdir -p ~/git
cd ~/git
git clone https://git.deinedomain.de/DeinUser/arch-setup.git
cd arch-setup
 
 3. Installation ausführen 
 Das Playbook setup.yml nutzt die lokale Verbindung. Der Parameter -K ist notwendig, um das sudo -Passwort für die Paketinstallation abzufragen. 
 ansible-playbook setup.yml -K
 
 Hinweis: Wenn das Playbook durchgelaufen ist, sollte ein Neustart erfolgen, damit alle Dienste (Hyprland, Login-Manager) korrekt greifen. 
 
 Anleitung: Server Management 
 Dieses Playbook dient dazu, Server (Hetzner VPS, Home-Server) zu aktualisieren oder neu aufzusetzen. 
 Voraussetzungen 
 
 Der SSH Public Key des Laptops muss auf den Servern in ~/.ssh/authorized_keys hinterlegt sein. 
 Die IP-Adressen müssen in der Datei inventory_server aktuell sein. 
 
 Ausführung 
 Vom Laptop aus wird folgendes Kommando ausgeführt: 
 ansible-playbook -i inventory_server server_setup.yml -K
 
 Dies führt Updates durch, prüft Docker-Container und stellt sicher, dass grundlegende Tools installiert sind. 
 
 Workflow für Änderungen 
 Um die Konfigurationen sauber zu halten, sollte nicht direkt in ~/.config gearbeitet werden, sondern immer über das Repository. 
 
 Änderungen an Dateien im Ordner files/ vornehmen oder neue Pakete in setup.yml eintragen. 
 Ansible Playbook lokal ausführen ( ansible-playbook setup.yml -K ), um Änderungen zu testen und anzuwenden. 
 Wenn alles funktioniert: Commit und Push zum Git-Server. 
 
 git add .
git commit -m "Beschreibung der Änderung"
git push
 
 
 Troubleshooting 
 Fehler: "Connection refused" auf localhost 
 Tritt auf, wenn Ansible versucht, sich per SSH mit dem eigenen Laptop zu verbinden, anstatt lokal zu arbeiten. 
 Lösung: 
Sicherstellen, dass in der Datei setup.yml die Zeile connection: local enthalten ist oder dass in der Datei inventory folgender Eintrag steht:
 localhost ansible_connection=local 
 Fehler: "Permission denied (publickey)" bei Servern 
 Ansible kann sich nicht mit dem Remote-Server verbinden. 
 Lösung: 
 
 Prüfen, ob der SSH-Agent läuft und der Key geladen ist ( ssh-add -l ). 
 Manuelle Verbindung testen: ssh user@server-ip . 
 Falls die IP neu ist, muss sie ggf. erst in die known_hosts aufgenommen werden (einmal manuell per SSH verbinden und bestätigen). 
 
 Fehler: Ansible überschreibt Änderungen immer wieder 
 Wenn Ansible bei jedem Lauf "changed" anzeigt, obwohl nichts geändert wurde. 
 Lösung: 
Oft stimmen die Dateirechte nicht überein. Im Playbook sicherstellen, dass mode: preserve genutzt wird, oder explizite Rechte ( 0644 für Dateien, 0755 für Ordner) gesetzt sind, die mit dem Ist-Zustand übereinstimmen. 
 Git Push funktioniert nicht (Authentifizierung) 
 Falls nach dem Passwort gefragt wird, aber der Login fehlschlägt. 
 Lösung: 
 
 Prüfen, ob die Remote-URL korrekt ist ( git remote -v ). 
 Sicherstellen, dass Port 2222 (oder der konfigurierte Git-Port) genutzt wird, falls SSH verwendet wird. 
 Bei HTTPS: Prüfen, ob das Passwort korrekt ist. Ggf. git config --global credential.helper store nutzen, um das Passwort einmalig dauerhaft zu speichern.