Setting up custom namespaces

Specify your own namespace names for both the Dynamic Engine and its environment.

Before you begin

The dynamic-engine-crd custom resource definitions must have been installed using the oci://ghcr.io/talend/helm/dynamic-engine-crd helm chart. If not, run the following commands for the installation:
1. Find the chart version to be used:
  - Run the following Helm command:
    helm show chart oci://ghcr.io/talend/helm/dynamic-engine-crd --version <engine_version>
  - See the version directly from Talend Management Console or check the Dynamic Engine changelog for the chart version included in your Dynamic Engine version.
  - Use an API call to the Dynamic Engine version endpoint.
2. Run the following command to install the Helm chart of a given version:
```
helm install dynamic-engine-crd oci://ghcr.io/talend/helm/dynamic-engine-crd --version <helm_chart_version>
```
  Replace <helm_chart_version> with the chart version supported by your Dynamic Engine version.
  Without specifying the version, you install the latest available dynamic-engine-crd chart version.

About this task

By default, the following namespaces are created:

qlik-dynamic-engine: for Dynamic Engine's infrastructure services.
qlik-processing-env-<env-id>: for each Dynamic Engine environment, where <env-id> is the environment identifier.

With Helm deployment, you can define custom names for these namespaces to facilitate your namespace management.

Note: Changing the namespace name is only allowed during engine deployment.

Procedure

In the Kubernetes machine, unzip the Helm deployment zip file previously downloaded.
Create a custom values file for the Dynamic Engine custom namespace.
Run the following command in your terminal.
```
cat <<EOF > $DYNAMIC_ENGINE_ID-custom-namespace-values.yaml
global:
  namespace:
    create: false
    name: <engine-custom-namespace>
EOF        
```
For example, $DYNAMIC_ENGINE_ID is c-m-sjufu4qy and <engine-custom-namespace> is dynamic-engine-dev. This creates a values file called c-m-sjufu4qy-custom-namespace-values.yaml. This file contains:
```
global:
  namespace:
    create: false
    name: dynamic-engine-dev
```

Create the custom namespace in your Kubernetes cluster.

kubectl create namespace <engine-custom-namespace>

Deploy the Dynamic Engine with your custom namespace configuration.

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

Create a custom values file for the environment custom namespace.
Run the following commands in your 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       
```
Ensure to use the same engine custom namespace name for <engine-custom-namespace> as the one you previously created. If you use a different one, the environment cannot be deployed.
For example, $DYNAMIC_ENGINE_ENVIRONMENT_ID is 67f7d562ffd7c3525a902542, <environment-custom-namespace> is dynamic-engine-dev-env-1, and engine-custom-namespace> is dynamic-engine-dev, exactly the same as the engine's custom namespace name mentioned in previous examples. This creates a values file called 67f7d562ffd7c3525a902542-custom-namespace-values.yaml. This file contains:
```
global:
  namespace:
    create: false
    name: dynamic-engine-dev-env-1
dynamicEngine:
  namespace:
    name: dynamic-engine-dev
```

Create the custom environment namespace in your Kubernetes cluster.

kubectl create namespace <environment-custom-namespace>

Deploy the Dynamic Engine environment with your custom namespace configuration.

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

Tip: If you have multiple Dynamic Engine environments for the same Dynamic Engine, repeat these steps to create a distinct custom namespace name for each environment.

Verify the status of your Dynamic Engine and environments.

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

You should see information similar to these lines:

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

The <environment-resource-name> is the same as the environment's custom namespace name, for example, dynamic-engine-dev-env-1.

Results

Once done successfully, the Dynamic Engine environment services are installed in your cluster and connect to the Dynamic Engine.

In Talend Management Console, the status of this environment becomes Ready, confirming that it is ready to run tasks or plans.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here