This subordinate charm deploys the Docker engine within a running Juju charm application. Docker is an open platform for developers and sysadmins to build, ship, and run distributed applications in containers.

Docker containers wrap a piece of software in a complete file system that contains everything needed to run an application on a server.

Docker focuses on distributing applications as containers that can be quickly assembled from components that are run the same on different servers without environmental dependencies. This eliminates the friction between development, QA, and production environments.

The following states are set by this subordinate:

• endpoint.{relation name}.available

  This state is set when docker is available for use.

The Docker subordinate charm is to be used with principal charms that need a container runtime. To use, we deploy the Docker subordinate charm and then relate it to the principal charm.

juju deploy cs:~containers/docker
juju add-relation docker [principal charm]

This charm will automatically scale out with the principal charm.

See config.yaml for list of configuration options.

This charm also installs the 'docker-compose' python package using pip. So once the charm has finished installing you have the ability to use Docker Compose functionality such as control files, and logging.

This charm is available at https://jujucharms.com/docker and contains the open source operations code to deploy on all public clouds in the Juju ecosystem.

• The Docker homepage
• Docker documentation for help with Docker commands.
• Docker forums for community discussions.
• Check the Docker issue tracker for bugs or problems with the Docker software.
• The charm-docker is the GitHub repository that contains the reactive code to build this Charm.
• Check the charm-docker issue-tracker for bugs or problems related to the Charm.