ansible-collections/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2025-08-22 14:01:42 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Merge pull request #15917 from chouseknecht/doc-updates

Browse source 
Docker guide updates
This commit is contained in:
Chris Houseknecht 2016-05-18 15:07:49 -04:00
commit 16a3b69549
1 changed files with 22 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

27
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/ansible/ansible-container>`_,
and start building images from your Ansible playbooks.
Use the *shipit* command in `ansible-container <https://github.com/ansible/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 `Ansible proposal repo <https://github.com/ansible/proposals/tree/master/docker>`_.
Requirements Requirements
------------ ------------
@ -36,7 +47,13 @@ installed on the host running Ansible. You will need to have >= 1.7.0 installed.
.. code-block:: bash .. code-block:: bash
$ 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
@ -44,7 +61,7 @@ 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`_