Überblick

Adapter führen Pipelines aus, und eine Pipeline besteht aus Nodes. Es gibt Nodes, die allen Adaptern gemeinsam sind, und es gibt Nodes, die für jeden Adapter spezifisch sind. Zum Beispiel bringt der Modbus-Adapter Modbus-Nodes mit, der OPC-UA-Adapter bringt OPC-UA-Nodes mit usw.

Wir unterscheiden zwischen zwei Arten von Adaptern: Edge Adapters und Mesh Adapters. Edge Adapters sind dafür ausgelegt, lokal zu arbeiten, nahe an den Datenquellen oder innerhalb desselben lokalen Netzwerks. Diese Nähe ermöglicht einen schnellen Datenaustausch, den Betrieb auch dann, wenn keine Verbindung zu den zentralen Diensten von OctoMesh besteht, und eine geringere Latenz, was Edge Adapters ideal für Szenarien macht, in denen sofortige Datenverarbeitung und -reaktion entscheidend sind. Sie werden typischerweise vor Ort (on-premises), in Edge-Computing-Umgebungen oder direkt auf Geräten bereitgestellt, die Daten sammeln oder erzeugen. Durch die lokale Datenverarbeitung tragen Edge Adapters außerdem dazu bei, den Datenschutz und die Sicherheit zu wahren, indem die Offenlegung sensibler Informationen gegenüber externen Netzwerken minimiert wird.

Mesh Adapters hingegen sind dafür ausgelegt, an zentralen Standorten wie Cloud-Umgebungen oder zentralisierten Rechenzentren zu laufen. Diese Adapter übernehmen Aufgaben, die sich für eine Zentralisierung eignen, etwa das Aggregieren von Daten aus mehreren Edge Adapters, das Durchführen umfangreicher Datenverarbeitung sowie das Verwalten von Datenspeicherung und -verteilung auf einer höheren Ebene. Mesh Adapters ermöglichen die Skalierbarkeit und Robustheit, die für großangelegte Deployments nötig sind, unterstützen umfangreiche Datenoperationen und bieten eine globale Sicht auf das Data Mesh.

Jeder Adapter ist außerdem im Asset Repository von OctoMesh abgebildet. Dies ermöglicht es, die Konfiguration des Adapters zu verwalten und ihn in der gewünschten Umgebung bereitzustellen. Das Asset Repository bietet außerdem einen Überblick über alle verfügbaren Adapter und ihren Status.

Zustandsfelder von Adaptern

Adapter enthalten verschiedene Zustandsfelder, die Informationen über den Status des Adapters liefern. Die folgenden Zustandsfelder sind verfügbar:

DeploymentState

Der Deployment-Status des Adapters, falls der Adapter von einem Deployment Site eines OctoMesh Operators verwaltet wird. Mögliche Werte sind Undeployed, Pending, Deployed, Error.

• Undeployed: Der Adapter wird nicht von einem Pool verwaltet, ist nicht bereitgestellt oder das Deployment wurde entfernt.
• Pending: Der Adapter befindet sich im Bereitstellungsprozess.
• Deployed: Der Adapter ist bereitgestellt und läuft.
• Error: Während des Deployments ist ein Fehler aufgetreten. Dies kann zum Beispiel passieren, wenn das Chart-Repository, der Chart-Name oder die Chart-Version ungültig ist oder das Container-Image des Charts nicht abgerufen werden kann.

CommunicationState

Der Kommunikationsstatus des Adapters. Mögliche Werte sind Unregistered, Online, Offline.

• Unregistered: Der Adapter hat sich nie bei der OctoMesh-Plattform registriert.
• Online: Der Adapter ist registriert und online.
• Offline: Der Adapter ist registriert, aber offline.

Es gibt ein Feld CommunicationStateTimestamp, das den Zeitstempel der letzten Änderung des Kommunikationsstatus anzeigt.

ConfigurationState

Der Konfigurationsstatus des Adapters. Mögliche Werte sind Unconfigured, Pending, Configured, Error.

• Unconfigured: Der Adapter ist nicht konfiguriert.
• Pending: Der Adapter befindet sich im Konfigurationsprozess.
• Configured: Der Adapter ist konfiguriert.
• Error: Während der Konfiguration ist ein Fehler aufgetreten.

hinweis

Die Konfiguration eines Adapters umfasst die Konfiguration des Adapters selbst (Feld Configuration) und die Konfiguration der Pipelines des Adapters.

LifecycleState

Für pool-verwaltete Adapter, die den On-Demand-Lebenszyklus (Scale-to-Zero) verwenden, zeigt das Feld LifecycleState die aktuelle Lebenszyklus-Situation an. Mögliche Werte sind Running, Draining, Hibernated, Waking.

