Configurer des espaces de noms personnalisés

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

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

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 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 <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. 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 <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.
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 > <engine-id>-custom-namespace-values.yaml
global:
  namespace:
    create: false
    name: <engine-custom-namespace>
EOF        
```
Par exemple, <engine-id> est c-m-sjufu4qy et <engine-custom-namespace> est dyn-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: dyn-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 dyn-engine-<engine-id> -f <engine-id>-values.yaml  \
-f <engine-id>-custom-namespace-values.yaml \
oci://ghcr.io/talend/helm/dynamic-engine \
--version <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 > <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, <environment-id> est 67f7d562ffd7c3525a902542, <environment-custom-namespace> est dyn-engine-dev-env-1 et engine-custom-namespace> est dyn-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: dyn-engine-dev-env-1
dynamicEngine:
  namespace:
    name: dyn-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 dyn-engine-env-<environment-id> -f <environment-id>-values.yaml  \
-f <environment-id>-custom-namespace-values.yaml \
oci://ghcr.io/talend/helm/dynamic-engine-environment \
--version <engine-version>                  
```
Note InformationsConseil : 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-<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, dyn-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