narate / kong-docker

Kong Docker deployment

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Kong Docker deployment with docker-compose


Kong API Gateway deployment with docker and docker-compose

Status

This deployment is production ready.

Change default value

Copy default.env to .env

cp default.env .env

then edit the .env file to change default values.

Variable name Default value
POSTGRES_VERSION 13-alpine
POSTGRES_USER kong
POSTGRES_PASSWORD kong
POSTGRES_DB kong
KONG_VERSION 2.2
KONG_ADMIN_LISTEN 0.0.0.0:8001
KONG_PROXY_LISTEN 0.0.0.0:8000, 0.0.0.0:8443 ssl http2
KONG_NGINX_HTTP_RESOLVER 8.8.8.8
KONG_PG_HOST kong-database
KONG_PG_USER kong == env POSTGRES_USER
KONG_PG_PASSWORD kong == env POSTGRES_PASSWORD
KONG_PG_DATABASE kong == env POSTGRES_DB

Quick start

time ./quick-start.sh

Deploy Kong step by step

Deploy kong-database

docker-compose up -d kong-database

Run kong-database migrations

docker-compose run --rm kong kong migrations bootstrap --vv

Start Kong

docker-compose up -d kong

Now Kong is running

Start Konga

docker-compose up -d konga

Now Konga is running

Acccess Konga securely

If you deploy Kong on a remote host we can access Konga via ssh tunnel

ssh -L 1337:127.0.0.1:1337 username@kong.example.com

Now you can access konga on localhost

Upgrading Kong version

WARNING : This may take some downtime to start a new Kong version.

  1. Change KONG_VERSION in .env file to a newer version.

    If running kong version 2.2 change to 2.3 (or 2.3.0). Suggested upgrade path

  2. Run migrations upgrade

    docker-compose run --rm kong kong migrations up --vv
    
  3. Confirm finish migrations upgrade

    docker-compose run --rm kong kong migrations finish --vv
    
  4. Start new Kong version

    docker-compose up -d kong
    

Postman Admin API

Kong CE Admin API V2.0

About

Kong Docker deployment


Languages

Language:Shell 100.0%