For the key certificate this state uses the external pillar in the master to call for the generation and signing of certificates for systems running libvirt:
libvirt_keys:
virt.keys
salt.states.virt.
__virtual__
()¶Only if virt module is available.
Returns: |
---|
salt.states.virt.
keys
(name, basepath=u'/etc/pki', **kwargs)¶Manage libvirt keys.
/etc/pki
, this is the root location used for libvirt
keys on the hypervisorThe following parameters are optional:
- country
- The country that the certificate should use. Defaults to US.
New in version 2018.3.0.
- state
- The state that the certificate should use. Defaults to Utah.
New in version 2018.3.0.
- locality
- The locality that the certificate should use. Defaults to Salt Lake City.
New in version 2018.3.0.
- organization
- The organization that the certificate should use. Defaults to Salted.
New in version 2018.3.0.
- expiration_days
- The number of days that the certificate should be valid for. Defaults to 365 days (1 year)
New in version 2018.3.0.
salt.states.virt.
powered_off
(name)¶Stops a VM by power off.
New in version 2016.3.0.
domain_name:
virt.stopped
salt.states.virt.
rebooted
(name)¶Reboots VMs
New in version 2016.3.0.
Parameters: | name -- |
---|---|
Returns: |
salt.states.virt.
reverted
(name, snapshot=None, cleanup=False)¶Deprecated since version 2016.3.0.
Reverts to the particular snapshot.
New in version 2016.3.0.
domain_name:
virt.reverted:
- cleanup: True
domain_name_1:
virt.reverted:
- snapshot: snapshot_name
- cleanup: False
salt.states.virt.
running
(name, **kwargs)¶Starts an existing guest, or defines and starts a new VM with specified arguments.
New in version 2016.3.0.
domain_name:
virt.running
domain_name:
virt.running:
- cpu: 2
- mem: 2048
- eth0_mac: 00:00:6a:53:00:e3
salt.states.virt.
saved
(name, suffix=None)¶Deprecated since version 2016.3.0: Use snapshot()
instead.
Takes a snapshot of a particular VM or by a UNIX-style wildcard.
New in version 2016.3.0.
domain_name:
virt.saved:
- suffix: periodic
domain*:
virt.saved:
- suffix: periodic
salt.states.virt.
snapshot
(name, suffix=None)¶Takes a snapshot of a particular VM or by a UNIX-style wildcard.
New in version 2016.3.0.
domain_name:
virt.snapshot:
- suffix: periodic
domain*:
virt.snapshot:
- suffix: periodic
salt.states.virt.
stopped
(name)¶Stops a VM by shutting it down nicely.
New in version 2016.3.0.
domain_name:
virt.stopped
salt.states.virt.
unpowered
(name)¶Deprecated since version 2016.3.0: Use powered_off()
instead.
Stops a VM by power off.
New in version 2016.3.0.
domain_name:
virt.stopped
Docs for previous releases are available on readthedocs.org.
Latest Salt release: 2018.3.0