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

Déployer Dynamic Engine avec les revendications PersistentVolumeClaims existantes

Dernière mise à jour : 2026-11-10
Configurez les charts Helm Dynamic Engine de sorte qu'ils référencent les revendications PersistentVolumeClaims existantes par leur nom au lieu d'utiliser le provisioning StorageClass dynamique.

Avant de commencer

  • Les trois ressources PersistentVolumeClaim (job-data, archive et custom-resources) sont créées et à l'état Bound dans l'espace de noms de l'environnement. Si vous utilisez docker-registry, la revendication docker-registry doit également être à l'état Bound dans l'espace de noms du moteur.

Pourquoi et quand exécuter cette tâche

Utilisez cette procédure lorsque le stockage est déjà provisionné dans votre cluster, par exemple après avoir configuré EKS avec Amazon S3 (consultez Configurer Amazon EKS avec S3) ou un autre système de stockage pré-provisionné. Dans ce modèle, les charts Helm Dynamic Engine se lient aux revendications PersistentVolumeClaims nommées lors du déploiement au lieu de demander un stockage auprès d'une StorageClass. Il s'agit du modèle de provisioning statique. Pour le modèle de provisioning dynamique, dans lequel Kubernetes crée automatiquement des volumes à partir d'une StorageClass, consultez Provisionner une classe de stockage dédiée aux services d'environnements du Dynamic Engine.

Le chart Dynamic Engine (pour le volume de registre embarqué) et le chart Environnement Dynamic Engine (pour les trois volumes de traitement) doivent être configurés séparément.

Note InformationsImportant : When persistent shared storage is enabled (configuration.persistence.enabled=true), which is the default in Dynamic Engine 1.6.x or older versions, this procedure is required for S3 deployments. When persistence is disabled (configuration.persistence.enabled=false), Dynamic Engine does not require PVC setup for its own services. However, you should still set up static PVCs if your Talend Management Console tasks require persistent storage or if you want to preserve task data on S3.

Procédure

  1. Définissez les variables d'environnement de votre déploiement :
    export DYNAMIC_ENGINE_VERSION=<your-dynamic-engine-version>
    export DYNAMIC_ENGINE_ID=<your-dynamic-engine-id>
    export DYNAMIC_ENGINE_ENVIRONMENT_ID=<your-dynamic-engine-environment-id>

    Remplacez les valeurs des espaces de noms par votre version Dynamic Engine, l'ID de moteur et l'ID d'environnement réels.

  2. Vérifiez que les revendications PersistentVolumes et PersistentVolumeClaims requises existent et qu'elles sont à l'état Bound :
    kubectl get pv

    Vérifiez que la sortie liste les volumes prévus avec le statut Bound et les espaces de noms de revendication corrects. Par exemple :

    NAME               CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM
    docker-registry    1200Gi     RWX            Retain           Bound    qlik-dynamic-engine/docker-registry
    archive            1200Gi     RWX            Retain           Bound    qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID/archive
    custom-resources   1200Gi     RWX            Retain           Bound    qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID/custom-resources
    job-data           1200Gi     RWX            Retain           Bound    qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID/job-data
    Note InformationsRemarque : The 1200Gi capacity value is required by the Kubernetes API but is not enforced. For S3-backed volumes, actual storage capacity is determined by the S3 bucket, not by this field.

Configurer et déployer le chart Dynamic Engine

  1. Créez un fichier de valeurs personnalisées pour le chart Dynamic Engine, spécifiant le nom de revendication docker-registry :
    cat <<EOF > $DYNAMIC_ENGINE_ID-custom-set-static-pvc-values.yaml
    configuration:
      dockerRegistry:
        persistence:
          existingClaim: docker-registry
    EOF
  2. Déployez Dynamic Engine à l'aide du fichier de valeurs de base et du fichier de valeurs personnalisées :
    helm upgrade --install dynamic-engine-$DYNAMIC_ENGINE_ID \
      -n qlik-dynamic-engine \
      -f $DYNAMIC_ENGINE_ID-values.yaml \
      -f $DYNAMIC_ENGINE_ID-custom-set-static-pvc-values.yaml \
      oci://ghcr.io/talend/helm/dynamic-engine \
      --version $DYNAMIC_ENGINE_VERSION

Configurer et déployer le chart Environnement Dynamic Engine

  1. Créez un fichier de valeurs personnalisées pour le chart Environnement Dynamic Engine, spécifiant les trois noms de revendication de volume de traitement :
    cat <<EOF > $DYNAMIC_ENGINE_ENVIRONMENT_ID-custom-set-static-pvc-values.yaml
    configuration:
      persistence:
        persistentVolumeClaims:
          job_data:
            persistentVolumeClaimName: job-data
          archive:
            persistentVolumeClaimName: archive
          custom_resources:
            persistentVolumeClaimName: custom-resources
    EOF
    Note InformationsRemarque : The Helm chart API requires underscores for the persistentVolumeClaims keys (job_data, custom_resources). The corresponding PersistentVolumeClaim names use hyphens (job-data, custom-resources). This asymmetry is intentional.
  2. Déployez l'Environnement Dynamic Engine à l'aide du fichier de valeurs de base et du fichier de valeurs personnalisées :
    helm upgrade --install dynamic-engine-environment-$DYNAMIC_ENGINE_ENVIRONMENT_ID \
      -n qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID \
      -f $DYNAMIC_ENGINE_ENVIRONMENT_ID-values.yaml \
      -f $DYNAMIC_ENGINE_ENVIRONMENT_ID-custom-set-static-pvc-values.yaml \
      oci://ghcr.io/talend/helm/dynamic-engine-environment \
      --version $DYNAMIC_ENGINE_VERSION

Résultats

Dynamic Engine et son environnement sont maintenant exécutés avec les revendications PersistentVolumeClaims. Vérifiez que le pod docker-registry de l'espace de noms qlik-dynamic-engine et le pod dpe-di-job-deployer de l'espace de noms qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID sont en cours d'exécution.

Que faire ensuite

Exécutez les commandes suivantes pour vérifier que les pods sont exécutés dans les deux espaces de noms :

kubectl get pods -n qlik-dynamic-engine
kubectl get pods -n qlik-processing-env-$DYNAMIC_ENGINE_ENVIRONMENT_ID

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.