The docker Stack

This project is composed of a collection of usefull docker-compose files for web developpers. We also provide a standalone Cli tool to manage a list of docker compose files registered in a config.

Cli tool and compose files collection are independants, you can use cli without the compose files and vice versa.

Documentation

• Manage your local docker compose projects easilly with the cli tool : dctl

• Your local stack for web development. A collection of docker-compose files

• The project change log

"dctl" cli vs "docker compose" ?

With dctl, we relies on a config file, no need to have started or stopped containers of a docker-compose file to see and manage them, they are known. dctl use docker compose internaly, it's a wrapper around docker compose, so you can use all docker compose commands and arguments.

The cli can "manage" multiple docker-compose files (start, stop, down, restart, build and more) from everywhere in your terminal. With this tool, you can avoid declaring multiple aliases in your shell, and you can use the same command to start/stop/restart/ and so on for all your projects. The cli offers an easy way to override default docker-compose file for a project, you can also define default arguments for all docker-compose commands to avoid repeating them in the command line.

See more

Roadmap / next steps

• Documentation - add examples of docker-compose files for local development.

v1

• Build - Plublish the cli tool for multiples platforms (Windows, Mac, Linux), different architectures (x86, arm, arm64).
• Cli - improve check-config cli command, better presentation.
• Documentation - give cli examples, screenshots.
• Cli - Add a "dctl" command to register/update a project using docker-compose.yml file.
• Cli - Add a "dctl" command to unregister a project using docker-compose.yaml file.
• Default arguments - make it disablable by specifying a special argument.
• Default arguments - by project.
• Default arguments - clever merge default arguments with the ones specified in the command line.

v2

• Re-implement docker compose using Docker API instead of rely on "docker compose" plugin.

Contributing

Contributions are welcome, feel free to open an issue or a pull request.