ezd - eZ Docker Task Runner

ezd is an easy to configure docker-based task runner system.

Getting started

1. Create an ezd.yml file in your project root: ezd init > ezd.yml or ezd init -f ezd.yml
2. Customize the file.
3. Run your Tasks using ezd run $TASK_NAME
   • To get a short view of your tasks use ezd describe
   • To inspect the final configuration use ezd describe --details
   • To inspect a specific task use ezd describe $TASK_NAME

How it works

Project configuration

At first ezd will search for it's corresponding configuration file by searching the current path and traversing upwards until it finds an ezd.yml file.

The project root is the directory in which ezd.yml is saved. All tasks executed by ezd are relative to the project root.

shell_exec

shell_exec tasks do execute the given commands within a local shell. They do not provide a lot of configuration through ezd.

docker_run

1. ezd will first spin up a container (using docker run --rm) that just waits until it is stopped (using sleep infinity).
2. Then the command sequence is issued using docker exec.
3. At last, the container is automatically stopped using docker stop.

ezd trys to provide default settings which aim to lessen the amount of configuration required when building projects within docker containers.

License

ezd is released under the Apache 2.0 license. See LICENSE.txt