PermalinkInstalling Kong for Kubernetes Enterprise

PermalinkIntroduction

This installation topic guides you through installing and deploying Kong for Kubernetes Enterprise (K4K8S-Enterprise), then directs you to the documentation for configuring and using the product.

Kong for Kubernetes Enterprise control diagram

Note: Installation steps in this topic include installing Kong for Kubernetes Enterprise using YAML with kubectl and with OpenShift oc. Other deployment options, such as using Helm Chart and Kustomize, will be available at a later time.

PermalinkPrerequisites

Before installing Kong for Kubernetes Enterprise, be sure you have the following:

Kubernetes cluster: Kong is compatible with all distributions of Kubernetes. You can use a Minikube, GKE, or OpenShift cluster.
kubectl or oc access: You should have kubectl or oc (if working with OpenShift) installed and configured to communicate to your Kubernetes cluster.
A valid Kong Enterprise License
- If you have a license, continue to Step 1. Set Kong Enterprise License below. If you need your license file information, contact Kong Support.
- If you need a license, request a trial license through our Request Demo page.
An Enterprise Docker image for 1.3-x.

If you have lost access to your 1.3-x image, Kong recommends upgrading to the next minor version and pulling Kong Gateway 1.5.0.11 or later from Docker Hub.

If upgrading is not possible, reach out to Kong Support for access to an older version.

PermalinkInstalling Kong for Kubernetes Enterprise

The steps in this section include installing Kong for Kubernetes Enterprise using YAML.

Installation steps include:

Step 1. Set Kong Enterprise License
Step 2. Deploy Kong for Kubernetes Enterprise

To create the license secret, first provision the kong namespace:

$ kubectl create namespace kong

On OpenShift:

$ oc new-project kong

PermalinkStep 1. Set Kong Enterprise License

Kong for Kubernetes Enterprise requires a valid license.

As part of sign up for Kong Enterprise, you should have received a license file. If you do not have one, contact your Kong sales representative. Save the license file temporarily to disk with filename license (no file extension) and execute the following:

Note: There is no .json extension in the –from-file parameter. -n kong specifies the namespace in which you are deploying Kong for Kubernetes Enterprise. If you are deploying in a different namespace, change this value.

$ kubectl create secret generic kong-enterprise-license --from-file=./license -n kong

On OpenShift:

$ oc create secret generic kong-enterprise-license --from-file=./license -n kong

PermalinkStep 2. Deploy Kong for Kubernetes Enterprise

$ kubectl apply -f https://bit.ly/k4k8s-enterprise

The initial setup might take a few minutes.

$ kubectl get pods -n kong
NAME                            READY   STATUS    RESTARTS   AGE
ingress-kong-6ffcf8c447-5qv6z   2/2     Running   1          44m

You can also see the kong-proxy service:

$ kubectl get service kong-proxy -n kong
NAME         TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE
kong-proxy   LoadBalancer   10.63.254.78   35.233.198.16   80:32697/TCP,443:32365/TCP   22h

On OpenShift:

$ oc create -f https://bit.ly/k4k8s-enterprise

The initial setup might take a few minutes.

$ oc get pods -n kong
NAME                            READY   STATUS    RESTARTS   AGE
ingress-kong-6ffcf8c447-5qv6z   2/2     Running   1          44m

You can also see the kong-proxy service:

$ oc get service kong-proxy -n kong
NAME         TYPE           CLUSTER-IP     EXTERNAL-IP     PORT(S)                      AGE
kong-proxy   LoadBalancer   10.63.254.78   35.233.198.16   80:32697/TCP,443:32365/TCP   22h

Note: Depending on the Kubernetes distribution you are using, you may or may not see an external IP address assigned to the service. See your provider’s guide on obtaining an IP address for a Kubernetes Service of type LoadBalancer.

Set up an environment variable to hold the IP address:

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

It might take a while for your cloud provider to associate the IP address to the kong-proxy service. Once you have installed Kong, see the getting started tutorial.

PermalinkNext steps…

See Using Kong for Kubernetes Enterprise for information about Concepts, How-to guides, Reference guides, and using Plugins.

PermalinkOptional: Installing Kong Enterprise on Kubernetes

Note: The recommended installation is Kong for Kubernetes Enterprise.

To install Kong Enterprise on Kubernetes, instead of installing Kong for Kubernetes, see the following diagram. (Steps to be provided at a later time.)