Seminar Zoraxy Installation & Deployment: Linux, Windows, Docker, SBC

Inhaltsverzeichnis

• Abstract
• Zielgruppe und Voraussetzungen
• Lernziele
• Agenda
• Praxisübungen
• Betriebsbereitstellungs-Checkliste

Abstract

Dieses Seminar behandelt die produktionsnahe Bereitstellung von Zoraxy auf typischen Plattformen. Im Fokus stehen Installationsvarianten (Binary, Docker, Build), Start- und Betriebsparameter, Service-Integration (z. B. systemd) sowie saubere Persistenz von Konfiguration und Logs. Zusätzlich werden Netzwerkvoraussetzungen für Reverse Proxy und ACME betrachtet (Ports, NAT, Erreichbarkeit). Das Ergebnis ist ein reproduzierbarer Installationsstandard inklusive Abnahmecheck.

Zielgruppe und Voraussetzungen

• Zielgruppe: Systemadministration, Plattformbetrieb, DevOps
• Voraussetzungen: Linux-Grundlagen, optional Docker-Grundlagen

Lernziele

• Installationspfade auswählen und bewerten
• Zoraxy als Service betreiben (Startparameter, Logs, Neustarts)
• Persistenz- und Backup-Design für Konfiguration erstellen
• Netzwerk- und Port-Design für Reverse Proxy und TLS-Management prüfen
• Upgrade-Strategie definieren (inkl. Breaking-Change-Handling)

Agenda

• Installationswege: Binary, Docker, Build-from-Source; Go-Anforderung für Build
• Startparameter: Konfig-/DB-Backend-Konzept, Logging-Pfade
• Servicebetrieb: systemd-Muster, Neustartverhalten, Logrotation
• Praxis 1: Linux-Installation und Servicebetrieb
• Praxis 2: Docker-Deployment und Persistenz
• Abnahmecheck: Ports, Firewall, Reverse-Proxy-Entry, Admin-Interface-Schutz

Praxisübungen

• Linux-Binary Deployment (Standardpfad)
  • Zielverzeichnisstruktur definieren:
    • Binary-Pfad
    • Daten-/Konfigpfad
    • Logpfad
  • Zoraxy starten (Management-Port festlegen, z. B. :8000)
  • Erststart-Initialisierung ausführen (UI-Setup, Admin-Account)
  • Service-Wrapper erstellen (systemd-Unit-Konzept):
    • WorkingDirectory
    • Restart-Policy
    • Umgebungsvariablen (falls genutzt)
  • Validierung: Reboot, Auto-Start, Logausgabe, Health-Check
• Startparameter standardisieren
  • Parameterkategorien definieren:
    • Port/Bindings
    • Datenbankbackend (auto/leveldb/boltdb je nach Plattform)
    • Auto-Config-Upgrade Verhalten
  • Baseline setzen:
    • Logging-Pfad
    • GeoIP-Option nur bei Ressourcenbudget (Hinweis auf Speicherbedarf bei „fast geoip“)
  • Parameter in Runbook dokumentieren
• Docker-Deployment mit Persistenz
  • Container-Netzwerk festlegen (Bridge vs Host)
  • Portmapping planen:
    • HTTP/HTTPS Entry (typisch 80/443)
    • Management-Port (z. B. 8000)
  • Persistenz: Datenvolumen für Konfiguration und Zertifikate festlegen
  • Validierung: Container-Neustart ohne Datenverlust
  • Ergebnis: reproduzierbares Compose- oder Run-Template (intern)
• Erreichbarkeits- und Port-Check für ACME
  • DNS-Zuordnung prüfen (A/AAAA Records)
  • Firewall/NAT prüfen: eingehend 80/443 bis Zoraxy-Host
  • Management-Interface: nur intern oder via VPN erreichbar (Baseline)
  • Ergebnis: Abnahmeprotokoll „bereit für ZOR-202“

Betriebsbereitstellungs-Checkliste

• Management-Port nicht öffentlich exponiert
• Persistenz für Konfiguration, Zertifikate, Logs definiert
• Restart-Strategie und Logrotation definiert
• Updatepfad dokumentiert (Rollback-Plan)
• Baseline-Firewallregeln gesetzt