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 
(cherry picked from commit 10c5d9e749)
This commit is contained in:
chouseknecht 2016-05-18 14:11:11 -04:00
parent a6150dbc14
commit 1aa39ae78b
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: 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 docker_container
Manages the container lifecycle by providing the ability to create, update, stop, start and destroy a Manages the container lifecycle by providing the ability to create, update, stop, start and destroy a
container. 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 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 integrated set of tools for orchestrating containers. In addition to the above modules, we are also working on the
inventory script were refactored to use a common set of parameters and environment variables for shaping Docker API following:
connections. The docker_container and docker_image_facts modules are new.
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 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 $ 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 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. 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 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`_ `Parameters`_