https://github.com/FabienD/docker-stack
A pre-configured docker-compose files collection helping web developers. Additional Cli to manage registered compose files from everywhere in the terminal.
https://github.com/FabienD/docker-stack
cli compose developer-tools development docker docker-compose-files helper-tool rust
Last synced: 25 days ago
JSON representation
A pre-configured docker-compose files collection helping web developers. Additional Cli to manage registered compose files from everywhere in the terminal.
- Host: GitHub
- URL: https://github.com/FabienD/docker-stack
- Owner: FabienD
- License: gpl-3.0
- Created: 2022-05-16T07:45:04.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-09T14:48:01.000Z (about 1 month ago)
- Last Synced: 2025-03-09T15:22:55.447Z (about 1 month ago)
- Topics: cli, compose, developer-tools, development, docker, docker-compose-files, helper-tool, rust
- Language: Rust
- Homepage:
- Size: 543 KB
- Stars: 20
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-docker - dctl - dctl is a Cli tool that helps developers by allowing them to execute all docker compose commands anywhere in the terminal, and more. By [FabienD](https://github.com/FabienD) (Container Operations / User Interface)
- awesome-docker - dctl - dctl is a Cli tool that helps developers by allowing them to execute all docker compose commands anywhere in the terminal, and more. By [FabienD](https://github.com/FabienD) (Container Operations / User Interface)
- awesome-docker - dctl - dctl is a Cli tool that helps developers by allowing them to execute all docker compose commands anywhere in the terminal, and more. By [FabienD](https://github.com/FabienD) (Container Operations / User Interface)
README
[](https://github.com/FabienD/docker-stack/actions)
[](https://github.com/FabienD/docker-stack/releases)
[](https://codecov.io/github/FabienD/docker-stack)
[](https://deps.rs/repo/github/FabienD/docker-stack?path=cli)
[](https://github.com/FabienD/docker-stack/blob/main/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**](doc/dctl.md) and [**compose files collection**](doc/collection.md) 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](doc/dctl.md)
- Your local stack for web development. [A collection of docker-compose files](doc/collection.md)
- The project [change log](CHANGELOG.md)
## "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.
[](https://asciinema.org/a/7VwsLtJmxzZ2HCkbim3kUQ21e)
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](doc/dctl.md)
## Roadmap / next steps
- [ ] Documentation - add examples of docker-compose files for local development.
### v1
- [x] ~~Build - Plublish the cli tool for multiples platforms (Windows, Mac, Linux), different architectures (x86, arm, arm64).~~
- [x] ~~Cli - improve check-config cli command, better presentation.~~
- [x] ~~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
- [ ] Use a better architecture for the cli tool, improve the code quality.
## Contributing
Contributions are welcome, feel free to open an issue or a pull request.