This charm provides Docker. Docker is an open platform for developers and sysadmins to build, ship, and run distributed applications. Consisting of Docker Engine, a portable, lightweight runtime and packaging tool, and Docker Hub, a cloud service for sharing applications and automating workflows, Docker enables apps to be quickly assembled from components and eliminates the friction between development, QA, and production environments
There's a full documentation site that serves as a manual/accompanyment to this charm. have a look at the Github Pages Docsite for more in-depth information about the charm, development patterns, and usage instructions.
Step by step instructions on using the docker charm:
juju deploy cs:~lazypower/trusty/docker
Scaling out the docker service is as simple as adding additional docker units to expand your cluster. However, you will need an SDN solution to provide cross host networking. See the Known Limitations and issues about this.
- latest : By default the charm assumes installation from the ubuntu repositories. If you wish to deploy the latest upstream docker runtime enable this option.
Performance will suffer on an AWS t1.micro unit - as it has such a limited amount of ram. Between the juju unit-agent, and the docker daemon + workloads - you will only be able to run the smallest of deployments on them. Thus it is not recommended.
The Docker Charm will not work out of the box on the local provider. LXC containers are goverend by a very strict App Armor policy that prevents accidental misuses of privilege inside the container. Thus running the Docker Charm inside the local provider is not a supported deployment method.
Additional information will be made available after more research has been done on enabling the Docker charm to be deployed into a LXC container environment, and while unsupported it will outline the process to enable such scenarios for users that wish to test on the local provider.
By default, docker deploys a host-only bridge adapter. Containers are able to communicate with one
another if you forward host ports to the containers using the -p
option. More on this in the
Deploying Containers docpage.
There are other ways to enable cross-host communication using Supporting Charms that will enable an overlay-network - but are outside the scope of these help pages.
There is no support for installation of the docker service in offline environments. There is however a bug to track the progress of this feature.
- Author: Charles Butler <charles.butler@ubuntu.com>