mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
76 lines
2.1 KiB
ReStructuredText
76 lines
2.1 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
|
|
|
|
Tips and Tricks
|
|
```````````````
|
|
|
|
`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!
|
|
|
|
Miscellaneous
|
|
`````````````
|
|
|
|
A list of some people using Ansible, and some additional resources:
|
|
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
who_uses_ansible
|
|
contrib
|
|
glossary
|
|
|