Wiki-Tech.io/Configuration/Ansible/Inventaires.md

title	description	published	date	tags	editor	dateCreated
Ansible - Les inventaires	Créer et gérer les inventaires Ansible	true	2021-07-09T14:10:01.810Z	ansible, configuration	markdown	2021-07-09T08:01:35.009Z

La struturation

Informations

inventory = inventaire des machines et de leurs variables inventory =

• fichier d'inventaire
• répertoire group_vars
• répertoire host_vars

Eléments éssentiels car il décrit votre infra :

• vos serveurs
• vos types de serveurs

Deux types d'instances :

• hosts
• groupes

Plusieurs formats :

• ini = plat
• yaml = plus homogène
• json = pour manipuler

Possiblité d'utiliser des patterns

Groupe racine => all

Groupes enfants

Exemple :

• un groupe parent1
  • groupes enfants : enfant1 et enfant2
    • "sous" enfant de enfant2 : enfant3

parent1 = srv4
		enfant1 = srv1 et srv2
		enfant2 = srv3
			enfant3= srv5

Format init

[parent1]
srv4
[enfant1]
srv1
srv2
[enfant2]
srv3
[enfant3]
srv5
[parent1:children]
groupe1
groupe2
[enfant2:children]
enfant3

Format yaml

all:
  children:
    parent1:
      hosts:
        srv4:
      children:
        enfant1:
          hosts:
            srv1:
            srv2:
        enfant2:
          hosts:
            srv3:
        children:
          enfant3:
            hosts:
              srv5:

Passer un groupe à un autre groupe :

all: 
  children:
    parent1:
      parent2:
      hosts:
        srv4:
      children:
        enfant1:
          hosts:
            srv1:
            srv2:
        enfant2:
          hosts:
            srv3:
          children:
            enfant3:
              hosts:
                srv5:
    parent2:
      hosts:
        srv6:
        srv7:
        srv8:
        srv9:

Utilisation de pattern :

all: 
  children:
    parent1:
      parent2:
      hosts:
        srv4:
      children:
        enfant1:
          hosts:
            srv[1:2]:
        enfant2:
          hosts:
            srv3:
          children:
            enfant3:
              hosts:
                srv5:
    parent2:
      hosts:
        srv[6:]:

Un peu plus vers la pratique

• couche commune > common
• serveurs web nginx > webserver
• bases de données > dbserver
• applications dockerisées ou non > app / appdock

Monitoring qui semble lié à toutes les machines users > monitoring

all:
  children:
    common:
      children:
        webserver:
          hosts:
            srv[1:4]:
        dbserver:
          hosts:
            srv[5:6]:
        app:
          hosts:
            srv[7:10]:
        appdock:
          hosts:
            srv[11:15]:
    monitoring:
      children:
        common:

Format Json

https://linuxhint.com/ansible_inventory_json_format/

Les variables d'inventaires

Informations

ansible = forte précédence des variables (ordre hiérarchique)

Regroupement par famille :

• Configuration settings
• Command-line options > VARIABLES D'INVENTAIRES
• Playbook keywords
• Variables

22 types:

        command line values (eg “-u user”)
        role defaults [1]
        inventory file or script group vars [2]
        inventory group_vars/all [3]
        playbook group_vars/all [3]
        inventory group_vars/* [3]
        playbook group_vars/* [3]
        inventory file or script host vars [2]
        inventory host_vars/* [3]
        playbook host_vars/* [3]
        host facts / cached set_facts [4]
        play vars
        play vars_prompt
        play vars_files
        role vars (defined in role/vars/main.yml)
        block vars (only for tasks in block)
        task vars (only for the task)
        include_vars
        set_facts / registered vars
        role (and include_role) params
        include params
        extra vars (always win precedence)

Doc : https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html

Variables d'inventaires

• fichier d'inventaire
• group_vars (répertoire)
• host_vars (répertoire)

Squelette

├── 00_inventory.yml
├── group_vars
│   ├── all.yml
│   ├── dbserver.yml
│   └── webserver
│       ├── vault.yml
│       └── webserver.yml
└── host_vars
    ├── srv1
    │   └── srv1.yml
    └── srv2.yml

Multienv

multienv >> c'est facile !!!

├── dev
│   ├── 00_inventory.yml
│   ├── group_vars
│   │   ├── all.yml
│   │   ├── dbserver.yml
│   │   └── webserver
│   │       ├── vault.yml
│   │       └── webserver.yml
│   └── host_vars
│       ├── srv1
│       │   └── srv1.yml
│       └── srv2.yml
├── prod
│   ├── 00_inventory.yml
│   ├── group_vars
│   │   ├── all.yml
│   │   ├── dbserver.yml
│   │   └── webserver
│   │       ├── vault.yml
│   │       └── webserver.yml
│   └── host_vars
│       ├── srv1
│       │   └── srv1.yml
│       └── srv2.yml
└── stage
    ├── 00_inventory.yml
    ├── group_vars
    │   ├── all.yml
    │   ├── dbserver.yml
    │   └── webserver
    │       ├── vault.yml
    │       └── webserver.yml
    └── host_vars
        ├── srv1
        │   └── srv1.yml
        └── srv2.yml

Commande de test

ansible -i "node2," all -b -e "var1=xavki" -m debug -a 'msg={{ var1 }}'

Exemples

Inventory :

all:
  children:
    common:
      children:
        webserver:
          hosts:
            node[2:3]:
          vars:
            var1: "webserver"
        dbserver:
          hosts:
            node4:
            node5:
              var1: "node5"
          vars:
            var1: "dbserver"
    monitoring:
      children:
        webserver:
        dbserver:

Autour des group_vars

├── group_vars
│   ├── dbserver.yml
│   └── webserver.yml
└── inventory.yml

Ou encore

├── group_vars
│   ├── dbserver
│   │   └── dbserver.yml
│   └── webserver
│       └── webserver.yml
└── inventory.yml

Autour des host_vars

├── group_vars
│   ├── dbserver
│   │   └── dbserver.yml
│   └── webserver
│       └── webserver.yml
├── host_vars
│   ├── node2
│   │   └── variables.yml
│   └── node5.yml
└── inventory.yml

Et si on ajoutait un host au hasard et appartenant à "all"

all:
  children:
    common:
      children:
        webserver:
          hosts:
            node[2:3]:
        dbserver:
          hosts:
            node4:
            node5:
    monitoring:
      hosts:
        node6:
      children:
        webserver:
        dbserver:

├── group_vars
│   ├── all.yml
│   ├── dbserver
│   │   └── dbserver.yml
│   └── webserver
│       └── webserver.yml
├── host_vars
│   ├── node2
│   │   └── variables.yml
│   └── node5.yml
└── inventory.yml

La commande et le graph

Commande ansible-inventory

• pour y voir plus clair
• pour grapher

Export au format json par défaut (serveurs et variables d'inventaire)

ansible-inventory -i <inventory_file> --list
ansible-inventory -i <inventory_file> --yaml

Plus compact

ansible-inventory -i 00_inventory.yml --list --export

Afficher un format compact sans variables

ansible-inventory -i <inventory_file> --graph

Avec les variables

ansible-inventory -i 00_inventory.yml --graph --vars

Export vers un fichier

ansible-inventory -i <inventory_file> --output

Format toml

pip3 install toml
ansible-inventory -i <inventory_file> --vars --toml

Mettre sous forme de graphique

pip3 install ansible-inventory-grapher
sudo apt install graphviz graphicsmagick-imagemagick-compat
ansible-inventory-grapher -i inventory.yml all | dot -Tpng | display png:-