====== Ansible Roles ======

Have a look at our [[https://git.fws.fr/fws/ansible-roles|ansible roles]], we deploy a lot of stuff with it :-)

===== First steps =====

Before you can use our ansible roles, you'll have to setup a few things. Follow [[.basic:start|this guide]] for this.

===== How roles are configured =====

This [[.basic:role_config|this guide]] for a quick explanation of how roles are used and configured

===== Create a playbook =====

Ansible will read what is called a playbook to know what it has to do, on which hosts, on which order. See [[.basic:playbooks|this guide]] for a quick introduction on playbooks.

===== Common role =====

A lot of roles are dependant on other ones, and most expect the common role to be deployed. The common role will configure lots of things on the system, like

  * Configure LDAP or AD authentication (if needed)
  * Setup sudo rules for administrator groups
  * Deploy ssh keys of your admins
  * System tuning (swapiness, specific sysctl etc.)

Here's [[.basic:role_common|a guide]] for the most relevant variables if you want to use this role

===== Other roles =====


==== OpenXPKI ====

  * [[.:openxpki:upgrade_el8|Upgrade from EL7 to EL8]]

==== Graylog ====

  * [[.:graylog:upgrade_el8|Upgrade from EL7 to EL8]]

==== Appsmith ====

  * [[.:appsmith:install_el8|Install Appsmith on EL8]]