DevStroke ZDD

Zero Downtime Deployment system with Docker

How it works

ZDD works with Docker services that expose one or more ports. It pulls and starts 2 containers, mapping services on differents host ports.

The main goal is to have a zero downtime deployment on a single server architecture.

I works for example with a Nginx load balancing system (take a look here)

Check the full project example here

Installation

Pythonic way

pip install https://github.com/devstroke-io/zdd/archive/master.zip

Download binary

sudo sh -c 'curl -L https://github.com/devstroke-io/zdd/releases/download/0.1.0/zdd-linux-x64 -o /usr/bin/zdd && chmod u+x /usr/bin/zdd'

Configuration

Create a file ~/.config/zdd.json Home used must be the one of the user who will launch the script

Configuration example:

{
"projects": {
"project1": {
"active": true,
"docker_image": "repository/project1",
"docker_params": {
"default": {
"ports": {
"80/tcp": 8000
}
},
"instance_2": {
"ports": {
"80/tcp": 8001
}
}
}
},
"project2": {
"active": false,
"docker_image": "repository/project2"
}
}
}

• active key specifies if the project can be deployed or not.
• docker_image key specifies docker hub link.
• docker_params key specifies container parameters at start.

ZDD internally use docker-py. Image parameters are available to https://docker-py.readthedocs.io/en/stable/containers.html

Usage

Usage: zdd [OPTIONS] PROJECT [TAG]
Deploy PROJECT with TAG (default 'latest')
Options:
-V, --version Show the version and exit.
-q, --quiet no output
-v, --verbose verbosity level
-h, --help Show this message and exit.

Contributing

@TODO

Build binary

pyinstaller --onefile zdd.py

Produce binary dist/zdd

Binary built depends of plateform used