Install on Kubernetes

    This page also includes the equivalent commands for OpenShift.

    Note that in DB-less mode on Kubernetes, config is stored in etcd, the Kubernetes native datastore. For more information see Kubernetes Deployment Options.

    The Kong Gateway software is governed by the . Kong Gateway (OSS) is licensed under an Apache 2.0 license.

    • A Kubernetes cluster, v1.19 or later
    • v1.19 or later
    • (Enterprise only) A license.json file from Kong

    Create the namespace for Kong Gateway with Kubernetes Ingress Controller. For example:

    1. oc new-project kong

    2. Run:

      1. ## on Kubernetes native
      1. ## on OpenShift
      2. oc create secret generic kong-enterprise-license --from-file=./license -n kong

    1. Run one of the following:

      1. oc create -f https://bit.ly/k4k8s-enterprise-install
      1. ## Kong Gateway (OSS) on Kubernetes native

      This might take a few minutes.

    2. Check the install status:

      1. kubectl get pods -n kong

    3. To make HTTP requests, you need the IP address of the load balancer. Get the LoadBalancer address and store it in a local PROXY_IP environment variable:

      1. export PROXY_IP=$(kubectl get -o jsonpath="{.status.loadBalancer.ingress[0].ip}" service -n kong kong-proxy)

    4. Check that the value of $PROXY_IP is the value of the external host:

        or:

        1. oc get service kong-proxy -n kong