virt: expose live parameter in virt.defined state

Allow updating the definition of a VM without touching the live
instance. This can be helpful since live update may change the device
names in the guest.
This commit is contained in:
Cédric Bosdonnat 2020-09-30 16:03:59 +02:00 committed by Daniel Wozniak
parent 9714bd00fa
commit 0a3ebb7750
2 changed files with 9 additions and 1 deletions

1
changelog/58589.added Normal file
View file

@ -0,0 +1 @@
Allow handling special first boot definition on virtual machine

View file

@ -292,6 +292,7 @@ def defined(
serials=None,
consoles=None,
stop_on_reboot=False,
live=True,
):
"""
Starts an existing guest, or defines and starts a new VM with specified arguments.
@ -585,6 +586,12 @@ def defined(
.. versionadded:: Aluminium
:param live:
If set to ``False`` the changes will not be applied live to the running instance, but will
only apply at the next start. Note that reboot will not take those changes.
.. versionadded:: Aluminium
.. rubric:: Example States
Make sure a virtual machine called ``domain_name`` is defined:
@ -642,7 +649,7 @@ def defined(
nic_profile=nic_profile,
interfaces=interfaces,
graphics=graphics,
live=True,
live=live,
connection=connection,
username=username,
password=password,