Kong Konnect and miscellaneous utility tooling in one Docker container. Includes example of converting OpenAPI specifications to Kong YAML configuration and then uploading into Kong Konnect.
Copy this git repository to a local machine, for example
git clone https://github.com/mark-sivill-kong/konnect-docker-utility-tools
Build the docker container
cd konnect-docker-utility-tools
docker compose build
Start the container
docker compose up
Access the command line in the running container using Docker Desktop or via the commmand line using
docker ps
to find the <container-id>, then the following command to access the docker container
docker exec -it <container-id> /bin/sh
Once inside the container the command line tools can be accessed, for example
deck version
The tooling and associated versions that are installed can be found by running
versions.sh
Example deck commands can be found by running
commands.sh
Example pipeline that converts OpenAPI to Kong configuration and then uploads into Kong Konnect
~/scripts/pipeline/run_pipeline.sh <OpenAPI-specification>
Currently there are 2 OpenAPI specifications in the openapi-specs directory
- transport-for-london-1.5.yaml
- world-time-openapi.yaml
Running the pipeline using transport-for-london-1.5.yaml
~/scripts/pipeline/run_pipeline.sh transport-for-london-1.5.yaml
Additional OpenAPI specifications can optionally be added to the openapi-specs directory
To run the pipeline script ensure the following environment variables have been passed into the docker container
- KONNECT_ADDR - Konnect Region specific API for example https://eu.api.konghq.com or https://us.api.konghq.com
- KONNECT_PAT - Konnect personal access token created within Konnect, found under user name
- KONNECT_RUNTIME_GROUP - runtime instance name where configuration is to be deployed
The following OpenAPI specifciations are included in this repository which may have their own licensing terms
- transport-for-london-1.5.yaml dervived from Transport for London Unified API
- world-time-openapi.yaml WorldTimeAPI