Installation eines Omada-Controllers

roles/omada-controller/README.md

@@ -0,0 +1,58 @@
+# Ansible Role: omada-controller
+
+Diese Rolle installiert den TP-Link Omada SDN Controller auf Debian-basierten Systemen (Debian, Ubuntu).
+
+Sie kümmert sich um die Installation der notwendigen Abhängigkeiten (Java, jsvc, curl) und lädt das offizielle `.deb`-Paket von der TP-Link-Website herunter und installiert es. Der Controller-Dienst (`tpeap`) wird anschließend gestartet und für den Systemstart aktiviert.
+
+## Anforderungen
+
+Diese Rolle wurde für die folgenden Betriebssysteme entwickelt und getestet:
+- Debian 10 (Buster)
+- Debian 11 (Bullseye)
+- Ubuntu 20.04 (Focal)
+- Ubuntu 22.04 (Jammy)
+
+Es sind keine weiteren externen Abhängigkeiten oder spezielle Python-Bibliotheken erforderlich.
+
+## Rollenvariablen
+
+Die folgenden Variablen können angepasst werden, um das Verhalten der Rolle zu steuern. Die Standardwerte sind in `defaults/main.yml` definiert.
+
+| Variable | Standardwert | Beschreibung |
+|---|---|---|
+| `omada_controller_deb_url` | `https://static.tp-link.com/.../Omada_SDN_Controller_v5.9.31_Linux_x64.deb` | Die direkte Download-URL für das `.deb`-Installationspaket des Omada Controllers. Die neueste Version finden Sie auf der TP-Link Download-Seite. |
+| `omada_controller_java_package` | `openjdk-8-jre-headless` | Das zu installierende Java-Paket. Version 8 ist eine sichere Wahl, neuere Controller-Versionen unterstützen eventuell auch Java 11 oder 17. |
+
+## Abhängigkeiten
+
+Diese Rolle hat keine Abhängigkeiten von anderen Ansible-Rollen.
+
+## Beispiel-Playbook
+
+So können Sie die Rolle in Ihr Playbook integrieren:
+
+```yaml
+- hosts: omada_controller_server
+  become: true
+  roles:
+    - omada-controller
+```
+
+Um eine spezifische Version des Controllers zu installieren, können Sie die URL im Playbook oder in Ihren `group_vars` überschreiben:
+
+```yaml
+- hosts: omada_controller_server
+  become: true
+  vars:
+    omada_controller_deb_url: "https://static.tp-link.com/path/to/specific/version.deb"
+  roles:
+    - omada-controller
+```
+
+## Lizenz
+
+MIT
+
+## Autor
+
+Hier können Sie Ihre Informationen eintragen.