=========================

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.

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

2.9.x**.

The role also utilises the ``dig`` lookup plugin which requires ``dnspython``

package to be installed. Make sure you have the package available on controller

machine.

Why were these roles created?

-----------------------------

     Expire-Date:0

     %no-protection

     %commit

     EOF

8. Generate the preseed files:

  .. code-block:: shell

     ansible-playbook playbooks/preseed.yml

9. Install all servers using the generated preseed files. Use *Debian

10. Add the SSH host fingerprints to your ``known_hosts`` file (don't forget to

    remove old entries if you are redoing the process). You can easily obtain all

    the necessary fingerprints with command (don't forget to modify domain if you

    need to):

    .. code-block:: shell

      ssh-keyscan -t ed25519 mail.example.com ldap.example.com xmpp.example.com web.example.com backup.example.com ws01.example.com $(dig +short mail.example.com) $(dig +short ldap.example.com) $(dig +short xmpp.example.com) $(dig +short web.example.com) $(dig +short backup.example.com) $(dig +short ws01.example.com)

11. Invoke the ``bootstrap.yml`` playbook in order to set-up some basic

    environment for Ansible runs on all servers:

=================================

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.

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

2.9.x**.

The role also utilises the ``dig`` lookup plugin which requires ``dnspython``

package to be installed. Make sure you have the package available on controller

machine.

Contents

========

NEXT RELEASE

------------

Upgrade to Ansible 2.9.x.

Breaking changes:

* Switched to Ansible 2.9.x, removing support for older versions. All

  documentation has been updated.

Bug fixes:

* ``common`` role

  * Run apticron at least once during initial installation to avoid

    accidental locking later on during the same playbook run.

New features/improvements:

* Tests have been updated to work with latest Molecule/Testinfra as

  part of the Ansible upgrade process.