salt-extend
is a templating tool for extending SaltStack. If you're looking to add a module to
SaltStack, then the salt-extend
utility can guide you through the process.
You can use Salt Extend to quickly create templated modules for adding new behaviours to some of the module subsystems within Salt.
Salt Extend takes a template directory and merges it into a SaltStack source code directory.
See salt-extend
The following templates are available:
Creates a new execution module within salt/modules/{{module_name}}.py
Creates a new execution module unit test suite within tests/unit/modules/{{module_name}}_test.py
Creates a new state module within salt/states/{{module_name}}.py
Creates a new state module unit test suite within tests/unit/states/{{module_name}}_test.py
template.yml
containing properties for
description
- a description of the templatequestions
- a collection of additional questions to ask the user, the name of the item will be used as the key in the context dictionary within the jinja template.
question
- The question to ask the user, as a stringdefault
- (optional) the default value, can contain Jinja2 template syntax and has access to the default context properties
description: "Execution module"
questions:
depending_libraries:
question: "What libraries does this module depend upon?"
virtual_name:
question: "What module virtual name to use?"
default: "{{module_name}}"
Note
File names can contain Jinja 2 template syntax, e.g. '{{module_name}}.py}}'
print('Hello {{module_name}}')
__virtual__ = '{{__virtual_name__}}'
The default context provides the following properties
description
- A description of the templateshort_description
- A short description of the module as entered by the userversion
- The version name of the next releasemodule_name
- The module name as entered by the userrelease_date
- The current date in the format YYYY-MM-DDyear
- The current year in the format YYYYAs well as any additional properties entered from the questions section of template.yml
A templating tool for extending SaltStack.
Takes a template directory and merges it into a SaltStack source code directory. This tool uses Jinja2 for templating.
This tool is accessed using salt-extend
salt.utils.extend.
apply_template
(template_dir, output_dir, context)¶Apply the template from the template directory to the output using the supplied context dict.
Parameters: |
|
---|
salt.utils.extend.
run
(extension=None, name=None, description=None, salt_dir=None, merge=False, temp_dir=None)¶A template factory for extending the salt ecosystem
Parameters: |
|
---|