ansible-qubes/library/qubesformation.py

35 lines
1.2 KiB
Python

DOCUMENTATION = """
---
module: qubesformation
author: Manuel Amador (Rudd-O) <rudd-o@rudd-o.com>
short_description: provision VMs via a generated Qubes Salt Management recipe.
version_added: 0.0
description:
- 'This module lets you provision VMs and enforce VM settings on a
collection of VMs derived from your Ansible inventory. Note that
this module does not accept simple arguments -- you must specify
complex arguments in the form of a dictionary below the module name.'
options:
dest:
required: true
description:
- |
Where to deposit the recipe -- usually a path like
`/srv/user_salt/<formation name>.sls`). Will create
two files:
1. The file you specified in `description`.
2. An additional file with a .top extension instead of the
original extension of the file you specified.
others:
description:
- All arguments accepted by the M(template) module also work here,
except for `src` and `content`.
required: false
"""
EXAMPLES = r"""
# Would create `/srv/user_salt/formation.sls` and `/srv/user_salt/formation.top`.
- qubesformation:
dest: /srv/user_salt/formation.sls
"""