1
0
mirror of https://github.com/inofix/common-inv.git synced 2026-02-05 18:45:47 +01:00
Files
common-inv/README.md
Michael Lustenberger 5a79bfbc96 Add the main README
Take over the README from our internal repo which contains a few hints
on how one can get started.
2017-02-20 22:51:51 +01:00

1.3 KiB

Main Reclass Inventory

This reclass[1] inventory is intended to be used from the maestro.sh[2] script.

It consists of two subdirectories 'nodes' and 'classes'. For details, please visit the reclass[1] documentation, only the very basics are covered here.

A class is a yaml file that bundles information which can be used by certain nodes/hosts. This is sometimes also called 'a group'. The classes constitute the branches of the inventory tree.

Classes can reference each other and are searched deeply, in the order of appearance and only once. The more common value is overwritten by the more specific, lists and maps are expanded.

Nodes are the leafes of the inventory tree, and reference the classes mentioned above. The nodes (aka 'hosts') are organized in projects.

A project is simply a subdirectory of 'nodes' and usually has an associated class ('classes/project/{project-name}.yml') that is referenced by all its hosts.

For further details of nodes, classes, or their elements, please also see the README file inside the respective directory or subdirectory.


[1] http://reclass.pantsfullofunix.net/

[2] https://github.com/zwischenloesung/common-playbooks