ansible/docsite/rst/index.rst
2012-10-25 14:14:34 +02:00

76 lines
2 KiB
ReStructuredText

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
Ansible Resources
`````````````````
.. toctree::
:maxdepth: 0
contrib
Miscellaneous
`````````````
A list of some people using Ansible.
.. toctree::
:maxdepth: 1
who_uses_ansible