Skip to content

A pre-configured docker-compose files collection helping web developers. Additional Cli to manage registered compose files from everywhere in the terminal.

License

Notifications You must be signed in to change notification settings

FabienD/docker-stack

Repository files navigation

Github Actions GitHub release Codecov dependency status GitHub license

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

"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.

asciicast

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.

About

A pre-configured docker-compose files collection helping web developers. Additional Cli to manage registered compose files from everywhere in the terminal.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages