Einrichten einer Dynamic Engine und einer Dynamic Engine-Umgebung in Kubernetes

Stellen Sie einen Ihrer eigenen Kubernetes-Cluster bereit, um eine Dynamic Engine und deren Umgebung bzw. Umgebungen darauf zu implementieren.

Zum Abschließen der Implementierung müssen Sie:

die logischen Entitäten für die Engine und die Umgebungen erstellen.
der Engine Umgebungen zuweisen.
Manifest-Dateien für die Engine, die Umgebungen und deren Zuweisungen generieren.
diese Dateien auf Ihren Cluster anwenden, um die entsprechenden physischen Entitäten einzurichten.

Das Diagramm eines Dynamic Engine Workflows, der in den folgenden Abschnitten Schritt für Schritt zum Aufbau eines Dynamic Engine Ökosystems erklärt wird.

Hinzufügen einer Dynamic Engine

Fügen Sie eine logische Dynamic Engine-Entität hinzu, um eine Dynamic Engine in Ihrem Kubernetes-Cluster zu implementieren.

Before you begin

Sie müssen über die Infastrukturadministrator-Rolle (welche die Berechtigung TMC_CLUSTER_MANAGEMENT umfasst) in Talend Management Console verfügen.

Procedure

Gehen Sie zur Seite Processing (Verarbeitung).
Öffnen Sie die Registerkarte Dynamic Engines.
Klicken Sie auf Add Dynamic Engine (Dynamic Engine hinzufügen).
Geben Sie einen Namen und eine Beschreibung ein.
Der Name darf nur alphanumerische Zeichen sowie die Zeichen -, . und _ enthalten. Leerzeichen und andere Sonderzeichen sind nicht zulässig.
Klicken Sie auf Next (Weiter).
Optional: Eine Liste der verfügbaren Dynamic Engine-Umgebungen wird angezeigt. Weisen Sie eine oder mehrere Umgebungen aus dieser Liste zu, oder tun Sie dies später auf der Seite Processing (Verarbeitung) in der Registerkarte Dynamic Engines.
Klicken Sie auf Create (Erstellen), um die Erstellung der Dynamic Engine zu bestätigen.
Das Dialogfeld für die Implementierung der Dynamic Engine wird angezeigt.
Wählen Sie eine Version aus der Liste Version aus.
Standardmäßig ist die neueste Version ausgewählt.

Es wird eine ZIP-Datei mit zwei Manifestdateien generiert, die zur Implementierung der Dynamic Engine auf Ihren Kubernetes-Cluster angewendet werden. Sie müssen diese ZIP-Datei noch nicht herunterladen.

Erstellen Sie stattdessen zuerst die Dynamic Engine-Umgebungen und weisen Sie diese zu. Damit können Sie alle erforderlichen Manifestdateien zusammen herunterladen.
Schließen Sie das Dialogfeld.

Results

Der Status Ihrer Dynamic Engine wird auf New (Neu) festgelegt.

Hinzufügen einer Dynamic Engine-Umgebung

Erstellen Sie eine neue Dynamic Engine-spezifische Umgebung.

Diese Umgebung kann nur mit Dynamic Engines verwendet und jeweils nur einer Dynamic Engine zugewiesen werden.

Before you begin

Sie müssen in Talend Management Console über die Umgebungsadministrator-Rolle verfügen.

Procedure

Gehen Sie zur Seite Environments (Umgebungen).
Öffnen Sie die Registerkarte Dynamic Engine-Environments (Dynamic Engine-Umgebungen).
Klicken Sie auf Add environment (Umgebung hinzufügen).
Geben Sie einen Namen für die Umgebung ein.
Der Name darf nur alphanumerische Zeichen sowie die Zeichen -, # und _ enthalten. Führende oder nachgestellte Leerzeichen und andere Sonderzeichen sind nicht zulässig.
Geben Sie den Namen des ersten Arbeitsbereichs in der neuen Umgebung ein.
Die hierfür zulässigen Zeichen entsprechen denjenigen für den Umgebungsnamen.
Optional: Wenn ein anderer Benutzer als Verantwortlicher für den Arbeitsbereich fungieren soll, wählen Sie den entsprechenden Benutzernamen in der Dropdown-Liste aus.
Geben Sie eine Beschreibung ein.
Klicken Sie auf Add (Hinzufügen), um die vorgenommenen Änderungen zu speichern.

Results

Der Status Ihrer Dynamic Engine-Umgebung wird auf Not assigned (Nicht zugewiesen) festgelegt.

Die Umgebung wird mit dem von Ihnen angegebenen Arbeitsbereich erstellt.

Um den Arbeitsbereich für eine gemeinsame Nutzung freizugeben, klicken Sie auf den Namen der Umgebung und dann auf das nebenstehende Symbol Share workspace (Arbeitsbereich freigeben) auf der Registerkarte Workspaces (Arbeitsbereiche).

Um andere Arbeitsbereiche zu dieser neuen Umgebung hinzuzufügen, klicken Sie auf den Umgebungsnamen und anschließend auf Add workspace (Arbeitsbereich hinzufügen) auf der Registerkarte Workspaces (Arbeitsbereiche).

What to do next

Sie sind bereit, Ihre Umgebung einer Dynamic Engine zuzuweisen.

Zuweisen einer Umgebung zu einer Dynamic Engine

Weisen Sie eine oder mehrere Umgebungen zu einer Dynamic Engine zu. Die nächsten Taskausführungen dieser Umgebungen erfolgen dann in der Dynamic Engine.

Durch die Zuweisung einer Umgebung zu einer Dynamic Engine werden die bestehenden Engine-Einstellungen und Ausführungsprofile dieser Umgebung überschrieben.

Sie können einer Dynamic Engine über die Registerkarte Dynamic Enines eine oder mehrere Umgebungen zuweisen, entweder direkt aus der Liste oder aus der Schublade. Sie können dies auch beim Erstellen einer Dynamic Engine tun.

Before you begin

Sie müssen in Talend Management Console über die Umgebungsadministrator-Rolle verfügen.
Sie müssen über die Infastrukturadministrator-Rolle (TMC_CLUSTER_MANAGEMENT) verfügen, um einer Dynamic Engine Dynamic Engine-Umgebungen zuzuweisen.

Procedure

Gehen Sie zur Seite Processing (Verarbeitung).
Öffnen Sie die Registerkarte Dynamic Engines.
Halten Sie den Cursor über den Namen einer Dynamic Engine, der Sie eine Umgebung zuweisen möchten.
Klicken Sie auf die Schaltfläche , um die Seite für die Umgebungszuweisung zu öffnen.
Sie können auch auf den Namen der Dynamic Engine klicken, um das Detailfenster zu öffnen, und dort auf die Schaltfläche Manage (Verwalten) klicken.
Wählen Sie im angezeigten Dialogfeld eine oder mehrere Umgebungen aus der Liste aus.
Klicken Sie auf Assign (Zuweisen).
Klicken Sie auf Download the manifest (Manifest herunterladen), um die Manifestdateien in eine ZIP-Datei herunterzuladen.

Results

Fahren Sie mit der Anwendung der Manifestdateien fort, um die Dynamic Engine Instanz und ihre Umgebung zu implementieren.

Ändern Sie den Inhalt dieser Manifestdateien nicht. Nur die in den Dateien vordefinierte Standardkonfiguration wird unterstützt.

Implementierung von Dynamic Engine und Umgebung in Kubernetes

Wenden Sie die Manifestdateien für die Implementierung des Dynamic Engine Ökosystems an.

Prozedur

