Skip to content
This repository was archived by the owner on Jul 16, 2025. It is now read-only.

Choose a tag to compare

@alcharra alcharra released this 14 Mar 23:14
· 9 commits to main since this release
7d6ad53

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_files and compose_files with deploy_file
    • Now accepts only a single file
    • Any supporting files (e.g. .env, config.yml) should be moved to extra_files

Migration Example

Before (v1.x):

stack_files: docker-stack.yml,docker-stack-dev.yml
extra_files: .env,config.yml

After (v2.x):

deploy_file: docker-stack.yml
extra_files: .env,config.yml

New Features

  • Automatic Rollback on Failed Deployments

    • Swarm Mode: Uses docker service update --rollback
    • Compose Mode: Restores the last known good deploy_file if services fail to start
  • Improved Network Management

    • Validates existing Docker networks and warns if the driver does not match
    • Verifies overlay driver and issues warnings if Swarm is inactive
    • Adds support for docker_network_attachable

Bug Fixes and Improvements

  • Removed the need for sudo when creating the project_path directory
  • Switched SSH command execution from here-doc (EOF) to bash -s to suppress MOTD messages
  • Improved Docker Compose version detection:
    • Supports both docker-compose (v1) and docker compose (v2)

Tags

  • v2.0.0: Latest major release with breaking changes
  • v2: 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.