Requirements¶
You need an accessible Docker Engine API, and the ability to launch
privileged containers with host networking. Docker can be local or remote.
If remote, set DOCKER_HOST
and the other environment variables
to configure the URL and credentials. Generally, if the docker
cli
works, so should Blockade.
Docker Swarm is not supported at this time.
Installing¶
Blockade can be installed via pip
or easy_install
:
$ pip install blockade
macOS or Windows¶
Blockade works on macOS either natively pointing to a remote Docker Engine API or via Docker for Mac.
Blockade does not support Windows native containers. Nor is it known to work with Docker for Windows, but this may be possible. One option is to run Blockade itself in a container, in daemon mode, and talk to it via the REST API.
Another great option is Vagrant, to run Blockade and Docker in a Linux VM.
Use the included Vagrantfile
or another approach to get Docker and
Blockade installed into a Linux VM. If you have Vagrant installed, running
vagrant up
from the Blockade checkout directory should get you started.
Note that this may take a while, to download needed VMs and Docker containers.