Entzippen Sie die zuvor heruntergeladene Datei.
Führen Sie in Ihrem Kubernetes-Terminal die folgenden Befehle in der hier gezeigten Reihenfolge aus, um die Dynamic Engine-Instanz einzurichten:
1. ```
kubectl apply -f custom-resource-definitions.yaml
```
  Mit dieser Manifestdatei werden zwei benutzerdefinierte Kubernetes-Ressourcendefinitionen in Ihrem Cluster erstellt: qlikruntimeinfras.qlik.com für Dynamic Engine-Ressourcen und qlikruntimes.qlik.com für Dynamic Engine-Umgebungsressourcen.
2. ```
kubectl apply -f resources.yaml
```
  Mit dieser Manifestdatei werden die Dynamic Engine-Ressourcen erstellt, um Ihren Cluster zu registrieren, Ihre Dynamic Engine zu implementieren und die Engine ihrer logischen Entität in Talend Management Console zuzuweisen. Diese Ressourcen gehören zu einer Art von QlikRuntimeInfra.
3. Am Ende der zweiten Ausführung führen Sie folgenden Befehl aus, um die Implementierung zu überprüfen:
```
kubectl wait --for=condition=Available=true -n qlik-dynamic-engine deployment/engine-operator-dp --timeout 60s
```
  Wenn nach einer Wartezeit von 60 Sekunden die folgende Antwort angezeigt wird, bestätigt dies, dass die Engine erfolgreich implementiert wurde:
```
deployment.apps/engine-operator-dp condition met
```
  Im obigen Befehl ist qlik-dynamic-engine der Namespace, der die Infrastrukturdienste gruppiert, und deployment/engine-operator-dp ist die Implementierungsressource, die überwacht wird.
Nach dem erfolgreichen Abschluss wird der Status der logischen Dynamic Engine-Entität in Talend Management Console aktiv.

Wenn Sie in Erfahrung bringen müssen, was genau in Ihrem Kubernetes-Cluster installiert wurde, gehen Sie zu Ihrer Kubernetes-Maschine und führen Sie die in dieser offiziellen Kubernetes-Dokumentation erläuterten Befehle aus.
Führen Sie den folgenden Befehl aus, um die Umgebungen einzurichten. In diesem Beispiel wurde nur eine Umgebung erstellt und zugewiesen.
```
kubectl apply -f resources-<environment_id>.yaml
```
InformationshinweisTipp:
Wenn die Engine mit mehreren Umgebungen verknüpft ist, benötigen Sie diese ID, um die korrekte Datei zu identifizieren.
Es gibt zwei Methoden zum Finden der Umgebungs-ID:
- Öffnen Sie in Talend Management Console die Detailseite der zu löschenden Umgebung. Die ID wird in der URL angezeigt. In der folgenden URL beispielsweise:
  https://app.eu.cloud.talend.com/tmc/environments/dynamic-engine-environments/66f2c0bb3e063d3518122259/overview
  Das Segment 66f2c0bb3e063d3518122259 ist die Umgebungs-ID.
- Verwenden Sie den Befehl:
  kubectl get qlikruntime.qlik.com
  Damit wird der Ressourcenname oder der Namespace-Name zurückgegeben, in dem die ID enthalten ist. Beispiel: qlik-processing-env-66f2c0bb3e063d3518122259.
Am Ende der Ausführung führen Sie folgenden Befehl aus, um die Implementierung zu überprüfen:
```
kubectl wait --for=condition=RUNNING=true --all qlikruntime --timeout 300s
```
Während 300 Sekunden sucht dieser Befehl nach allen Ressourcen der Art QlikRuntime. Wenn eine Antwort wie die Folgende angezeigt wird, bestätigt dies, dass die Engine-Umgebung erfolgreich implementiert wurde:
```
qlikruntime.qlik.com/qlik-processing-env-66f2c0bb3e063d3518122259 condition met
```
In dieser Antwort lautet der Name der überwachten Ressource qlik-processing-env-664b0bbd6c6f5522732e055d. Der Name wird auch als Namespace-Name verwendet und gruppiert alle Dienste, die der Dynamic Engine-Umgebungsressource zugeordnet sind.

