4.6 KiB
🚀 TUI-Ansible-Installer
Ein Terminal User Interface (TUI) zum Verwalten, Ausführen und Installieren von Ansible-Playbooks auf einem lokalen oder entfernten System.
📌 Übersicht
Der TUI-Ansible-Installer ist ein Werkzeug, das auf einem Raspberry Pi oder jedem anderen Linux-System läuft. Er dient als zentrale Verwaltungsoberfläche für Ansible-Playbooks und Zielsysteme. Die TUI liest Playbooks aus der lokalen Playbook-Struktur ein, erlaubt die Auswahl eines Zielsystems und unterstützt die automatische Einrichtung der SSH-Schlüsselverbindung.
🎯 Ziele des Projekts
Eine einfache, intuitive TUI zur Auswahl und Ausführung von Playbooks
Verwaltung lokaler oder externer Zielsysteme
Automatische Vorbereitung des Zielsystems (SSH-Key-Setup, Abhängigkeiten, etc.)
Automatische Selbstprüfung des Installers → Installiert fehlende Abhängigkeiten
Playbooks in einer übersichtlichen Tree-Struktur darstellen
Optionales Synchronisieren von Dateien aus /playbook/data zum Zielsystem per SCP
Minimal invasiv: Dateien in /playbook/data werden nicht in der TUI angezeigt
📁 Verzeichnisstruktur /playbook/ ├── roles/ ├── playbooks/ │ ├── system/ │ │ ├── update.yml │ │ └── upgrade.yml │ ├── docker/ │ │ └── install.yml │ └── ... └── data/ ├── templates/ ├── binaries/ └── ...
✨ Bedeutung der Ordner
/playbook/playbooks/ Enthält die Playbooks und deren Ordnerstruktur → wird 1:1 als Tree im TUI angezeigt
/playbook/data/ Enthält Dateien, die ein Playbook benötigt (z. B. Konfigs, Installers, Template-Dateien). → Nicht im TUI sichtbar, aber vom Installer für SCP-Transfers nutzbar.
🖥️ Funktionen der TUI 🔍 1. Autocheck beim Start
Beim Start prüft die TUI automatisch, ob alle benötigten Komponenten installiert sind:
Ansible
Python3
pip-Pakete
SSH-Client
SCP / rsync (optional)
Netzwerkverbindung
Wenn etwas fehlt → automatische Abfrage:
„Das System ist noch nicht vorbereitet. Soll ich die fehlenden Komponenten installieren? [Ja] / Nein“
Ja (Default): System wird vorbereitet
Nein: Nutzer kann das TUI-Menü trotzdem verwenden, aber keine Playbooks ausrollen
🗂️ 2. Playbook-Browser
Durchsucht /playbook/playbooks
Stellt die Struktur als baumartige Liste dar
Playbooks können einzeln ausgewählt und ausgeführt werden
Mehrfachauswahl möglich
Optional: Markieren von Playbooks für „automatische Aktualisierung“ eines Zielsystems
🖧 3. Server-/Zielsystemverwaltung
Über die Taste S (oder per Dateinavigation):
✏️ Server-Menü
Neues Zielsystem hinzufügen
Hostname / IP
Anzeigename
Benutzername
Passwort (optional)
Option: „SSH-Key automatisch einrichten“
Zielsystem auswählen
Zielsystem löschen
Zielsystem als „Standard“ setzen
🔐 SSH-Key-Setup
Bei aktivierter Option konfiguriert die TUI automatisch:
Verbindung zum Zielsystem aufbauen
System prüfen (SSH, Python, Sudo, etc.)
SSH-Key transferieren
Passwort-Login optional deaktivieren
Host in ~/.ssh/known_hosts eintragen
Testverbindung herstellen
🧰 4. Ausführen von Playbooks
Nach Auswahl eines Zielsystems kann der Nutzer:
Playbook(s) auswählen
Option: Dateien aus /playbook/data synchronisieren
Playbook sofort ausrollen
oder Zielsystem markieren: „Immer aktuell halten“
Bei Ausführung zeigt die TUI:
Live-Output (stdout)
Fehlermeldungen
Fortschrittsbalken
Erfolgsstatus
🖥️ 5. Lokaler Modus (Raspberry Pi selbst)
Der Installer kann den Raspberry Pi selbst als Ansible-Host konfigurieren:
Installation aller Abhängigkeiten
Einrichtung des lokalen Inventars
Automatische Systemprüfung
Optional: Playbooks direkt auf dem lokalen System ausführen
„Lokaler Modus“ kann jederzeit im Servermenü ausgewählt werden.
🧭 Bedienkonzept Tastenbelegung (Vorschlag) Taste Funktion ↑/↓ Navigation im Menü → Ordner öffnen / Auswahl bestätigen ← Zurück S Server-/Zielsystemverwaltung Enter Playbook starten / Menüpunkt auswählen Space Playbook markieren Q Beenden ⚡ Workflow-Beispiel
TUI starten → Autocheck
System vorbereiten (optional)
Server mit S hinzufügen
SSH-Key automatisch einrichten
Playbooks durchsuchen
Playbook auswählen
Ausrollen starten
Status direkt im TUI sehen
📝 Geplante Erweiterungen (optional)
Logging/Reporting im /var/log/tui-ansible/
Plugin-System: eigene Module für Menüfunktionen
Profile pro Zielsystem
Zeitgesteuertes Ausrollen
Git-Pull von Playbooks direkt in der TUI
📦 Voraussetzungen
Linux-System (Raspberry Pi empfohlen)
Python 3.9+
Ansible
SSH/SCP
Bibliothek für TUI (z. B. textual, urwid, rich)