Runtime

Edge Connector Architecture

Die Edge-Connector-Runtime ist der dauerhaft laufende Prozess, der deine Umgebung mit der nara-Plattform verbindet. Für den Betrieb sind vor allem Start, Reconnect, Bundle-Sync und Health-Prüfung wichtig.

Startsequenz

Beim Start tut die Runtime typischerweise Folgendes:

1. Konfiguration laden

2. Authentifizieren

3. Lokale oder zugewiesene Implementierungen laden

4. Mit der Plattform verbinden

5. Health-Reporting und Sync starten

WebSocket-Verbindung

Die Runtime hält eine persistente WebSocket-Verbindung zur Plattform. Darüber laufen Tool-Aufrufe, Ergebnisse, Heartbeats und Update-Signale.

Bei erfolgreicher Verbindung weiß die Plattform, welche edgegestützten Tools über diese Runtime verfügbar sind.

Reconnect-Logik

Wenn die Verbindung abbricht, versucht die Runtime automatisch eine Wiederverbindung mit Backoff. Nach erfolgreichem Reconnect werden die verfügbaren Tools erneut registriert.

Hinweis

Vorübergehende Verbindungsunterbrechungen erholen sich normalerweise automatisch. Dauerhafte Fehler deuten meist auf Netzwerk-, Deployment- oder Credential-Probleme hin.

Heartbeats

Die Runtime sendet regelmäßig Heartbeats, damit die Plattform erkennen kann, ob die Verbindung noch aktiv ist.

Das dient:

• der Liveness-Erkennung
• dem Aktivhalten der Verbindung durch Proxies und ähnliche Infrastruktur

Bundle-Sync

Die Runtime prüft regelmäßig auf neue Bundles und lädt sie automatisch herunter, wenn nötig.

Typisches Verhalten:

• initialer Sync, wenn lokal keine passenden Implementierungen vorhanden sind
• periodische Prüfungen auf neue Bundle-Versionen
• Laden und Aktivieren neuer Bundles ohne manuelle Dateiverwaltung

Tipp

Bundle-Sync läuft automatisch. Normalerweise weist du das Bundle in der Plattform zu und die Runtime übernimmt es im nächsten Sync-Zyklus.

Health-Monitoring

Die Runtime stellt HTTP-Endpunkte für Monitoring bereit:

Endpunkt	Zweck
GET /livez	Prüft, ob der Prozess läuft
GET /healthz	Prüft, ob die Runtime einsatzbereit ist
GET /statusz	Liefert einen detaillierteren Status

curl http://localhost:8080/healthz
curl http://localhost:8080/statusz

Kontrolliertes Herunterfahren

Beim Herunterfahren versucht die Runtime sauber zu stoppen:

1. Sie nimmt keine neue Arbeit mehr an.
2. Sie schließt die Plattformverbindung.
3. Sie gibt lokalen Zustand und Sperren frei.
4. Sie beendet sich kontrolliert.

Nächste Schritte

Installation Den Edge Connector auf Workstations oder Servern einrichten.

Custom Tools Edge-gestützte Tools bauen, die von der Runtime geladen und ausgeführt werden.