Optional: Wenn Sie die obige Bestätigung nicht erhalten haben, weist die Implementierung Probleme auf. Führen Sie den folgenden Befehl aus, um das Objekt „serviceStatus“ der Umgebungsressource zu prüfen:

kubectl get qlikruntime qlik-processing-env-664b0bbd6c6f5522732e055d -o json | jq -r '.status'

In diesem Befehl stellt qlikruntime die Art benutzerdefinierter Ressourcen dar, die Dynamic Engine-Umgebungen vorbehalten ist, und wie im vorherigen Beispiel ist qlik-processing-env-664b0bbd6c6f5522732e055d der Ressourcen- und der Namespace-Name der Umgebung.

Die folgende Meldung zeigt ein Beispiel des Fehlers für den Dienst „di-job-deployer“ im Objekt „serviceStatus“. Das Feld „jobErrorMessage“ enthält weitere Details über den Fehler, der während der Implementierung beobachtet wurde, und gibt an, dass das erwartete Diagramm helm nicht gefunden wurde.

Beachten Sie, dass im folgenden Beispiel einige Zeilen übersprungen wurden.

{
  "conditions": [
    {
      "lastTransitionTime": "2024-05-30T13:05:25Z",
      "message": "Service is not deployed",
      "reason": "Deployment_not_found",
      "status": "True",
      "type": "NOT_DEPLOYED"
    }
  ],
  "serviceStatus": {
    ...
    "di-job-deployer": {
      "conditions": [
        ...
        {
          "lastTransitionTime": "2024-05-30T13:06:39Z",
          "message": "Service is in error",
          "reason": "Pod_failed",
          "status": "False",
          "type": "IN_ERROR"
        }
      ],
      "creationDate": "2024-05-30T13:05:25Z",
      "jobErrorMessage": "Error: release: not found\nUpgrading...\nupgrade 
      result: Release \"di-job-deployer-92d6e127-e070-4264-a9e8-00adbbbfbc03\" does not exist. 
      Installing it now.\nError: failed to download 
      ...
      \nError: failed to download 
      \"https://artifactory.datapwn.com/artifactory/tlnd-helm-ce-dev/dpe-di-job-deployer-2.0.0.tgz\
      "\nexit_code: 1\n",
      "jobStatus": "FAILED",
      "lastUpdateDate": "2024-05-30T13:01:52Z"
    },
      ...
    }
  }
}

Wenden Sie sich in diesem Fall an das Supportteam, um die Manifestdatei der Dynamic Engine-Umgebung prüfen zu lassen. Wenn Sie dazu angewiesen werden, heben Sie die Zuweisung der Umgebung auf und weisen Sie sie erneut zu, um eine neue Manifestdatei zu generieren.

Ergebnisse

Nachdem dies erfolgreich durchgeführt wurde, sind die Dynamic Engine-Umgebungsdienste in Ihrem Cluster installiert und stellen eine Verbindung zur Dynamic Engine her.

In Talend Management Console ändert sich der Status dieser Umgebung zu Ready (Bereit), was bestätigt, dass sie zum Ausführen von Tasks oder Plänen bereit ist.

Wenn die Manifestimplementierung fehlschlägt oder die Dynamic Engine-Dienste von der Dynamic Engine getrennt werden, ändert sich der Status zu Not ready (Nicht bereit).

Nächste Maßnahme

Da die Dynamic Engine erfolgreich auf Ihrem Kubernetes-Cluster implementiert, mit Talend Management Console verbunden und einer Dynamic Engine-Umgebung zugewiesen wurde, ist sie bereit, Jobtasks oder Pläne auszuführen, wie Sie dies üblicherweise auf Standard-Engines tun. Detaillierte Informationen zum Hinzufügen von Tasks in einer Dynamic Engine-Umgebung zur Ausführung finden Sie unter Hinzufügen von Tasks zu Dynamic Engine-Umgebungen.

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab