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.
keys
(name, basepath='/etc/pki', **kwargs)¶Manage libvirt keys.
The name variable used to track the execution
Defaults to /etc/pki
, this is the root location used for libvirt
keys on the hypervisor
The 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.
name --
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