# 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)

```bash
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

```bash
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):

```powershell
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

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