README
¶
doco-cd - Docker Compose Continuous Deployment
GitOps for Docker Compose
Doco-CD is a lightweight, declarative GitOps continuous delivery tool that automatically deploys and updates Docker Compose projects/services and Swarm stacks using polling and webhooks.
You can think of it as a simple Portainer or ArgoCD alternative for Docker.
[!NOTE] The documentation is now available at doco.cd. The old GitHub wiki is no longer available.
Features
- Easy to set up and use.
- Runs with a minimal (distroless) image
- Built in Go with tiny RAM and CPU requirements.
- Supports various external secret management providers and data encryption with SOPS
- Can deploy applications via webhooks and/or polling.
- Supports various Git providers
- Supports OCI artifacts and Git repositories for deployment configurations.
- Supports both Docker Compose projects and Swarm stacks in Swarm mode.
- Provides notifications and Prometheus metrics for monitoring.
- Supports Job Scheduling / Cron Jobs for running periodic tasks.
Documentation
You can find the documentation at doco.cd.
Community
- Ask questions or discuss ideas on GitHub Discussions
- Report bugs or suggest features by opening an issue
Contributing
Contributions are welcome! Please see the contributing guidelines for more information.
Support the Project
If you would like to support the development of Doco-CD, please consider becoming a sponsor on GitHub Sponsors.
Doco-CD is proudly supported by
Star History
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
doco-cd
command
|
|
|
internal
|
|
|
certrotation
Package certrotation implements a background watcher that automatically rotates certificates issued through rotation-capable external secret providers (currently only OpenBao PKI roles, see internal/secretprovider/openbao) before they expire.
|
Package certrotation implements a background watcher that automatically rotates certificates issued through rotation-capable external secret providers (currently only OpenBao PKI roles, see internal/secretprovider/openbao) before they expire. |
|
common/defaults
Package defaults applies struct-tag defaults to Go structs.
|
Package defaults applies struct-tag defaults to Go structs. |
|
common/validation
Package validation provides struct-tag validation helpers and custom validator registration for internal config types.
|
Package validation provides struct-tag validation helpers and custom validator registration for internal config types. |
|
source
Package source resolves a deployment's source, either a Git repository or an OCI artifact, into a ready-to-deploy local checkout.
|
Package source resolves a deployment's source, either a Git repository or an OCI artifact, into a ready-to-deploy local checkout. |
Click to show internal directories.
Click to hide internal directories.