2. Playbooks
The following chapters describe the playbooks of this project.
There is a common structure for all playbooks which is explained using the example of playbooks/gnuhealth.yml and inventories/dev:
On the top of the playbook you can see a line hosts: gnuhealth. This group of hosts is defined in inventories/dev/hosts. Besides Ansible loads variable files for all matching groups of a host from inventories/dev/group_vars. As a simple alternative to gnuhealth.yml you can also call gnuhealth_minimal.yml which only contains the installtion with default configuration options without the roles for further system administration.
If you are not familiar with Ansible you should check its variable precedence rules. Most of the time variables are taken from inventories group_vars and roles defaults and vars in this repository. Often users set variables using inventories host_vars or extra vars. Other variables are set during playbooks execution but those are unlikely to be overridden by user configuration. Given those examples for variable definitions you would have the following priorities:
extra vars > role vars > inventory host_vars > inventory group_vars > role defaults