Cloud Connectors

Deployments Cloud

Was sind Cloud Connectors?

Cloud Connectors sind verwaltete, gehostete Connector-Instanzen, die in naras Cloud-Infrastruktur laufen. Sie bieten die gleichen Tool-Ausführungsfähigkeiten wie selbst gehostete Edge Connectors, aber ohne die Notwendigkeit, Software auf eigenen Maschinen zu installieren und zu warten.

Nutze Cloud Connectors, wenn du einen Connector brauchst, der immer verfügbar ist, von der Plattform verwaltet wird und keinen Zugriff auf On-Premise-Ressourcen benötigt.

Hinweis

Cloud Connectors eignen sich am besten für Tools, die mit cloudbasierten APIs und Services interagieren. Wenn deine Tools Zugriff auf lokale Netzwerkressourcen, Dateisysteme oder On-Premise-Infrastruktur brauchen, nutze stattdessen einen selbst gehosteten Edge Connector.

Lebenszyklus

Ein Cloud Connector durchläuft eine definierte Abfolge von Zuständen:

provision --> start --> running --> stop --> stopped --> delete

Zustand	Beschreibung
Provisioning	Die Cloud-Infrastruktur wird für die Connector-Instanz bereitgestellt. Das kann einige Augenblicke dauern.
Stopped	Die Connector-Instanz existiert, läuft aber nicht. In diesem Zustand sind keine Tool-Ausführungen möglich.
Starting	Der Connector fährt hoch und stellt seine WebSocket-Verbindung zur Plattform her.
Running	Der Connector ist aktiv, verbunden und bereit, Tool-Aufrufe auszuführen.
Stopping	Der Connector fährt ordnungsgemäß herunter. Laufende Tool-Aufrufe werden abgeschlossen, bevor die Verbindung geschlossen wird.

Cloud Connector provisionieren

1. Navigiere zu Admin > Deployments und wähle das Deployment aus, das den Cloud Connector hosten soll.

2. Klicke auf Provision Cloud Connector.

3. Die Plattform stellt eine Cloud-Instanz für den Connector bereit. Das dauert typischerweise 30 bis 60 Sekunden.

4. Sobald die Provisionierung abgeschlossen ist, erscheint der Connector in der Connector-Liste des Deployments mit dem Status Stopped.

5. Klicke auf Start, um den Connector online zu bringen. Er stellt eine WebSocket-Verbindung her und beginnt, Tool-Aufrufe anzunehmen.

Tipp

Du kannst mehrere Cloud Connectors pro Deployment provisionieren — für Redundanz oder Lastverteilung. Tool-Aufrufe werden an jeden verfügbaren Connector im Deployment geroutet.

Starten und Stoppen

Starten

Um einen gestoppten Cloud Connector zu starten:

1. Öffne das Deployment, das den Connector enthält.
2. Finde den Cloud Connector in der Connector-Liste.
3. Klicke auf Start.
4. Der Connector wechselt zu Starting und dann zu Running, sobald seine WebSocket-Verbindung hergestellt ist.

Ein laufender Cloud Connector erscheint in der Anzahl aktiver Connectors des Deployments und kann Tool-Ausführungsanfragen empfangen.

Stoppen

Um einen laufenden Cloud Connector zu stoppen:

1. Öffne das Deployment, das den Connector enthält.
2. Finde den Cloud Connector in der Connector-Liste.
3. Klicke auf Stop.
4. Der Connector fährt ordnungsgemäß herunter und schließt laufende Tool-Aufrufe ab, bevor er die Verbindung trennt.

Gestoppte Connectors behalten ihre Konfiguration und können jederzeit ohne erneute Provisionierung neu gestartet werden.

Status prüfen

Du kannst den Status eines Cloud Connectors jederzeit überprüfen:

• Über die Oberfläche — öffne das Deployment und sieh dir die Connector-Liste an. Jeder Cloud Connector zeigt seinen aktuellen Zustand (Provisioning, Running, Stopped) zusammen mit seinem letzten Heartbeat-Zeitstempel.
• Über die CLI — führe edge-connector cloud status aus, um den aktuellen Zustand über die Kommandozeile abzurufen.

Feststeckende Operationen erzwingen

In seltenen Fällen kann eine Provisioning-, Start- oder Stop-Operation durch Infrastrukturprobleme stecken bleiben. Wenn ein Cloud Connector über längere Zeit in einem Übergangszustand (Provisioning, Starting oder Stopping) verbleibt:

1. Öffne das Deployment mit dem feststeckenden Connector.

2. Klicke auf die Aktion Force Complete beim betroffenen Connector.

3. Die Plattform markiert die Operation als abgeschlossen und versetzt den Connector in seinen nächsten logischen Zustand (Stopped nach fehlgeschlagenem Provisioning oder Start, Stopped nach einem steckengebliebenen Stop).

4. Du kannst die Operation dann erneut versuchen oder den Connector löschen und einen neuen provisionieren.

Achtung

Force Complete garantiert nicht, dass die zugrundeliegende Infrastruktur-Aktion erfolgreich war. Wenn der Connector nach einem Force Complete nicht startet, lösche ihn und provisioniere eine neue Instanz.

Cloud Connectors löschen

Um einen Cloud Connector dauerhaft zu entfernen:

1. Stoppe den Connector, falls er aktuell läuft.
2. Klicke auf Delete beim Connector-Eintrag.
3. Bestätige die Löschung.

Das Löschen eines Cloud Connectors gibt die zugrundeliegende Cloud-Infrastruktur frei und entfernt ihn aus dem Deployment. Diese Aktion kann nicht rückgängig gemacht werden.

CLI-Äquivalent

Wenn du die Edge Connector CLI nutzt, bieten die folgenden Unterbefehle die gleiche Funktionalität:

edge-connector cloud provision --deployment <deployment-id>
edge-connector cloud start --deployment <deployment-id>
edge-connector cloud stop --deployment <deployment-id>
edge-connector cloud status --deployment <deployment-id>
edge-connector cloud delete --deployment <deployment-id>

Nächste Schritte

Deployments verwalten Konfiguriere Deployments, die deine Cloud- und selbst gehosteten Connectors hosten.

Target Versions Pinne Deployments auf bestimmte Tool-Bundle-Versionen.

Edge Connector Installiere einen selbst gehosteten Edge Connector für On-Premise-Tool-Ausführung.