2012-03-07 17:35:18 +01:00
2012-10-17 00:00:41 +02:00
2013-05-02 17:31:16 +02:00
Ansible Documentation Index
`` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ``
2012-10-17 00:00:41 +02:00
2013-03-19 19:46:30 +01:00
.. image :: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
2013-03-25 15:56:32 +01:00
:target: http://ansibleworks.com/fest
2012-10-17 00:00:41 +02:00
2013-06-08 20:15:10 +02:00
Welcome to the Ansible documentation. This documentation covers the current released
version of Ansible (1.2) and may also reference some development version features (and if so,
such sections will be noted).
2013-03-19 19:46:30 +01:00
Before we dive into playbooks, configuration management, deployment, and orchestration, we'll learn how to get Ansible installed and some
2013-04-19 04:36:06 +02:00
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
2012-10-17 00:00:41 +02:00
what sort of modules are available in Ansible's core (though you can also write your own, which we'll also show later).
2012-03-07 17:35:18 +01:00
2013-03-19 19:46:30 +01:00
2012-03-07 17:35:18 +01:00
.. toctree ::
2012-07-28 04:16:14 +02:00
:maxdepth: 1
2012-03-07 17:35:18 +01:00
gettingstarted
patterns
2012-03-09 04:50:00 +01:00
examples
2012-03-07 17:35:18 +01:00
modules
2012-10-17 00:00:41 +02:00
Overview
`` ` ` ` ` ``
.. image :: http://ansible.cc/img/ansible_arch.png
2013-04-19 04:36:06 +02:00
:alt: ansible architecture diagram
2012-10-17 00:00:41 +02:00
:width: 566px
:height: 439px
2013-03-19 19:46:30 +01:00
2012-10-17 00:00:41 +02:00
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
2013-04-19 04:36:06 +02:00
to other hosts, interacting with monitoring servers and load balancers along the way. You can start small and pick up more features
2012-10-17 00:00:41 +02:00
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
2012-03-07 17:35:18 +01:00
playbooks
2012-05-13 17:00:02 +02:00
playbooks2
2012-05-13 17:56:09 +02:00
bestpractices
2012-10-17 00:00:41 +02:00
YAMLSyntax
2013-03-20 17:45:41 +01:00
Example Playbooks <https://github.com/ansible/ansible-examples>
2012-10-17 00:00:41 +02:00
2013-05-29 16:25:54 +02:00
Specific Solutions
`` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ``
A chance to dive into some more topics in depth:
2013-05-29 20:17:32 +02:00
.. toctree ::
:maxdepth: 1
2013-05-29 16:25:54 +02:00
amazon_web_services
2012-10-17 00:00:41 +02:00
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
2012-03-07 17:35:18 +01:00
api
2012-03-14 17:50:40 +01:00
moduledev
2012-08-03 06:01:23 +02:00
2012-10-18 04:28:24 +02:00
Miscellaneous
`` ` ` ` ` ` ` ` ` ` ``
2013-03-22 14:08:53 +01:00
`Learn and share neat Ansible tricks on Coderwall <https://coderwall.com/p/t/ansible> `_ - sign-in using GitHub or Twitter to vote on top tips and add your own!
`A list of some Ansible users and quotes about Ansible <http://www.ansibleworks.com/users> `_ .
2013-02-09 19:46:13 +01:00
2013-03-22 14:08:53 +01:00
More links:
2012-10-18 04:28:24 +02:00
.. toctree ::
:maxdepth: 1
2013-04-15 01:31:47 +02:00
faq
2012-10-26 05:17:05 +02:00
contrib
2013-02-17 00:36:06 +01:00
glossary
2012-10-17 00:00:41 +02:00
