# Helm-Standardimplementierung

Mit dem Helm-Chart können Sie Dynamic Engine mit benutzerdefinierten Namespaces, Dienstnamen und Speicherkonfigurationen bereitstellen.

InformationshinweisTipp: Info über Helm und Kubectl:

Es sind zwei Optionen für die Implementierung Ihres Dynamic Engine-Öksystems. Die Helm-Implementierung wird empfohlen.

* Wenn Sie Kubectl wählen, überspringen Sie diesen Abschnitt und wechseln Sie zu [Anhang: klassische Kubectl-Implementierung](https://help.qlik.com/talend/de-DE/dynamic-engine-configuration-guide/Cloud/deploy-with-standard-manifest-files "Wenden Sie die Manifestdateien für die Implementierung des Dynamic Engine Ökosystems an.").
* Wenn Sie den ausgewählten Bereitstellungstyp für Ihr Dynamic Engine und seine Umgebung ändern möchten, wechseln Sie zu [Ändern des Bereitstellungstyps eines Dynamic Engine](https://help.qlik.com/talend/de-DE/dynamic-engine-configuration-guide/Cloud/change-deployment-type-of-dynamic-engine "Sie können den Bereitstellungstyp ändern, der bereits für Ihr Dynamic Engine und seine Umgebung(en) ausgewählt ist. Diese Änderung erfordert einen neuen Download für eine neue Bereitstellung.").

Dynamic Engine Helm-Charts sind als Images unter oci://ghcr.io/talend/helm/ verfügbar. Dazu zählen:

* dynamic-engine-crd: benutzerdefinierte Core-Ressourcendefinitionen für Dynamic Engine-Services.
* dynamic-engine: Helm-Chart für eine Dynamic Engine-Instanz.
* dynamic-engine-environment: Helm-Chart für Dynamic Engine-Umgebungen.

## Vorbereitungen

* Ein Kubernetes-Cluster ohne vorhandene Dynamic Engine-Dienste. Dynamic Engine Helm-Charts werden in diesem Cluster installiert.
* Privilegierter Zugriff auf diesen Kubernetes-Cluster.
* Installierte Befehlszeilen-Tools: kubectl und helm. Die Helm-Version muss 3.17.2 oder höher sein.

## Warum und wann dieser Vorgang ausgeführt wird

Das folgende Verfahren stellt die Standardimplementierung dar, d. h. das Implementieren von Dynamic Engine und ihrer Umgebung ohne Anpassung. Es werden nur Standard-Helm-Wertedateien verwendet.

## Prozedur

1. Verwenden Sie das Helm-Chart dynamic-engine-crd, um die benutzerdefinierten Dynamic Engine-Ressourcendefinitionen einer bestimmten Helm-Version zu installieren.
   1. Die zu verwendende Diagrammversion entspricht Ihrer Dynamic Engine-Version. Sie finden diese Version anhand einer der folgenden Methoden:
      * Führen Sie den folgenden Helm-Befehl aus:
        ```
        helm show chart oci://ghcr.io/talend/helm/dynamic-engine --version ${DYNAMIC_ENGINE_VERSION}
        ```
      * Sehen Sie die Version direkt über Talend Management Console ein oder suchen Sie im [Dynamic Engine Änderungs-Log](https://help.qlik.com/talend/en-US/dynamic-engine-changelog/Cloud/dynamic-engine-v0-21-0-release-changelog?tr=de-DE) nach der in Ihrer Dynamic Engine-Version enthaltenen Diagrammversion.
      * Verwenden Sie einen API-Aufruf an [den Dynamic Engine-Versionsendpunkt](https://talend.qlik.dev/apis/dynamic-engine/2021-03/#operation_return-all-supported-dynamic-engine-versions).
   2. Führen Sie im Kubernetes-Cluster den folgenden Befehl aus, um das Helm-Chart einer bestimmten Version zu installieren:
      ```
      helm install dynamic-engine-crd oci://ghcr.io/talend/helm/dynamic-engine-crd \
        --version ${DYNAMIC_ENGINE_VERSION}
      ```

      Ersetzen Sie ${DYNAMIC\_ENGINE\_VERSION} durch die Diagrammversion, die von Ihrer Dynamic Engine-Version unterstützt wird.

      Wenn die Version nicht angegeben wird, installieren Sie die neueste verfügbare dynamic-engine-crd-Diagrammversion.
2. Entpacken Sie auf dem Kubernetes-Rechner die Helm-Implementierungs-ZIP-Datei, die Sie zuvor heruntergeladen haben.
3. Führen Sie den folgenden Befehl aus, um die Engine-Instanz bereitzustellen:
   ```
   helm install dynamic-engine-$DYNAMIC_ENGINE_ID \
     oci://ghcr.io/talend/helm/dynamic-engine \
     --version ${DYNAMIC_ENGINE_VERSION} -f $DYNAMIC_ENGINE_ID-values.yaml
   ```

   Ersetzen Sie $DYNAMIC\_ENGINE\_ID durch die Dynamic Engine-ID, beispielsweise c-m-sjufu4qy.
4. Überprüfen Sie den Dynamic Engine-Status durch Ausführen dieses Befehls:
   ```
   kubectl get de -A
   ```

   Die angezeigten Informationen gleichen den Folgenden:
   ```
   NAME                               VERSION   STATUS    LAST UPDATE
   qlik-dynamic-engine-$DYNAMIC_ENGINE_ID   0.22.0    RUNNING   2m
   ```
5. Führen Sie diesen Befehl aus, um die Dynamic Engine-Umgebung bereitzustellen.
   ```
   helm install dynamic-engine-environment-$DYNAMIC_ENGINE_ENVIRONMENT_ID \
     oci://ghcr.io/talend/helm/dynamic-engine-environment \
     --version ${DYNAMIC_ENGINE_VERSION} -f $DYNAMIC_ENGINE_ENVIRONMENT_ID-values.yaml
   ```

   Ersetzen Sie $DYNAMIC\_ENGINE\_ENVIRONMENT\_ID durch die Dynamic Engine-Umgebungs-ID, beispielsweise 67f7d562ffd7c3525a902542.
6. Überprüfen Sie die Umgebungsressourcen.
   1. Führen Sie den folgenden Befehl aus:
      ```
      kubectl get dee -A
      ```

      Die angezeigten Informationen gleichen den Folgenden:
      ```
      NAME                                           VERSION   STATUS    LAST UPDATE
      qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID   0.22.0    RUNNING   3m
      ```
   2. Überprüfen Sie in Talend Management Console den Dynamic Engine-Umgebungsstatus.

      Der Status sollte Ready (Bereit) lauten.

## 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 Bereitstellung fehlschlägt oder die Dynamic Engine-Dienste von der Dynamic Engine getrennt werden, ändert sich der Status in 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](https://help.qlik.com/talend/en-US/dynamic-engine-configuration-guide/Cloud/adding-task-in-dynamic-engine-environment?l=de-DE).