Files

T

B0rbor4d cc4c3fcecb Hub-and-Spoke Umbau: Multi-Tenant Zentrale + Satellite-Agent

- Backend: Customer/Satellite Models, customer_id auf Server/Job/Audit
- Satellite-API: heartbeat, poll (atomares Claiming), logs, result,
  scan-result, health-report - Auth via X-Api-Key (SHA-256 gehasht)
- Job-Queue: pending/claimed/running/success/failed + Stale-Janitor
- Batch-Trigger: ein Job pro Server, Satellite arbeitet sequenziell ab
- Credentials bleiben lokal: nur symbolische credential_ref zentral
- Neues Paket satellite/: Pull-Loop, WinRM/SSH/CAU/Scanner, PyInstaller-tauglich
- Frontend: Kunden-Switcher, Satelliten-View, Polling statt WebSocket
- Entfernt: WebSocket/Socket.io, Redis, zentrale Credentials, JobRunner
- Docs: README/AGENTS/PROMPT auf neue Architektur aktualisiert

2026-08-07 03:42:06 +00:00

2.2 KiB

Raw Permalink Blame History

Insight Updater Satellite

Remote-Agent fuer Kundennetzwerke. Laedt Jobs von der zentralen Insight-Updater-Instanz, fuehrt sie lokal im Kundennetz aus (WinRM / SSH / CAU / Netzwerk-Scan) und meldet Logs und Ergebnisse zurueck. Kein Docker noetig - eine einzelne Binary genuegt.

Prinzip

Nur ausgehende HTTPS-Verbindungen zur Zentrale (keine Firewall-Loecher beim Kunden)
Pull-Modell: der Satellite pollt alle N Sekunden nach Jobs
Credentials (WinRM/SSH) liegen ausschliesslich lokal in credentials.yaml
1-2 Satelliten pro Kunde reichen - sie steuern das ganze Netz (wie CAU im Cluster)

Setup (Development)

cd satellite
pip install -e .
cp config.example.yaml config.yaml
cp credentials.example.yaml credentials.yaml
# config.yaml: central_url + api_key eintragen (Key aus dem Dashboard)
# credentials.yaml: WinRM-/SSH-Zugangsdaten des Kundennetzes pflegen
insight-satellite --config config.yaml --credentials credentials.yaml

Windows-Binary bauen

pip install -e ".[build]"
pyinstaller --onefile --name insight-satellite satellite/runner.py
# Ergebnis: dist/insight-satellite.exe

Auf dem Zielsystem (Windows-Server beim Kunden):

C:\insight-satellite\
  insight-satellite.exe
  config.yaml
  credentials.yaml

Start als Scheduled Task (Beispiel, ohne Umlaute):

schtasks /create /tn "InsightUpdaterSatellite" /tr "C:\insight-satellite\insight-satellite.exe --config C:\insight-satellite\config.yaml --credentials C:\insight-satellite\credentials.yaml" /sc onstart /ru SYSTEM /rl HIGHEST

Job-Typen

Typ	Aktion
`windows_update`	Windows Update via WinRM (COM Microsoft.Update.Session)
`linux_update`	apt/dnf/yum upgrade via SSH mit sudo
`cau_run`	Invoke-CauRun auf einem Failover-Cluster
`health_check`	Verbindungstest, Ergebnis geht an die Zentrale
`network_scan`	Ping-Sweep + Port-Probe (5985/22), legt gefundene Hosts zentral an

Ablauf pro Job

GET /api/satellite/poll - Jobs abholen (werden dabei claimed)
Lokal ausfuehren, Log-Zeilen sammeln
POST /api/satellite/logs - Batches waehrend der Ausfuehrung
POST /api/satellite/result - Abschluss (success/failed + Fehlertext)

2.2 KiB Raw Permalink Blame History