|
|
|
|
|
|
|
|
|
|
|
|
|
|
Ansible Documentation
|
|
|
|
|
`````````````````````
|
|
|
|
|
|
|
|
|
|
This page contains documentation about how to use `Ansible <http://ansible.cc>`_.
|
|
|
|
|
|
|
|
|
|
Before we dive into playbooks, configuration management, deployment, and orchestration, learn how to get Ansible installed and some
|
|
|
|
|
basic information. We'll go over how to execute ad-hoc commands in parallel across your nodes using /usr/bin/ansible. We'll also see
|
|
|
|
|
what sort of modules are available in Ansible's core (though you can also write your own, which we'll also show later).
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
|
|
|
|
gettingstarted
|
|
|
|
|
patterns
|
|
|
|
|
examples
|
|
|
|
|
modules
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Overview
|
|
|
|
|
````````
|
|
|
|
|
|
|
|
|
|
.. image:: http://ansible.cc/img/ansible_arch.png
|
|
|
|
|
:alt: ansible architecture diagram
|
|
|
|
|
:width: 566px
|
|
|
|
|
:height: 439px
|
|
|
|
|
|
|
|
|
|
Playbooks
|
|
|
|
|
`````````
|
|
|
|
|
|
|
|
|
|
Playbooks are Ansible's orchestration language. At a basic level, playbooks can be used to manage configurations and deployments
|
|
|
|
|
of remote machines. At a more advanced level, they can sequence multi-tier rollouts involving rolling updates, and can delegate actions
|
|
|
|
|
to other hosts, interacting with monitoring servers and load balancers along the way. You can start small and pick up more features
|
|
|
|
|
over time as you need them. Playbooks are designed to be human-readable and are developed in a basic text language. There are multiple
|
|
|
|
|
ways to organize playbooks and the files they include, and we'll offer up some suggestions on that and making the most out of Ansible.
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
|
|
|
|
playbooks
|
|
|
|
|
playbooks2
|
|
|
|
|
bestpractices
|
|
|
|
|
YAMLSyntax
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Developer Information
|
|
|
|
|
`````````````````````
|
|
|
|
|
|
|
|
|
|
Learn how to build modules of your own in any language. Explore Ansible's Python API and write Python plugins to integrate
|
|
|
|
|
with other solutions in your environment.
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
|
|
|
|
api
|
|
|
|
|
moduledev
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Miscellaneous
|
|
|
|
|
`````````````
|
|
|
|
|
|
|
|
|
|
A list of some people using Ansible, and some additional resources.
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
|
|
|
|
who_uses_ansible
|
|
|
|
|
contrib
|
|
|
|
|
|
