Dredd in Docker

DockerHub: apiaryio/dredd

Dredd is an HTTP API testing tool. You can find out more about it at its documentation or its code repository. This repository contains Docker setup for Dredd in form of a Dockerfile and the tooling necessary to regularly publish a Docker image with the latest Dredd version available.

How to run Dredd using Docker?

Following line runs the dredd command using the apiaryio/dredd Docker image:

docker run -it -v $PWD:/api -w /api apiaryio/dredd dredd

As an example of how to pass arguments, following line runs the dredd init command:

docker run -it -v $PWD:/api -w /api apiaryio/dredd dredd init

Windows

Getting following error?

Error response from daemon: create $PWD: "$PWD" includes invalid characters for a local volume name, only "[a-zA-Z0-9][a-zA-Z0-9_.-]" are allowed. If you intended to pass a host directory, use absolute path.

The $PWD:/api part of the command doesn't work on Windows. Use absolute path instead or try if ${pwd}:/api does the trick:

C:\Users\Susan> docker run -it -v ${pwd}:/api -w /api apiaryio/dredd dredd

How does this repository work?

This repository has Travis CI builds set up. Travis CI supports setting a cron build, which triggers every day. This build ensures the Dredd image isn't behind the latest Dredd version for more than one day.