littlebaydigital/kong repository overview

⁠Kong as a Docker Service

This an extension of the official Docker image⁠ for Kong⁠, with support to for Rancher⁠, Kubernetes⁠, or Tutum/Docker Cloud⁠.

You can also spin this up by adding in my custom Rancher Catalog⁠

⁠Justifications

The official docker-kong image allows for:

1. linking `Cassandra` or `Postgres` database containers
2. connecting to external databases via custom `kong.yml` config file by replacing the `/etc/kong/` volume.

However when using Rancher or Kubernetes, containers are organised into Services deployed across multiple machine node clusters. Therefore it's not feasible to mount custom config files into volumes on each machine which are spun up and down on demand. See related question here⁠

Also there is no need to explicitly link containers since internal DNS resolutions for Services comes out of the box in platforms such as Rancher or Tutum.

By configuring Cassandra and Postgres purely using Environment Variables, it is a lot easier to point to either an external database instance or an internal database service. Without having to build a custom kong config.

⁠Supported tags and respective Dockerfile links

• 0.8.0 - (Dockerfile⁠)
• 0.8.1 - (Dockerfile⁠)
• 0.8.2 - (Dockerfile⁠)
• 0.8.3 - (Dockerfile⁠)
• latest - (Dockerfile⁠)

⁠How to use this image

Existing docker-kong usages still applies. The following extra Environment Variables are added:

⁠Kong Environment Variables:

⁠Cassandra Environment Variables:

Example:

$ docker run -d --name kong \
    -e DATABASE=cassandra \
    -e CASSANDRA_CONTACT_POINTS='\"52.5.149.55:9042\",\"52.5.149.56:9042\"' \
    -p 8000:8000 -p 8443:8443 -p 8001:8001 -p 7946:7946 -p 7946:7946/udp \
    littlebaydigital/kong

or:

$ docker run -d --name kong \
    -e DATABASE=cassandra \
    -e CASSANDRA_CONTACT_POINTS='\"cassandra-service.kong-stack:9042\"' \
    -p 8000:8000 -p 8443:8443 -p 8001:8001 -p 7946:7946 -p 7946:7946/udp \
    littlebaydigital/kong

Sample Docker Compose: https://github.com/yunspace/my-docker-stacks/tree/master/kong/cassandra⁠

⁠Postgres Environment Variables:

Example:

$ docker run -d --name kong \
    -e DATABASE=postgres \
    -e POSTGRES_HOST=127.0.0.1 \
    -p 8000:8000 -p 8443:8443 -p 8001:8001 -p 7946:7946 -p 7946:7946/udp \
    --security-opt seccomp:unconfined \
    littlebaydigital/kong

or:

$ docker run -d --name kong \
    -e DATABASE=postgres \
    -e POSTGRES_HOST=postgres-service.kong-stack \
    -p 8000:8000 -p 8443:8443 -p 8001:8001 -p 7946:7946 -p 7946:7946/udp \
    --security-opt seccomp:unconfined \
    littlebaydigital/kong

Sample Docker Compose: https://github.com/yunspace/my-docker-stacks/tree/master/kong/postgres⁠