paradocker

Parallel Docker

paradocker allows to run commands in the docker containers in the parallel. This works with UNIX pipes.

Any UNIX pipe can be used for running your commands in docker containers.

For example you can use this like:

find test | grep .js | paradocker --image ubuntu:precise --concurrency 5 --run "echo mocha -R spec"

• it will run your tests in parallel,
• it will make some queue in this example 5 processes
• it will handle your big list of tests in the parallel.

exactly it will run commands for docker like:

• > docker run --rm ubuntu:precise echo mocha -R spec test/src/paradockerTest.js
• > docker run --rm ubuntu:precise echo mocha -R spec test/src/streamTest.js

yeah, echo mocha -R spec test/src/streamTest.js will be executed inside of container.

Install

requirements: docker https://www.docker.com/

• npm install -g paradocker

Help

> paradocker -h

find test | paradocker --image ubuntu:precise --concurrency 5 --run echo

Options:
  -h, --help         help
  -v, --version      version
  -i, --image        docker image
  -r, --run          docker run parameters
  -c, --concurrency  docker process concurrency
  -o, --options      docker options
  --image                                        [default: "ubuntu:precise"]
  --concurrency                                  [default: 2]
  --run                                          [default: "echo"]
  --options                                      [default: "--rm"]

Example output

>> find test | grep .js | paradocker --image ubuntu:precise --concurrency 5 --run "echo mocha -R spec"

> docker run --rm ubuntu:precise echo mocha -R spec test/src/paradockerTest.js
> docker run --rm ubuntu:precise echo mocha -R spec test/src/streamTest.js
[DONE] docker run --rm ubuntu:precise echo mocha -R spec test/src/paradockerTest.js
[TASK] echo mocha -R spec test/src/paradockerTest.js
mocha -R spec test/src/paradockerTest.js


[DONE] docker run --rm ubuntu:precise echo mocha -R spec test/src/streamTest.js
[TASK] echo mocha -R spec test/src/streamTest.js
mocha -R spec test/src/streamTest.js

I guess you noticed that mocha does not show any test results (of course) because there run command with echo just for example, we use empty image ubuntu:precise,

just setup your project, use your image and run your tests in parallel. enjoy!