Majic Ansible Roles documentation
=================================

Majic Ansible Roles is a collection of Ansible roles that are used on regular
basis for deployment and maintenance of Majic infrastructure.

The roles are kept as a separate project in hope of making them potentially
useful to wider audience, and for reference purposes.

Roles cover different aspects of infrastructure, such as mail servers, web
servers, web applications etc. The roles are mainly well-suited for smaller
installations.

Roles are written for use with *Debian GNU/Linux*. For more details on
supported releases, see :ref:`rolereference`.

At the moment, the roles have been written for and tested against
**Ansible 11.5.x**.

The roles also utilise the ``ipv4/ipv6`` lookup plugins which require
``netaddr`` package to be installed. The ``passlib`` package is used
for hashing the operating system passwords. Make sure you have the
packages available on controller machine.


Contents
========

.. toctree::
   :maxdepth: 2

   about
   usage
   rolereference
   development
   releaseprocedures
   releasenotes

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`