wbrawner/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add docker_service and mention ansible-container.

Browse source
This commit is contained in:
chouseknecht 2016-05-18 14:11:11 -04:00
parent a485395b02
commit 10c5d9e749
No known key found for this signature in database
GPG key ID: 78F1698C5705A81B
1 changed files with 21 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
docsite/rst/guide_docker.rst
View file

@ -3,6 +3,10 @@ Getting Started with Docker
Ansible offers the following modules for orchestrating Docker containers:
docker_service
Use your existing Docker compose files to orchestrate containers on a single Docker daemon or on
Swarm. Supports compose versions 1 and 2.
docker_container
Manages the container lifecycle by providing the ability to create, update, stop, start and destroy a
container.
@ -23,10 +27,17 @@ Ansible offers the following modules for orchestrating Docker containers:
Ansible 2.1.0 includes major updates to the Docker modules, marking the start of a project to create a complete and
integrated set of tools for orchestrating containers. The docker_image and docker_login modules as well as the dynamic
inventory script were refactored to use a common set of parameters and environment variables for shaping Docker API
connections. The docker_container and docker_image_facts modules are new.
integrated set of tools for orchestrating containers. In addition to the above modules, we are also working on the
following:
Still using Dockerfile to build images? Check out `ansible-container <https://github.com/j00bar/ansible-container>`_,
and start building images from your Ansible playbooks.
Use the 'shipit' command in `ansible-container <https://github.com/j00bar/ansible-container>`_
to launch your docker-compose file on `OpenShift <https://www.openshift.org/>`_. Go from an app on your laptop to a fully
scalable app in the cloud in just a few moments.
There's more planned. See the latest ideas and thinking at the `Ansbile proposal repo <https://github.com/ansible/proposals/tree/master/docker>`_.
Requirements
------------
@ -38,13 +49,19 @@ installed on the host running Ansible. You will need to have >= 1.7.0 installed.
$ pip install docker-py>=1.7.0
The docker_service module also requires `docker-compose <https://github.com/docker/compose>`_
.. code-block:: bash
$ pip install docker-compose>=1.7.0
Connecting to the Docker API
----------------------------
You can connect to a local or remote API using parameters passed to each task or by setting environment variables.
The order of precedence is command line parameters and then environment variables. If neither a command line
option for a environment variable is found, then a default value will be used. The default values are provided under
option or an environment variable is found, a default value will be used. The default values are provided under
`Parameters`_