Kong-validator

A simple container to validate a kong.yml declarative config file, see examples here:

https://github.com/zoobab/kong-declarative-config

Usage

$ mkdir -pv /tmp/1
$ vim /tmp/1/kong.yml
  _format_version: "1.1"
  services:
  - name: version
    url: http://localhost
    routes:
    - name: version
      paths:
      - /version
  - name: mocky24
    url: http://www.mocky.io/v2/5ca725833400002c4876b363
    routes:
    - name: mocky24
      paths:
      - /mocky24
$ cd /tmp/1
$ docker run -it -v /tmp/1:/mnt zoobab/kong-validator
parse successful

You can check the shell exit code as well (0 is success, 1 is failure):

$ docker run -it -v /tmp/1:/mnt zoobab/kong-validator
parse successful
$ echo $?
0

Now let's insert an error, replacing name: by name2::

$ docker run -it -v /tmp/1:/mnt zoobab/kong-validator
Error: Failed parsing:
in 'services':
  - in entry 1 of 'services':
    in 'routes':
      - in entry 1 of 'routes':
        in 'name2': unknown field

  Run with --v (verbose) or --vv (debug) for more details
$ 

You can check the shell exit code as well (0 is success, 1 is failure):

$ echo $?
1

Upstream readme

======= This is the Git repo of the Docker official image for kong. See the Docker Hub page for the full readme on how to use this Docker image and for information regarding contributing and issues.

The full readme is generated over in docker-library/docs, specifically in docker-library/docs/kong.

See a change merged here that doesn't show up on the Docker Hub yet? Check the "library/kong" manifest file in the docker-library/official-images repo, especially PRs with the "library/kong" label on that repo. For more information about the official images process, see the docker-library/official-images readme.

For Kong developers

Pushing a Kong patch release (x.y.Z) update

If the update does not require changes to the Dockerfiles other than pointing to the latest Kong code, the process can be semi-automated as follows:

1. Check out this repository.

2. Run ./update.sh x.y.z

   This will create a release branch, modify the relevant files automatically, give you a chance to review the changes and press "y", then it will push the branch and open a browser with the PR to this repository.

3. Peer review, run CI and merge the submitted PR.

4. Run ./submit.sh -p x.y.z

   Once the internal PR is merged, this script will do the same for the [official-images][https://github.com/docker-library/official-images] repository. It will clone [Kong's fork][https://github.com/kong/official-images], create a branch, modify the relevant files automatically, give you a chance to review the changes and press "y", then it will push the branch and open a browser with the PR to the docker-library repository.

Pushing a Kong minor release (x.Y.0) update

Not semi-automated yet. Note that minor releases are more likely to require more extensive changes to the Dockerfiles.