This repository was archived by the owner on Jul 16, 2025. It is now read-only.
Repository navigation
v2.0.0 – Breaking Changes & Rollback Support
This major release introduces automatic rollback, improved network validation and simplifies configuration by replacing deprecated inputs.
Breaking Changes
- Replaced
stack_filesandcompose_fileswithdeploy_file- Now accepts only a single file
- Any supporting files (e.g.
.env,config.yml) should be moved toextra_files
Migration Example
Before (v1.x):
stack_files: docker-stack.yml,docker-stack-dev.yml
extra_files: .env,config.ymlAfter (v2.x):
deploy_file: docker-stack.yml
extra_files: .env,config.ymlNew Features
-
Automatic Rollback on Failed Deployments
- Swarm Mode: Uses
docker service update --rollback - Compose Mode: Restores the last known good
deploy_fileif services fail to start
- Swarm Mode: Uses
-
Improved Network Management
- Validates existing Docker networks and warns if the driver does not match
- Verifies
overlaydriver and issues warnings if Swarm is inactive - Adds support for
docker_network_attachable
Bug Fixes and Improvements
- Removed the need for
sudowhen creating theproject_pathdirectory - Switched SSH command execution from here-doc (
EOF) tobash -sto suppress MOTD messages - Improved Docker Compose version detection:
- Supports both
docker-compose(v1) anddocker compose(v2)
- Supports both
Tags
v2.0.0: Latest major release with breaking changesv2: Stable tag for latest v2.x features
Important: Workflows using stack_files or compose_files must migrate to deploy_file to continue functioning with v2.x.