KONG ➕ GKE Deployment

Kong can easily be povisioned to Google Cloud using the following steps:

1. Initial setup:

   You would need gcloud and kubectl command-line tools installed and set up to run deployment commands.

   Download or clone the repo

   $ git clone [email protected]:Mashape/kong-dist-google-cloud.git
   $ cd kong-dist-google-cloud

2. Deploy a cluster:

   Using cluster.yaml, deploy a GKE cluster to use for deploying the solution later. Fill in the following information before deploying:

   • desired cluster name
   • zone in which to run the cluster
   • basicauth username and password for authenticating access to the cluster

   When ready, deploy with the following command:

   $ gcloud deployment-manager deployments create cluster --config cluster.yaml

3. Deploy a Kong supported Database

   Using cassandra.yaml deploy a Cassandra Service and a ReplicationController to the GKE cluster created in the last step. Update following properties if needed.

   • the cluster type created for the GKE cluster deployed previously
   • the Cassandra image
   • the CQL and Thrift port for Cassandra

   When ready, deploy with the following command:

   $ gcloud deployment-manager deployments create cassandra --config cassandra.yaml

Note: Currently only Cassandra supported.

4. Deploying Kong on the cluster

   Using kong.yaml, deploy a Kong Service and a ReplicationController to the GKE cluster created in the last step. Update following properties if needed.

   • the cluster type created for the GKE cluster deployed previously
   • the Kong image (for different version)
   • the Admin and Proxy port for Kong containers
   • the Admin and Proxy allowed CIDR for Kong

   When ready, deploy with the following command:

   $ gcloud deployment-manager deployments create kong --config kong.yaml

5. Verifying deployment

   Be sure your kubectl command-line tool is set up to communicate with the cluster you have deployed:

   $ gcloud container clusters get-credentials :cluster-name --zone <zone>

   Now you can see the resources that have been deployed using kubectl:

   $ kubectl get rc
   $ kubectl get pods
   $ kubectl get services

   Once the EXTERNAL_IP is available for Kong Proxy and Admin services, you can test Kong:

   $ curl <admin-ip-address>:8001
   $ curl <proxy-ip-address>:8000

6. Using Kong:

   Quickly learn how to use Kong with the 5-minute Quickstart.

Important Note

When deploying into a Kubernetes cluster with Deployment Manager, it is important to be aware that deleting ReplicationController Kubernetes objects does not delete its underlying pods, and it is your responisibility to manage the destruction of these resources when deleting or updating a ReplicationController in your configuration.

Enterprise Support

Support, Demo, Training, API Certifications and Consulting available at http://getkong.org/enterprise.