Utiliser Helm avec Dynamic Engine

Bêta

À partir de la version 0.20.0 (R2025-03) de Dynamic Engine, vous pouvez configurer une instance de Dynamic Engine et ses environnements dans Kubernetes à l'aide de charts Helm dans Dynamic Engine.

L'utilisation de charts Helm dans Dynamic Engine est une approche avancée pour déployer les instances de Dynamic Engine.

Les charts Helm dans Dynamic Enginesont disponibles en tant qu'images dans oci://ghcr.io/talend/helm/ et comprennent :

dynamic-engine-crd : définitions des CRD (Custom Resources Definition) pour les services de Dynamic Engine.
dynamic-engine : chart Helm pour une instance de Dynamic Engine.
dynamic-engine-environment : chart Helm pour les environnements de Dynamic Engine.

Avant de commencer

Un cluster Kubernetes (en version 1.28 ou supérieure) sans installation préalable de Dynamic Engine. Les charts Helm de Dynamic Engine seront installés dans ce cluster.
Un accès privilégié à ce cluster Kubernetes.
Les outils suivants d'invite de commande installés : kubectl et helm. La version de Helm doit être 3.17.2 ou supérieure.
Une instance existante de Dynamic Engine avec au moins un environnement attribué dans Talend Management Console. Pour créer une instance de Dynamic Engine et attribuer des environnements, consultez Ajouter un Dynamic Engine.

Générer un fichier de valeurs Helm pour le déploiement de Dynamic Engine

Bêta

Un fichier de valeurs Helm contient les informations de configuration, comme les ID et les clés d'amorçage (bootstrap keys) spécifiques à votre instance de Dynamic Engine et à ses environnements associés.

Pourquoi et quand exécuter cette tâche

Après avoir configuré votre instance de Dynamic Engine avec ses environnements attribués dans Talend Management Console, vous pouvez générer les fichiers de valeurs Helm à l'aide de l'endpoint d'APi dédié (en anglais).

Par exemple, si l'ID de Dynamic Engine est c-m-sjufu4qy et qu'il a un environnement associé. Utilisez cette API pour générer une archive contenant les fichiers de valeurs Helm.

Procédure

Dans un terminal, exécutez la commande cURL suivante :
```
curl -H "Authorization: Bearer your_personal_access_token" \ -X POST \ https://api.eu.cloud.talend.com/processing/runtimes/dynamic-engines/c-m-sjufu4qy/actions/generate-helm \ -H "Content-Type: application/json" \ -d "{\"generateNewPairingKey\": true}"
```
Note InformationsConseil : Pour le premier déploiement, configurer l'option generateNewPairingKey n'est pas obligatoire. Cette option génère de nouvelles clés d'appairage pour tous les environnements de Dynamic Engine attribués à l'instance de Dynamic Engine.
Trouvez le fichier ZIP généré nommé c-m-sjufu4qy.zip et extrayez-le.
Ce ZIP contient les fichiers suivants :
- Pour le Dynamic Engine : c-m-sjufu4qy-helm-values/c-m-sjufu4qy-values.yaml
- Pour l'environnement de Dynamic Engine : c-m-sjufu4qy-helm-values/67f7d562ffd7c3525a902542-values.yaml (un fichier par environnement distinct, avec l'ID de l'environnement dans le nom du fichier).

Résultats

Vous devrez utiliser ces fichiers de valeurs Helm plus tard, pour le déploiement de Dynamic Engine.

Installer des définitions de ressources personnalisées (CRD) de Dynamic Engine avec un chart Helm

Bêta

Utilisez le chart Helm dynamic-engine-crd pour installer les définitions de ressources personnalisées de Dynamic Engine.

Procédure

La version du graphique à utiliser est la même que celle de votre Dynamic Engine. Vous pouvez trouver cette version via les méthodes suivantes :
- Exécutez la commande Helm suivante :
```
helm show chart oci://ghcr.io/talend/helm/dynamic-engine --version $DYN_ENGINE_VERSION
```
- Visualisez la version directement depuis Talend Management Console ou consultez le Dynamic Engine journal de modification de la version du graphique dans votre version de Dynamic Engine.
- Utilisez un appel d'API pour l'endpoint de version de Dynamic Engine (en anglais).
Dans le cluster Kubernetes, exécutez la commande suivante pour installer le chart Helm dans une version donnée :
```
helm install dynamic-engine-crd oci://ghcr.io/talend/helm/dynamic-engine-crd --version <version>
```
Remplacez <version> par la version du graphique supportée par votre version de Dynamic Engine.
Si vous ne spécifiez pas la version, vous installez la dernière version disponible du graphique dynamic-engine-crd.

Installer Dynamic Engine et son environnement associé

Bêta

Utilisez les charts Helm dynamic-engine et dynamic-engine-environment pour déployer l'instance de Dynamic Engine et son environnement.

Pourquoi et quand exécuter cette tâche

Comme précédemment expliqué, dans cet exemple, les fichiers de valeurs Helm sont :

Pour le Dynamic Engine : c-m-sjufu4qy-helm-values/c-m-sjufu4qy-values.yaml
Pour l'environnement de Dynamic Engine : c-m-sjufu4qy-helm-values/67f7d562ffd7c3525a902542-values.yaml

Procédure

Exécutez cette commande pour déployer l'instance du moteur :

helm install dynamic-engine -f c-m-sjufu4qy-helm-values/c-m-sjufu4qy-values.yaml oci://ghcr.io/talend/helm/dynamic-engine

Vérifiez le statut de Dynamic Engine :

Via Helm :
```
helm status dynamic-engine
```
Via kubectl :
```
kubectl get de
```

Vous devriez voir des informations semblables à celles-ci :

NAME                               VERSION   STATUS    LAST UPDATE
qlik-dynamic-engine-c-m-sjufu4qy   0.20.0    RUNNING   2m

Exécutez cette commande pour déployer l'environnement de Dynamic Engine.

helm install dyn-engine-env -f c-m-sjufu4qy-helm-values/67f7d562ffd7c3525a902542-values.yaml oci://ghcr.io/talend/helm/dynamic-engine-environment

Vérifiez les ressources d'environnement.
1. Exécutez la commande suivante :
```
kubectl get dee
```
  Vous devriez voir des informations semblables à celles-ci :
```
NAME                                           VERSION   STATUS    LAST UPDATE
qlik-processing-env-67f7d562ffd7c3525a902542   0.20.0    RUNNING   <invalid>
```
2. Dans Talend Management Console, vérifiez le statut de l'environnement de Dynamic Engine.
  Le statut doit être Active (Actif).

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici