Openflow verwalten

Unter diesem Thema werden die Schritte zur Verwaltung von Openflow-Komponenten beschrieben.

Löschen einer Bereitstellung

Über die AWS-Konsole:

  1. Navigieren Sie zu EC2-Instanzen.

  2. Wählen Sie die openflow-agent-{deployment-key}-Instanz mit Ihrem Bereitstellungsschlüssel aus.

  3. Klicken Sie oben auf der Seite auf Connect.

  4. Wechseln Sie von EC2 Instance Connect zu Connect using EC2 Instance Connect Endpoint. Lassen Sie den standardmäßigen „EC2 Instance Connect“-Endpunkt bestehen.

  5. Klicken Sie auf Connect. Es wird eine neue Browser-Registerkarte oder ein neues Fenster mit einer Befehlszeilenschnittstelle angezeigt.

  6. Führen Sie ./destroy.sh über die Shell aus.

    • Dies kann 20–30 Minuten dauern. Wenn Ihre Verbindung unterbrochen wird, läuft der Prozess im Hintergrund weiter.

    • Sie können sich wieder anmelden und den Status mit dem folgenden Befehl anzeigen: journalctl -u docker -f -n 250

    • Der destroy -Prozess ist abgeschlossen, wenn Sie die Ausgabe delete successful sehen.

  7. Navigieren Sie zu CloudFormation in der AWS-Konsole für Ihre Region.

  8. Löschen Sie den CloudFormation-Stack für Ihre Bereitstellung.

Über Snowsight:

  1. Navigieren Sie zu Openflow.

  2. Wählen Sie die Registerkarte Deployments aus.

  3. Wählen Sie in der Zeile der Bereitstellung, die Sie löschen möchten, das Symbol „More Options“ aus.

  4. Wählen Sie Delete aus.

  5. Geben Sie im Bestätigungsdialog delete ein, um den Löschvorgang zu bestätigen.

  6. Klicken Sie auf Delete deployment.

Upgrade einer Bereitstellung

Innerhalb der Openflow-Bereitstellung gibt es mehrere Komponenten, die möglicherweise aktualisiert werden müssen. Derzeit wird dies über ein Openflow-Bereitstellungsagent-Skript ausgeführt. Zu den Komponenten gehören der Agent, der Bereitstellungsdienst, die Bereitstellungs-UI, das Gateway für die Laufzeit und der Laufzeit-Operator. Alle Komponenten werden gemäß den folgenden Verfahren aktualisiert.

Mit dem Bereitstellungsagenten verbinden

  1. Navigieren Sie zu Openflow.

  2. Wählen Sie die Registerkarte Deployments aus.

  3. Sehen Sie sich Ihre Bereitstellungsdetails an und notieren Sie sich den Bereitstellungsschlüssel.

  4. Zeigen Sie in Ihrem AWS-Konto die EC2-Instanzen und -Filter mithilfe des Bereitstellungsschlüssels an.

  5. Suchen Sie die EC2-Instanz des Bereitstellungsagenten namens openflow-agent-{deployment-key}.

  6. Stellen Sie mithilfe von EC2 Instance Connect Endpoint eine Verbindung her und akzeptieren Sie alle Standardwerte.

  7. Führen Sie die verbleibenden-Befehle auf der neuen Browser-Registerkarte oder in dem neuen Fenster aus, das mit einer Befehlszeilenschnittstelle angezeigt wird.

Auf verfügbare Upgrades prüfen

cat ~/.upgrade
Copy

Das Skript zeigt die neueste verfügbare Version der verschiedenen Bereitstellungskomponenten an.

Wenn keine Upgrades verfügbar sind, sehen Sie eine Ausgabe ähnlich der folgenden:

AGENT_IMAGE_VERSION_UPGRADE=
OPERATOR_CHART_VERSION_UPGRADE=
GATEWAY_IMAGE_VERSION_UPGRADE=
DPS_CHART_VERSION_UPGRADE=
DPUI_CHART_VERSION_UPGRADE=

Andernfalls sehen Sie die Version, die von aktualisierten Komponenten verwendet wird, wie z. B.:

AGENT_IMAGE_VERSION_UPGRADE=0.17.0
OPERATOR_CHART_VERSION_UPGRADE=0.31.0
GATEWAY_IMAGE_VERSION_UPGRADE=
DPS_CHART_VERSION_UPGRADE=
DPUI_CHART_VERSION_UPGRADE=

Upgrade initiieren

Wenn die Ausgabe anzeigt, dass Upgrades verfügbar sind, führen Sie das folgende Skript aus, um das Upgrade zu starten. Ältere Openflow-Bereitstellungen verwenden möglicherweise stattdessen das Skript upgrade-data-plane.sh.

./upgrade.sh
Copy

Sie sehen eine Ausgabe ähnlich der folgenden:

openflow-data-plane-agent-aws is set to version 0.16.0
   Upgrade set to version 0.17.0
openflow-dataplane-service-chart is set to version 0.47.0
   No upgrade is available
openflow-dataplane-ui-chart is set to version 0.5.0
   No upgrade is available
openflow-runtime-gateway is set to version 2025.6.8.2
   No upgrade is available
runtime-operator-chart is set to version 0.30.0
   Upgrade set to version 0.31.0

Dann haben Sie zwei Möglichkeiten:

  • Warten Sie auf ein automatisches Upgrade: Das System wird den Upgrade-Prozess innerhalb von etwa 10 Minuten automatisch einleiten.

  • Manuelles Upgrade: Um das Upgrade sofort zu starten, führen Sie den folgenden Befehl aus:

./create.sh
Copy

Den Upgrade-Prozess überwachen

Um den Fortschritt des Upgrades zu verfolgen, verwenden Sie den Befehl journalctl:

journalctl -u openflow-apply-infrastructure -f -n 250
Copy

Ein erfolgreiches Upgrade überwachen

Ein erfolgreiches Upgrade zeigt normalerweise eine ähnliche Ausgabe wie diese:

All resources applied successfully and log uploaded to s3
openflow-apply-infrastructure.service: Deactivated successfully

Eine Laufzeit aktualisieren

Updates werden von Snowflake bereitgestellt, sowohl bei der Einführung neuer Openflow-Prozessoren oder neuerer Versionen bestehender Prozessoren als auch bei der Einführung neuer Openflow-Laufzeitfunktionen. Wenn Updates für Openflow-Laufzeiten verfügbar sind, sehen Sie ein Upgrade-Symbol neben Ihrer Laufzeit auf der Openflow-Website-UI.

Um eine Laufzeit zu aktualisieren, gehen Sie wie folgt vor:

  1. Navigieren Sie zu Openflow.

  2. Wählen Sie die Registerkarte Runtimes aus.

  3. Ein Indikator neben dem Namen der Laufzeit zeigt an, ob ein Upgrade verfügbar ist.

  4. Wählen Sie in der Zeile der Laufzeit, die Sie aktualisieren möchten, das Symbol „Weitere Optionen“.

  5. Wählen Sie Upgrade aus.

Upgrade für einen Konnektor durchführen

Konnektor-Upgrades werden von Snowflake zur Verfügung gestellt, wenn Funktionen hinzugefügt, die Verarbeitungslogik verbessert oder neue Prozessorversionen verwendet werden.

Ein Beispiel wäre das Hinzufügen der Unterstützung für eine neue API-Quellversion.

Wenn Aktualisierungen für Konnektoren verfügbar sind, sehen Sie in Ihrer Prozessgruppe im Canvas ein Upgrade-Symbol.

Bemerkung

Sie können für Konnektoren erst ein Upgrade durchführen, nachdem Sie ihre Laufzeit aktualisiert haben.

Um ein Upgrade für einen Konnektor durchzuführen, gehen Sie wie folgt vor:

  1. Navigieren Sie zu Openflow.

  2. Wählen Sie die Registerkarte Runtimes aus.

  3. Klicken Sie auf den Namen der Laufzeit, oder wählen Sie im Menü „More Options“ die Option „View Canvas“ aus, um zum Canvas zu navigieren.

  4. Suchen Sie die Prozessorgruppe(en), für die neben ihrem Namen ein roter Upgrade-Pfeil angezeigt wird.

  5. Klicken Sie mit der rechten Maustaste auf die Prozessgruppe, und wählen Sie:ui:Version » Change Version aus.

  6. Wählen Sie die neueste verfügbare Version und dann Change aus.

  7. Stellen Sie sicher, dass Ihr Konnektor auf die neueste Version aktualisiert wurde, sodass jetzt ein grünes Häkchen angezeigt wird. Sie können die Version auch überprüfen, indem Sie den Mauszeiger unten rechts in der Prozessgruppe über die Sprechblase bewegen.

Konfigurieren der Snowflake Connector Flow Registry

Wichtig

Frühe Vorschauversionen von Openflow haben keine Laufzeit für Konnektor-Upgrades konfiguriert. Wenn Sie die Option „Version“ nicht sehen, wenn Sie mit der rechten Maustaste auf eine Prozessgruppe klicken, müssen Sie die Snowflake Connector Flow Registry konfigurieren und die Versionskontrolle für vorhandene Konnektoren manuell aktivieren.

Um die Snowflake Connector Flow Registry zu konfigurieren, gehen Sie wie folgt vor:

  1. Navigieren Sie zum Canvas.

  2. Klicken Sie oben rechts auf das Menü, und wählen Sie Controller Settings aus.

  3. Wechseln Sie zur Registerkarte Registry Clients.

  4. Klicken Sie auf das +-Symbol, um einen neuen Registry-Client hinzuzufügen.

  5. Wählen Sie den ConnectorFlowRegistryClient und dann Add aus.

  6. Klicken Sie für die Zeile ConnectorFlowRegistryClient auf More Options, und wählen Sie Edit aus.

  7. Geben Sie /nifi/configuration_resources/connector_flow_registry als Wert für Storage Location ein, und wählen Sie Apply aus.

Nach der Konfiguration der Snowflake Connector Flow Registry können Sie nun die Versionskontrolle für Ihre bestehenden Konnektoren aktivieren.

Um die Versionskontrolle für bestehende Konnektoren zu aktivieren, gehen Sie wie folgt vor:

  1. Navigieren Sie zum Canvas, und suchen Sie die Prozessgruppe, der Sie die Versionskontrolle hinzufügen möchten.

  2. Klicken Sie mit der rechten Maustaste auf die Prozessgruppe, und wählen Sie:ui:Version » Set Version aus.

  3. Wählen Sie im Dialogfeld Set Version den Workflow aus, der zu Ihrer Prozessgruppe passt.

    Wählen Sie zum Beispiel sqlserver, wenn Sie den SQL Server-Konnektor verwenden.

    Beachten Sie, dass die Workflow-Namen nicht genau mit dem Namen des Konnektors übereinstimmen.

  4. Wählen Sie die neueste Version und dann Set version aus, um die Versionskontrolle zu aktivieren.

  5. Klicken Sie im Canvas erneut mit der rechten Maustaste auf die Prozessgruppe, und wählen Sie Version » Revert Local Changes aus, um die neueste Version des Konnektors anzuwenden.

  6. Überprüfen Sie die Liste der Änderungen, und wählen Sie Revert aus.

  7. Stellen Sie sicher, dass Ihr Konnektor auf die neueste Version aktualisiert wurde, sodass jetzt ein grünes Häkchen angezeigt wird. Sie können die Version auch überprüfen, indem Sie den Mauszeiger unten rechts in der Prozessgruppe über die Sprechblase bewegen.

Sprache: Deutsch