Deploy Console with Kubernetes

Overview

Conduktor provides a Helm repository containing a chart that will deploy Conduktor Platform on your Kubernetes cluster. We don’t provide any relational database dependency, you will have to provide your own database. See the production requirements for details. For a full reference of our recommended Conduktor platform deployment architecture, see our sample GitHub repository. Check out the snippets section for more examples.

# Setup Helm repository
helm repo add conduktor https://helm.conduktor.io
helm repo update

export ADMIN_EMAIL="<your_admin_email>"
export ADMIN_PASSWORD="<your_admin_password>"
export ORG_NAME="<your_org_name>"
export NAMESPACE="<your_kubernetes_namespace>"

# Deploy Helm chart
helm install console conduktor/console \
  --create-namespace -n ${NAMESPACE} \
  --set config.organization.name="${ORG_NAME}" \
  --set config.admin.email="${ADMIN_EMAIL}" \
  --set config.admin.password="${ADMIN_PASSWORD}" \
  --set config.database.password="<your_postgres_password>" \
  --set config.database.username="<your_postgres_user>" \
  --set config.database.host="<your_postgres_host>" \
  --set config.database.port="5432" \
  --set config.license="${LICENSE}" # can be omitted if deploying the free tier
    
# Port forward to access Conduktor
kubectl port-forward deployment/console -n ${NAMESPACE} 8080:8080
open http://localhost:8080

Chart dependencies

All charts within this repository have one dependency which is bitnami-common. You can find the chart here: https://github.com/bitnami/charts/tree/main/bitnami/common

Compatibility matrix

Find out which versions of Conduktor Platform work on which version of our Conduktor Platform Helm chart.

We recommend you use the version of Platform that comes pre-configured with the Helm chart. You can adjust the version in your values property according to the supported Platform version, if required.

Breaking changes column only lists changes in the Helm chart. See release notes to determine whether there are breaking changes within the artifacts.

Helm chart compatibility

Breaking changes: 🟡 - Breaks additional services (e.g. Grafana dashboard changes) 🔴 - Breaks overall deployment of the product (e.g. renaming variables in .values, major product releases)

Chart version	Supported Platform version	Breaking changes
console-1.22.0	1.37.0, 1.36.2, 1.36.1, 1.36.0, 1.35.2, 1.35.1, 1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.21.2	1.36.2, 1.36.1, 1.36.0, 1.35.2, 1.35.1, 1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.21.1	1.36.1, 1.36.0, 1.35.2, 1.35.1, 1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.21.0	1.36.0, 1.35.2, 1.35.1, 1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.20.3	1.35.2, 1.35.1, 1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.20.2	1.35.1, 1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.20.1	1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.20.0	1.35.0, 1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.19.1	1.34.2, 1.34.1, 1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.19.0	1.34.0, 1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.18.0	1.33.0, 1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.17.1	1.32.1, 1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.17.0	1.32.0, 1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.16.2	1.31.2, 1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.16.1	1.31.1, 1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.16.0	1.31.0, 1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.15.0	1.30.0, 1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.14.2	1.29.2, 1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.14.1	1.29.1, 1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.14.0	1.29.0, 1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.13.0	1.28.0, 1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.12.1	1.27.1, 1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.12.0	1.27.0, 1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.11.0	1.26.0, 1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.10.0	1.25.1, 1.25.0, 1.24.1, 1.24.0
console-1.9.1	1.24.1, 1.24.0
console-1.9.0	1.24.0	🔴 Changed liveness and readiness probe path see here
console-1.8.1	1.23.0, 1.22.1, 1.22.0
console-1.8.0	1.23.0, 1.22.1, 1.22.0
console-1.7.2	1.22.1, 1.22.0	🔴 Service Monitor endpoint changes, Grafana template changes see here
console-1.6.2	1.21.3, 1.21.2, 1.21.1, 1.21.0
console-1.6.1	1.21.1, 1.21.0
console-1.6.0	1.21.0	🔴 Paths and folder changed see here
console-1.5.5	1.20.0, 1.19.2, 1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.5.4	1.20.0, 1.19.2, 1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3	🟡 Updated Grafana template see here
console-1.5.3	1.20.0, 1.19.2, 1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3	🟡 Updated Grafana template see here
console-1.5.2	1.20.0, 1.19.2, 1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3	🟡 Updated Grafana template see here
console-1.5.1	1.20.0, 1.19.2, 1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.5.0	1.20.0, 1.19.2, 1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.4.2	1.19.2, 1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.4.1	1.19.1, 1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.4.0	1.19.0, 1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.3.9	1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.3.8	1.18.4, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.3.7	1.18.3, 1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.3.6	1.18.2, 1.18.1, 1.18.0, 1.17.3
console-1.3.5	1.18.1, 1.18.0, 1.17.3
console-1.3.4	1.18.1, 1.18.0, 1.17.3
console-1.3.3	1.18.1, 1.18.0, 1.17.3
console-1.3.2	1.18.0, 1.17.3
console-1.3.1	1.18.0, 1.17.3
console-1.3.0	1.18.0, 1.17.3
console-1.2.4	1.17.3
console-1.2.3	1.17.3
console-1.2.2	1.17.3
console-1.2.1	1.17.3
console-1.2.0	1.17.3
console-1.1.4	1.17.3	🔴 Fixed issue with license checksum see here
console-1.1.3	1.17.3, 1.17.2
console-1.1.2	1.17.3, 1.17.2
console-1.1.1	1.17.3, 1.17.2
console-1.1.0	1.17.3, 1.17.2
console-1.0.3	1.17.3, 1.17.2
console-1.0.2	1.17.3, 1.17.2
console-1.0.1	1.17.3, 1.17.2
console-1.0.0	1.17.2

General requirements

Basic knowledge of Kubernetes
Kubernetes cluster 1.19+ (set up a local cluster)[^1]
Kubectl (install) with proper kube context configured
Helm 3.1.0+ (install)

Production requirements

Mandatory for production environments:

set up an external PostgreSQL (13+) database with an appropriate backup policy
set up an external S3 Bucket
allow enough resources to run Conduktor with the recommended configuration

A note on TLS and URL forwarding

For production environments, we recommend to run with TLS enabled from your ingress controller and terminating on Platform. This creates a more secure connection, while also telling Platform that it should use TLS when forwarding on any URL requests (e.g. requests to SSO providers). Without TLS terminating on Platform itself, requests between the ingress controller and Platform will be in plain text, as will URL forwarding to your SSO provider which can lead to rejection of the request for not being secure.

1. Set up Helm repository

helm repo add conduktor https://helm.conduktor.io
helm repo update

2. Install the Console chart

Configure Console with the following values:

values.yaml

config:
  organization:
    name: "<your_org_name>"

  admin:
    email: "<your_admin_email>"
    password: "<your_admin_password>"

  database:
    host: '<postgres_host>'
    port: 5432
    name: '<postgres_database>'
    username: '<postgres_username>'
    password: '<postgres_password>'
    
  # HERE you can paste the console configuration (under the config key)

Install the chart on your cluster:

helm install console conduktor/console \
  --create-namespace -n conduktor \
  --values values.yaml \
  --set config.license="${LICENSE}" # can be omitted if deploying the free tier

Once deployed, you will be able to access Conduktor on localhost:8080 by using a port-forward. You can also configure an ingress to make Platform available externally, check out snippets.

kubectl port-forward deployment/console -n ${NAMESPACE} 8080:8080

3. Configure Console

Fresh install

You can configure Platform by inserting it into the config section of the values.yaml file.

Based on a Docker configuration

If you’re already using a config file within Docker,you can use it by giving it to the Helm chart with the following command:

values.yaml

config:
  organization:
    name: "<your_org_name>"

  admin:
    email: "<your_admin_email>"
    password: "<your_admin_password>"
    
  database:
    host: '<postgres_host>'
    port: 5432
    name: '<postgres_database>'
    username: '<postgres_username>'
    password: '<postgres_password>'
    
  # HERE you can paste the console configuration (under the config key)

Configure with an enterprise license

values.yaml

config:
  organization:
    name: "<your_org_name>"

  admin:
    email: "<your_admin_email>"
    password: "<your_admin_password>"
    
  database:
    host: '<postgres_host>'
    port: 5432
    name: '<postgres_database>'
    username: '<postgres_username>'
    password: '<postgres_password>'

  license: "<your_license>"

  # HERE you can paste the console configuration (under the config key)

Examples

Find sample code on our GitHub.

Conduktor in production

Deploy Gateway

Deploy Console

Initial setup

Overview

Chart dependencies

Compatibility matrix

Helm chart compatibility

General requirements

Production requirements

A note on TLS and URL forwarding

1. Set up Helm repository

2. Install the Console chart

3. Configure Console

Fresh install

Based on a Docker configuration

Configure with an enterprise license

Examples

Conduktor in production

Deploy Gateway

Deploy Console

Initial setup

​Overview

​Chart dependencies

​Compatibility matrix

​Helm chart compatibility

​General requirements

​Production requirements

​A note on TLS and URL forwarding

​1. Set up Helm repository

​2. Install the Console chart

​3. Configure Console

​Fresh install

​Based on a Docker configuration

​Configure with an enterprise license

​Examples

​Related resources

Overview

Chart dependencies

Compatibility matrix

Helm chart compatibility

General requirements

Production requirements

A note on TLS and URL forwarding

1. Set up Helm repository

2. Install the Console chart

3. Configure Console

Fresh install

Based on a Docker configuration

Configure with an enterprise license

Examples

Related resources