/docs/MyDocs

Inventory

=========

 Allows to define group of nodes and set parameters (facts). This group of nodes, then, are used in playbooks and roles

 to configure specific services. Standard ini file format is used.

 

 [group1]                                                       - defines a group of nodes

 node.org                                                       - just a signle node

 node.org var1=val1 var2=val2                                   - add nodes and sets some facts about it

 node[1:3].org                                                  - add to group multiple nodes with similar names

 

 [multi-group:children]                                         - define a group of ndoes which assembled from other groups

 group1

 group2

 

 [group1:vars]                                                  - define variables for all nodes in the group

 var1=val1

 var2=val2

 

 

 

Using groups

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

 - name: Execute set of tasks on specified group of nodes

   hosts: group1                                                - all nodes belongign to group1

   hosts: group1:group2                                         - all nodes belonging to either group1 or group2 (or both)

   hosts: group1:group2:!group3                                 - all nodes belonging to group1 or group2, but not belonging to group3

 

 

 Looping over inventory

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

  - mod: <params>                                               - The node params can be addressed like hostvars[item]['openshift_hostname']

    with_inventory_hostnames: [ 'nodes' ]                       

 

 

Virtual groups

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

 Normally, the groups are used to specify types of nodes 'web-servers', 'databases' to perform specific configuration tasks. However, often

 there is multiple types of setups. Lets say staging setup for devlopment and production setup. So, the nodes could be grouped in multiple 

 ways web vs database or staging vs production. We would define all relevant group of nodes sharing common parameters (all 4 types: web, db,

 staging, production) and set these parameters in the files in 'group_vars' folder. Then, the included inventory will specify what have to

 be configured in the specific setup.