Release of grains plugin to racktables-contribs
[racktables-contribs] / yaml_import / README
CommitLineData
905faf7c
DO
1yaml_import:
2Author: Tommy Botten Jensen <tommybjensen@gmail.com>
3
4
5The plugin uses the autogenerated .yaml files from puppet to create objects in racktables.
6It has been tested with puppet 0.25.x and racktables 0.18.4. And feedback/changes are always welcome.
7
8Installation:
9- Copy the yaml_import.php and the bundled spyc.php file into the inc/ folder of racktables.
10- Create a folder 'yamls' in the racktable root directory. This is where you put your YAML files.
11- Add 'include yaml_import.php' to your inc/local.php -file
12 - You can link to puppets yaml folder (which by default is /var/lib/puppet/yaml/node)
13 - Or nfs mount it.
14 - or rsync... etc.
15
16In use:
17
18After logging into racktables, you can reach the import tab from the "Objects"-section. You will see a tab marked 'import'.
19Here you will see a list that shows all hostnames from the .yaml files with the ones not represented in racktables database
20marked as red.
21
22
23
24Known issues:
25- The plugin is name centric. If you change a hosts name, it will seem like a entirely new object to racktables. It will also fail because of identical IPs, nics and so forth. The "unique" identifier in puppet uses hostid which is not unique at all.
26
27- The application doesn't do input sanitation and has not been tested for SQL injections or filesystem scan attacks. You must, however be logged in to gain access to the import plugin.
28
29