Docker image for IBM OpenAPI Validator

This is a small community Docker image providing IBM's OpenAPI Validator.

Run

• To validate a specification file openapi.yaml in the current directory, mount the current directory at /data in the container (this is the image's default working directory):

  $ docker run \
       --volume "$PWD":/data \
       jamescooke/openapi-validator openapi.yaml

• The init command can be used to generate the initial .validaterc file, which will be created in the mounted directory.

  $ docker run \
       --volume "$PWD":/data \
       jamescooke/openapi-validator init

  You may need to adjust the permissions of the generated file.

• If you prefer to rename your config file, for example to config.json, then this can be passed with the --config flag:

  $ docker run \
       --volume "$PWD":/data \
       jamescooke/openapi-validator openapi.yaml --config config.json

Container

• This is a "small-ish" container built on the official Node 13 Alpine base image.

• OpenAPI validator is installed in the container using npm.

• Image tags are kept synchronised with the version of OpenAPI validator. For example, image 0.21.0 contains OpenAPI validator version 0.21.0:

  $ docker run jamescooke/openapi-validator:0.21.0 --version
  0.21.0

Links

• OpenAPI Validator: repository, releases

• Docker container: docker hub

Thanks

• Dustin and the IBM team for their hard work on the OpenAPI Validator tool.

• Martins and my Lucid teammates for all their help with Docker and containers.