Accéder au contenu principal Passer au contenu complémentaire

Déploiement par défaut avec Helm

Dernière mise à jour : 2026-11-10

Les charts Helm vous permettent de déployer un Dynamic Engine avec des espaces de noms, des noms de services et des configurations de stockage personnalisé·es.

Les charts Helm dans Dynamic Enginesont disponibles sous forme d'images dans oci://ghcr.io/talend/helm/ et comprennent :

  • dynamic-engine-crd : Définitions des CRD (Custom Resources Definition) des services de Dynamic Engine.
  • dynamic-engine : Chart Helm d'une instance de Dynamic Engine.
  • dynamic-engine-environment : Chart Helm des environnements de Dynamic Engine.

Avant de commencer

  • Un cluster Kubernetes sans installation préalable des services de Dynamic Engine. Les charts Helm de Dynamic Engine seront installés dans ce cluster.
  • Un accès privilégié à ce cluster Kubernetes.
  • Outils en ligne de commande installés : kubectl et helm. La version de Helm doit être 3.17.2 ou supérieure.

Pourquoi et quand exécuter cette tâche

La procédure suivante décrit le déploiement par défaut via uniquement les fichiers de valeurs Helm par défaut.

Note InformationsImportant :
  • Dynamic Engine versions earlier than 1.6:

    Dynamic Engine always requires persistent shared storage.

  • Dynamic Engine 1.6.x:

    Persistent shared storage is enabled by default. You can disable it for Dynamic Engine internal services by adding --set configuration.persistence.enabled=false to both the helm install dynamic-engine and helm install dynamic-engine-environment commands in this procedure.

  • Dynamic Engine 1.7.0 or later:

    Persistence is disabled by default. The default deployment does not create PVCs or PVs and does not require distributed storage.

    To persist DI (data integration) Job data, add this configuration to the environment values file:

    configuration:
       persistence:
       enabled: true
       defaultStorageClassName: <storage-class-name-or-null> 

    To persist images in the embedded registry (for non-production use only), configure its persistence separately in the engine values file:

    configuration:
      dockerRegistry:
      persistence:
      enabled: true
      persistence:
      defaultStorageClassName: <storage-class-name-or-null>

    If the embedded registry pod restarts without persistence, its images are lost. For production use, use an external registry or enable persistence for the embedded registry.

Procédure

  1. Utilisez le chart Helm dynamic-engine-crd pour installer les définitions de ressources personnalisées de Dynamic Engine d'une version de Helm donnée.
    1. La version du chart à 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 ${DYNAMIC_ENGINE_VERSION}
      • Visualisez la version directement depuis Talend Management Console ou consultez le Dynamic Engine journal de modification de la version du chart dans votre version de Dynamic Engine.
      • Utilisez un appel d'API pour l'endpoint de version de Dynamic Engine (en anglais).
    2. 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 ${DYNAMIC_ENGINE_VERSION}
      Définissez ${DYNAMIC_ENGINE_VERSION} sur la version de chart supportée par votre version du Dynamic Engine.

      Si vous ne spécifiez pas la version, vous installez la dernière version disponible du chart dynamic-engine-crd.

  2. Sur la machine de Kubernetes, décompressez le fichier ZIP de déploiement Helm précédemment téléchargé.
  3. Exécutez cette commande pour déployer l'instance du moteur :
    helm install dynamic-engine-$DYNAMIC_ENGINE_ID \
      oci://ghcr.io/talend/helm/dynamic-engine \
      --version ${DYNAMIC_ENGINE_VERSION} -f $DYNAMIC_ENGINE_ID-values.yaml

    Remplacez $DYNAMIC_ENGINE_ID par l'ID de Dynamic Engine, par exemple, c-m-sjufu4qy.

  4. Vérifiez le statut du Dynamic Engine en exécutant cette commande :
    kubectl get de -A
    Vous devriez voir des informations semblables à celles-ci :
    NAME                               VERSION   STATUS    LAST UPDATE
    qlik-dynamic-engine-$DYNAMIC_ENGINE_ID   0.22.0    RUNNING   2m
  5. Exécutez cette commande pour déployer l'environnement de Dynamic Engine.
    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

    Remplacez $DYNAMIC_ENGINE_ENVIRONMENT_ID par l'ID de l'environnement Dynamic Engine, par exemple, 67f7d562ffd7c3525a902542.

  6. Vérifiez les ressources d'environnement.
    1. Exécutez la commande suivante :
      kubectl get dee -A
      Vous devriez voir des informations semblables à celles-ci :
      NAME                                           VERSION   STATUS    LAST UPDATE
      qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID   0.22.0    RUNNING   3m
    2. Dans Talend Management Console, vérifiez le statut de l'environnement de Dynamic Engine.
      Le statut s'affiche comme Ready (Prêt).

Résultats

Cela fait, les services d'environnement de Dynamic Engine sont installés dans votre cluster et connectés au Dynamic Engine.

Dans Talend Management Console, le statut de cet environnement devient Ready (Prêt), confirmant qu'il est prêt à exécuter des tâches ou des plans.

Si le déploiement échoue ou si les services du Dynamic Engine sont dissociés du Dynamic Engine, le statut devient Not ready (Pas prêt).

Que faire ensuite

Comme le Dynamic Engine a bien été déployé dans votre cluster Kubernetes, connecté à Talend Management Console et associé à un environnement de Dynamic Engine, il est à présent prêt à exécuter des tâches ou des plans, comme un moteur standard. Pour savoir comment ajouter la tâche à l'environnement du Dynamic Engine pour exécution, consultez Ajouter des tâches à un environnement de Dynamic Engine.

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.