Ansible roles to manage your infrastructure in an automated and reproducible way.

The goal of this repository is to provide a fully blown Ansible roles set to manage your infrastructure in an automated fashion whilst providing full reproducibility.

All roles support at least the following distributions:

• Debian 7 & 8 & 9
• Ubuntu 14.04 & 16.04
• Centos 6 & 7

In addition the roles take care of the necessary SELinux configuration if required.

In order to use the roles please make sure to fulfill the following requirements:

• FQDN configured on the target host
• Ansible 2.0+ is used

Below the required steps to include the roles into your playbooks and projects:

1. Create a project directory (git repository with playbooks, roles, group_vars and/or host_vars)
2. Add this repository as a git submodule (git submodule add https://github.com/adfinis-sygroup/ansible-roles.git adfinis-roles)
3. Configure Ansible to use the additional roles path

[defaults]
ansible_managed     = Warning: File is managed by Ansible [https://github.com/adfinis-sygroup/ansible-roles.git]
retry_files_enabled = False
hostfile            = ./hosts
roles_path          = ./adfinis-roles

4. Create your own project specific roles in the directory roles, Ansible will use both directories (with precedence of roles).

Currently the repository features the following roles:

Contributions are more than welcome! Please feel free to open new issues or pull requests.

We have some contribution rules:

• Each change, regardless if it's a new role, a bug fix, a feature request, or another change, must be a merge request and another person must review it.
• The language is English, in the documentation, for pull requests, issues and also commit messages.
• Each role is listed in the README.
• Each role must have a meta information file ($ROLE/meta/main.yml).
• We use multiple features, like issue-tracker, pull-request, labels for requests and issues.
• The continuous integration must pass.

To setup the development environment you should clone the repository ansible-guide.

git clone https://github.com/adfinis-sygroup/ansible-guide.git
cd ansible-guide
git submodule update --init

There is a vagrant box for each supported distribution. vagrant up will start all boxes one by one and will automatically provision those with Ansible. To restart a provisioning task, you can use vagrant provision <distribution>.

The continuous integration (CI) will do some checks, like

• yaml syntax check
• Ansible syntax check
• Ansible linting (for best current practice and some additional checks)

GNU GENERAL PUBLIC LICENSE Version 3

See the LICENSE file.