dctest

Integration Testing in Docker Compose

Quickstart

The intro examples demonstrate the basic syntax and features of dctest. They can be run with a fresh checkout, installed dependencies, and the sample Docker Compose file:

git checkout [email protected]:Viasat/dctest.git
npm install
docker-compose -p demo -f examples/docker-compose.yaml up -d

With our Docker Compose project running, we can run our tests against it, supplying the project name ("demo") and the tests we want to run:

./dctest demo examples/00-intro.yaml

See dctest --help for more CLI options, such as --continue-on-error. Guides and reference documentation are also available.

Install and Run

Via NPM as a dev dependency:

npm install --save-dev @lonocloud/[email protected]
./node_modules/.bin/dctest $USER /path/to/suite.yaml

Via Docker Hub:

docker pull lonocloud/dctest:0.3.1
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/suite.yaml:/tests/suite.yaml \
  lonocloud/dctest:0.3.1 $USER /tests/suite.yaml

Copyright & License

This software is copyright Viasat, Inc and is released under the terms of the Eclipse Public License version 2.0 (EPL.20). A copy of the license is located at in the LICENSE file at the top of the repository.