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 2 things :

  • A Docker Compose compatible CLI, but with more features; try it!
  • A collection of Docker Compose files that aims to provide a functional common web stack for developers. It's easy to intergrate your own projects around the stack.

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,

  • no need to be in the project folder,
  • no need to know new commands and arguments, "dclt" use the same ones as docker compose, you won't be lost,

With dctl, you can manage your project from everywhere in your terminal.

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