• Running: Der Adapter ist aktiv und verarbeitet Arbeit.
• Draining: Der Adapter war länger als sein Idle-Timeout untätig und wird auf null Replicas herunterskaliert.
• Hibernated: Der Adapter ist auf null Replicas skaliert und verbraucht keine Cluster-Ressourcen.
• Waking: Der Adapter wird nach einem Bedarfssignal wieder hochskaliert.

info

Während ein Adapter in den Ruhezustand versetzt ist, bleibt DeploymentState auf Deployed (das Helm-Release existiert weiterhin) und CommunicationState zeigt Offline — das ist normal und erwartet, kein Ausfall. Siehe On-Demand-Lebenszyklus (Scale-to-Zero) für Details.

Pipeline-Service-Account

Jeder Adapter hat ein verpflichtendes Pipeline-Service-Account — die Identität, unter der seine Pipelines laufen. Es wird automatisch bereitgestellt (ein Identity-Client plus eine ServiceAccountConfiguration) und ist standardmäßig die Identität für alle Pipelines des Adapters. Eine Pipeline, deren Identität nicht aufgelöst werden kann, wird zum Deploy-Zeitpunkt abgelehnt.

Sie verwalten dieses Account auf dem Bearbeitungsformular des Adapters, im Panel Pipeline Service Account (eine Konfiguration verknüpfen, ihre Rollen und Health einsehen oder ihr Secret rotieren). Einzelne Pipelines können den Standard des Adapters mit ihrem eigenen Service Account überschreiben.

Siehe Pipeline-Identität für die vollständige Erklärung von Service Accounts, Delegation und wie Rollen entscheiden, worauf eine Pipeline zugreifen kann.

Adapter in Refinery Studio

Adapter können in Refinery Studio unter dem Tab Communication/Adapters verwaltet werden. Der Überblick bietet Informationen über den Status des Adapters und ermöglicht es, Operationen am Adapter durchzuführen.

Operationen

Die folgenden Operationen können an einem Adapter durchgeführt werden:

• Edit: Die Konfiguration des Adapters bearbeiten.
• Deploy adapter configuration: Die Konfiguration des Adapters bereitstellen (Feld Configuration und Pipeline-Konfigurationen).
• Delete: Die Konfiguration des Adapters löschen und den Adapter aus dem Asset Repository entfernen.
• Export: Die Adapter-Runtime-Entität als ZIP-Datei exportieren.
• Import: Eine Adapter-Runtime-Entität aus einer ZIP-, YAML- oder JSON-Datei importieren.

Bearbeitungsansicht eines Adapters

Die Bearbeitungsansicht eines Adapters ermöglicht das Bearbeiten der Konfiguration des Adapters. Dazu gehören der Name, eine optionale Beschreibung, der Adapter-Typ, der Kommunikationsstatus und der Zeitstempel der letzten Aktualisierung des Kommunikationsstatus.

Deployment

Für Adapter, die von einem Pool verwaltet werden, zeigt die Bearbeitungsansicht auch den Namen des Pools an. Der Name des Pools ist ein Link, der zur Bearbeitungsansicht des Pools navigiert. Adapter, die von einem Deployment Site gehostet werden, werden aus einem Helm-Chart bereitgestellt. Der Adapter definiert die Chart-Repository-URL, den Chart-Namen und die Chart-Version; der Communication Operator registriert das Repository und führt helm upgrade --install aus, um den Adapter in der gewünschten Umgebung bereitzustellen. Wird die Chart-Version leer gelassen, wird das neueste im Repository veröffentlichte Chart ausgewählt. Chart-Werte sind geschichtet: clusterweite Standardwerte vom Operator, die eigenen Basiswerte des Adapters und die pro-Adapter-Overrides, die Sie in der Bearbeitungsansicht eingeben.

Direkt in der Bearbeitungsansicht kann der Adapter bereitgestellt, wieder entfernt oder das Deployment aktualisiert werden. Das Feld DeploymentState zeigt den aktuellen Deployment-Status des Adapters an. Oben in der Bearbeitungsansicht gibt es einen Refresh-Button, der den Status des Adapters aktualisiert.

Konfiguration

Die Konfiguration eines Adapters besteht aus einem Feld Configuration und der Pipeline-Definition der zugeordneten Pipelines.

Das Feld Configuration enthält die Konfiguration des Adapters. Die Konfiguration ist ein JSON-Objekt, das für den Adapter-Typ spezifisch ist. Die Konfiguration kann direkt in der Bearbeitungsansicht bearbeitet werden.

Die Pipeline-Definition der zugeordneten Pipelines wird im Abschnitt Pipelines angezeigt.

Die Konfiguration kann direkt in der Bearbeitungsansicht aktualisiert werden, wenn der Adapter Online ist. Bei einer ungültigen Konfiguration wechselt der Zustand des Adapters auf Error und zeigt eine Fehlermeldung im Feld Configuration status message an.