Install Kong Operator in Konnect hybrid mode

Incompatible with
on-prem
Related Documentation
Minimum Version
Kong Operator - 1.6.1
TL;DR

Update the Helm repository and use Helm to install Kong Operator in Konnect.

Kong Operator can deploy and manage data planes attached to a Konnect control plane. All the Services, Routes, and plugins are configured in Konnect and sent to the data planes automatically.

Install Kong Operator

  1. Add the Kong Helm charts:

    helm repo add kong https://charts.konghq.com
    helm repo update
    
  2. Install Kong Operator using Helm:

    helm upgrade --install kong-operator kong/kong-operator -n kong-system \
      --create-namespace \
      --set image.tag=2.0.5 \
      --set env.ENABLE_CONTROLLER_KONNECT=true
    

    If you want cert-manager to issue and rotate the admission and conversion webhook certificates, install cert-manager to your cluster and enable cert-manager integration by passing the following argument while installing:

    --set global.webhooks.options.certManager.enabled=true
    

    If you do not enable this, the chart will generate and inject self-signed certificates automatically. We recommend enabling cert-manager to manage the lifecycle of these certificates.

This tutorial doesn’t require a license, but you can add one using KongLicense. This assumes that your license is available in ./license.json.

echo "
apiVersion: configuration.konghq.com/v1alpha1
kind: KongLicense
metadata:
 name: kong-license
rawLicenseString: '$(cat ./license.json)'
" | kubectl apply -f -

Validate

Wait for Kong Operator to be ready

kubectl -n kong-system wait --for=condition=Available=true --timeout=120s deployment/kong-operator-kong-operator-controller-manager

Once the kong-operator-kong-operator-controller-manager deployment is ready, you can deploy a DataPlane resource that is attached to a Konnect Gateway control plane.

Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!