/docker-bundle

A Juju bundle of the docker charms.
  1. Python 97.3%
  2. Shell 2.7%
Python Shell
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tests
README.md
bundles.yaml
bw-dockerwhale.svg

README.md

docker-bundle

The Docker Core bundle uses juju to deploy 2 docker hosts (ie "units"), etcd, and flannel overlay networking to 'bootstrap' a docker container cluster farm.

Current and Most Complete Information

TL;DR Usage

For the simplest deployment scenario, you will need juju and juju quickstart and some credentials for a supported cloud. On ubuntu:

"sudo apt-get install juju-core juju-quickstart"
  • If not on ubuntu, you may want to use the jujubox Docker image. *

Clone the bundle repository cloned locally and run this command to set up your cloud credentials and run the bundle:

juju quickstart docker-core/bundles.yaml

This will bootstrap your active environment (if one is not already active) and deploy the services.

Using the your new docker "cluster"

To interact with your dockers, use juju ssh to get console on the unit:

juju ssh docker/0 -t sudo tmux

Use juju run to run remotely commands as root:

juju run --service "docker ps"

Do some dockering

Let's launch and expose a simple web page.

juju ssh docker/0 -t sudo tmux
docker run --name mynginx2 \
  -v /var/www:/usr/share/nginx/html:ro \
  -v /var/nginx/conf:/etc/nginx:ro \
  -P -d nginx
cat "<html><body>HELLO</body></html>" > /var/www/index.html

Let's grab the http port:

pip install docker-py
export NGINX_PORT=$(python -c "import docker; dc = docker.Client(); print(next(x['PublicPort'] for x in dc.containers()[0]['Ports'] if x['PrivatePort'] == 80))")

juju-run docker/0 "open-port ${NGINX_PORT}"
echo $NGINX_PORT

Now let's hit the page:

export DKR_IP=$(juju status --format=oneline | grep '^- docker/0'  | cut -d" " -f3)
curl $DKR_IP:$NGINX_PORT

Scaling up the cluster

To scale the container farm, simply add more units to the docker service:

juju add-unit docker
juju add-unit -n5 docker

Known Limitations

This bundle will not work on the local provider or when using --to lxc scenarios. AppArmor has a very stringent default policy that breaks the functionality of docker/flannel being embedded in LXC.

ETCD is currently deployed as a single node, and has not been tested by adding additional ETCD units. This can provide a single point of failure if the ETCD unit were to 'go away'.

The bundle makes assumptions about each service being on it's own machine. Its a common practice to deploy the ETCD unit to the state-server if you have the capacity to co-locate on machine 0 of your environment

juju deploy cs:~hazmat/trusty/etcd --to 0