Configurer des espaces de noms personnalisés

Spécifiez vos noms d'espaces de noms pour le Dynamic Engine et son environnement.

Avant de commencer

Les définitions des ressources personnalisées dynamic-engine-crd doivent avoir été installées à l'aide du chart Helm oci://ghcr.io/talend/helm/dynamic-engine-crd. Si ce n'est pas le cas, exécutez les commandes suivantes pour l'installation :
1. Trouvez la version du chart à utiliser :
  - Exécutez la commande Helm suivante :
    helm show chart oci://ghcr.io/talend/helm/dynamic-engine-crd --version <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).
2. 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 <helm_chart_version>
```
  Remplacez <helm_chart_version> par la version du 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.

Pourquoi et quand exécuter cette tâche

Par défaut, les espaces de noms suivants sont créés :

qlik-dynamic-engine : pour les services d'infrastructure du Dynamic Engine.
qlik-processing-env-<env-id> : pour chaque environnement du Dynamic Engine, où <env-id> est l'identifiant de l'environnement.

Avec le déploiement Helm, vous pouvez définir des noms personnalisés pour ces espaces de noms, afin de simplifier la gestion de vos espaces de noms.

Remarque : Modifier le nom de l'espace de noms n'est possible que lors du déploiement du moteur.

Procédure

Sur la machine de Kubernetes, décompressez le fichier ZIP de déploiement Helm précédemment téléchargé.
Créez un fichier de valeurs personnalisées pour l'espace de noms personnalisé du Dynamic Engine.
Exécutez la commande suivante dans votre terminal.
```
cat <<EOF > $DYNAMIC_ENGINE_ID-custom-namespace-values.yaml
global:
  namespace:
    create: false
    name: <engine-custom-namespace>
EOF        
```
Par exemple, $DYNAMIC_ENGINE_ID est c-m-sjufu4qy et <engine-custom-namespace> est dynamic-engine-dev. Cela crée un fichier de valeurs nommé c-m-sjufu4qy-custom-namespace-values.yaml. Ce fichier contient :
```
global:
  namespace:
    create: false
    name: dynamic-engine-dev
```

Créez l'espace de noms personnalisé dans votre cluster Kubernetes.

kubectl create namespace <engine-custom-namespace>

Déployez le Dynamic Engine avec votre configuration personnalisée de l'espace de noms.

helm install dynamic-engine-$DYNAMIC_ENGINE_ID -f $DYNAMIC_ENGINE_ID-values.yaml  \
-f $DYNAMIC_ENGINE_ID-custom-namespace-values.yaml \
oci://ghcr.io/talend/helm/dynamic-engine \
--version $DYNAMIC_ENGINE_VERSION

Créez un fichier de valeurs personnalisées pour l'espace de noms personnalisé de l'environnement.
Exécutez les commandes suivantes dans votre terminal.
```
cat <<EOF > $DYNAMIC_ENGINE_ENVIRONMENT_ID-custom-namespace-values.yaml
global:
  namespace:
    create: false
    name: <environment-custom-namespace>

dynamicEngine:
  namespace:
    name: <engine-custom-namespace>
EOF       
```
Assurez-vous d'utiliser le même nom d'espace de noms personnalisé du moteur pour <engine-custom-namespace> et celui précédemment créé. Si vous utilisez un nom différent, l'environnement ne peut être déployé.
Par exemple, $DYNAMIC_ENGINE_ENVIRONMENT_ID est 67f7d562ffd7c3525a902542, <environment-custom-namespace> est dynamic-engine-dev-env-1 et engine-custom-namespace> est dynamic-engine-dev, exactement comme le nom de l'espace de noms personnalisé du moteur dans les exemples précédents. Cela crée un fichier de valeurs nommé c-m-sjufu4qy-custom-namespace-values.yaml. Ce fichier contient :
```
global:
  namespace:
    create: false
    name: dynamic-engine-dev-env-1
dynamicEngine:
  namespace:
    name: dynamic-engine-dev
```
Créez l'espace de noms de l'environnement personnalisé dans votre cluster Kubernetes.
```
kubectl create namespace <environment-custom-namespace>            
```

Déployez l'environnement du Dynamic Engine avec votre configuration personnalisée de l'espace de noms.

helm install dynamic-engine-environment-$DYNAMIC_ENGINE_ENVIRONMENT_ID -f $DYNAMIC_ENGINE_ENVIRONMENT_ID-values.yaml  \
-f $DYNAMIC_ENGINE_ENVIRONMENT_ID-custom-namespace-values.yaml \
oci://ghcr.io/talend/helm/dynamic-engine-environment \
--version $DYNAMIC_ENGINE_VERSION

Conseil : Si vous avez plusieurs environnements de Dynamic Engine pour le même Dynamic Engine, répétez ces étapes pour créer un nom d'espace de noms personnalisé pour chaque environnement.

Vérifiez le statut de votre Dynamic Engine et de ses environnements.

kubectl get dynamicengines.apps.qlik.com -n <engine-custom-namespace>
kubectl get dynamicengineenvs.apps.qlik.com -n <environment-custom-namespace>

Vous devriez voir des informations semblables à celles-ci :

NAME                               VERSION     STATUS    LAST UPDATE
qlik-dynamic-engine-$DYNAMIC_ENGINE_ID   0.22.0      RUNNING   5 minutes

NAME                   VERSION  STATUS    LAST UPDATE
<environment-resource-name>   0.22.0   RUNNING   3 minutes

Le nom <environment-resource-name> est le même que le nom de l'espace de noms personnalisé de l'environnement, par exemple, dynamic-engine-dev-env-1.

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.

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