Salt-cumulus is a small salt state, providing an easy way to configure the configuration of a cumulus switch.
It provides a simple interface to apply net
commands from a template.
It does not provide anything else for the moment. Most of others changes can be done via usual salt states.
This is a beta version. Use it at your own risk!
Simply run the following command on your switch:
pip install salt-cumulus
You can use in your sls files the following state:
test_config:
cumulus.managed:
- source: salt://config
Assuming the config file look like:
net add time ntp server ch.pool.ntp.org
The state will parse the lines in your templated file and run each command starting with net add
or net del
. Others elements are ignored, so you may add comments or other data as you like, but we suggest you starts comments with #
.
Warning
Running this state will abort any pending configuration first: you should avoid using the net
command at the same time!
Source file. Behave as the source
argument of file.managed
.
Hash of the file. Behave as the hash
argument of file.managed
.
Type of hash. Behave as the hash_name
argument of file.managed
.
Skip hash verification. Behave as the skip_verify
argument of file.managed
.
Template format. Default to jinja
. Behave as the template
argument of file.managed
.
Data pased to the template. Behave as the as the context
argument of file.managed
.
Default values for the context. Behave as the defaults
argument of file.managed
.
Commit changes when the state is applied. Default to True
, setting it to False
will revert changes (but will try to run them).