reclass configuration fileΒΆ

reclass can read some of its configuration from a file. The file is a YAML-file and simply defines key-value pairs.

The configuration file can be used to set defaults for all the options that are otherwise configurable via the command-line interface, so please use the --help output of reclass (or the manual page) for reference. The command-line option --nodes-uri corresponds to the key nodes_uri in the configuration file. For example:

storage_type: yaml_fs
pretty_print: True
output: json
inventory_base_uri: /etc/reclass
nodes_uri: ../nodes

reclass first looks in the current directory for the file called reclass-config.yml (see reclass/defaults.py) and if no such file is found, it looks in $HOME, then in /etc/reclass, and then “next to” the reclass script itself, i.e. if the script is symlinked to /srv/provisioning/reclass, then the the script will try to access /srv/provisioning/reclass-config.yml.

Note that yaml_fs is currently the only supported storage_type, and it’s the default if you don’t set it.

Adapters may implement their own lookup logic, of course, so make sure to read their documentation (for Salt, for Ansible, and for Puppet).

Previous topic

reclass manpage

Next topic

Using reclass with Salt