File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/states/__pycache__/virt.cpython-310.pyc
Back
o ;j6@ � @ s( d Z ddlZddlZddlZddlZddlZddlZddlZddl m Z m Z zddl Z dZ W n ey9 dZ Y nw dZe�e�Zdd� Zd-d d �Z d.d d �Zd/dd�Zd/dd�Z d0dd�Z d1dd�Zd.dd�Zd/dd�Zdd� Z d2d d �Z d3d d �Z d4d d!�Z d4d"d#�Z h d$�Z! d5d%d&�Z" d5d'd(�Z#d6d)d*�Z$ d7d+d,�Z%dS )8z� Manage virt =========== 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: .. code-block:: yaml libvirt_keys: virt.keys � N)�CommandExecutionError�SaltInvocationErrorTFZvirtc C s dt v rtS dS )z9 Only if virt module is available. :return: zvirt.node_info)Fz virt module could not be loaded)�__salt__�__virtualname__� r r �D/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/virt.py� __virtual__% s r �/etc/pkic K s | i ddd�}i }|� � D ] \}}||d|� �< q td ddi|�}tj�|ddd �tj�|dd �tj�|ddd �tj�|dd �tj�|d d�d�}|D ]`}d|� d�} | |vrYqLtj�tj�|| ��spt�tj�|| �� tj�|| �r�t j j � || d��} t j j �| �� �|| kr�d|d |< W d � n1 s�w Y qLd|d |< qL|d s�d|d< |S td r�d|d< d|d< i |d< |S |d D ],}t j j � || d ��} | �t j j �|d|� d� �� W d � n1 s�w Y q�d |d< |S ) a� Manage libvirt keys. name The name variable used to track the execution basepath 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. .. versionadded:: 2018.3.0 state The state that the certificate should use. Defaults to Utah. .. versionadded:: 2018.3.0 locality The locality that the certificate should use. Defaults to Salt Lake City. .. versionadded:: 2018.3.0 organization The organization that the certificate should use. Defaults to Salted. .. versionadded:: 2018.3.0 expiration_days The number of days that the certificate should be valid for. Defaults to 365 days (1 year) .. versionadded:: 2018.3.0 T� ��name�changes�result�commentzext_pillar_virt.z pillar.ext�libvirt�_Zprivatez serverkey.pemzservercert.pemz clientkey.pemzclientcert.pem�CAz cacert.pem)Z serverkeyZ servercertZ clientkeyZ clientcertZcacertzlibvirt.z.pem�r�updater N�newzAll keys are correctr �testr z"Libvirt keys are set to be updatedzw+z Updated libvirt certs and keys)�itemsr �os�path�join�exists�dirname�makedirs�isfile�salt�utils�filesZfopenZ stringutilsZ to_unicode�read�__opts__�writeZto_str) r Zbasepath�kwargs�retZ pillar_kwargs�key�valueZpillar�pathsZp_keyZfp_r r r �keys0 sP *� � �� � �" ��r* c K s\ t d sdnd} | i | dd�} t�td � | �} t� } t� } t� }| D ]e}zFd}|dur9td |�}|�|�|k}|red}t d s[td|� � |f|||d �|��}t|t�r[|d }| �d |||i� n|�|� W q# t j y� } z| �|t |�d �� W Y d}~q#d}~ww | s�| o�t | �| d < d| d< | r�d| i| d< | S || i| d< || d< | S )a� Helper to call the virt functions. Wildcards supported. :param domain: the domain to apply the function on. Can contain wildcards. :param function: virt function to call :param section: key for the changed domains in the return changes dictionary :param comment: comment to return :param state: the expected final state of the VM. If None the VM state won't be checked. :return: the salt state return r TNr r �virt.list_domains� virt.vm_statezvirt.�� connection�username�passwordr �domain�r1 Zissuer zNo changes had happenedr �ignoredr ) r# �fnmatch�filterr �list�get� isinstance�dict�appendr � libvirtError�str�bool)r1 �function�sectionr �stater. r/ r0 r% r r& Ztargeted_domainsZchanged_domains�ignored_domainsZnoaction_domainsZtargeted_domainZ action_needed� domain_state�response�errr r r � _virt_call� sT ��� � �� �rE c C s t | dddd|||d�S )a� Stops a VM by shutting it down nicely. .. versionadded:: 2016.3.0 :param connection: libvirt connection URI, overriding defaults .. versionadded:: 2019.2.0 :param username: username to connect with, overriding defaults .. versionadded:: 2019.2.0 :param password: password to connect with, overriding defaults .. versionadded:: 2019.2.0 .. code-block:: yaml domain_name: virt.stopped �shutdown�stoppedzMachine has been shut down�r@ r. r/ r0 �rE �r r. r/ r0 r r r rG � s �rG c C s t | dddd|||d�S )a� Stops a VM by power off. .. versionadded:: 2016.3.0 :param connection: libvirt connection URI, overriding defaults .. versionadded:: 2019.2.0 :param username: username to connect with, overriding defaults .. versionadded:: 2019.2.0 :param password: password to connect with, overriding defaults .. versionadded:: 2019.2.0 .. code-block:: yaml domain_name: virt.stopped �stop� unpowered� Machine has been powered offrF rH rI rJ r r r � powered_off� s �rN c C s\ | i t d sdnddd�} �z | td | ||d�v r�td | fi d |�d |�d |�d |�d |�d|�d|�d|�d| �d|�d|�d|�d|�d|�d|�dt d �d|�d|�d|�d|�d |�d | ��} | | d | < | �d �s�i | d < d | � d!�| d"< d| d#< W | S | �d$�r�d | � d%�| d"< W | S d | � d&�| d"< W | S t d s�td' | fi d |�d |�d(|�d)|�d*|�d+|�d |�d,|�d|�d|�d-| �d.| �d/| �d0| �d| �d|�d|�d|�d|�d|�d|�d1d2�d|�d|�d|�d|�d |�� d di| d | < d | � d3�| d"< W | S tj�y- } zt| �| d"< d2| d#< W Y d} ~ | S d} ~ ww )4a1 Starts an existing guest, or defines and starts a new VM with specified arguments. .. versionadded:: 3001 :param name: name of the virtual machine to run :param cpu: Number of virtual CPUs to assign to the virtual machine or a dictionary with detailed information to configure cpu model and topology, numa node tuning, cpu tuning and iothreads allocation. The structure of the dictionary is documented in :ref:`init-cpu-def`. .. code-block:: yaml cpu: placement: static cpuset: 0-11 current: 5 maximum: 12 vcpus: 0: enabled: 'yes' hotpluggable: 'no' order: 1 1: enabled: 'no' hotpluggable: 'yes' match: minimum mode: custom check: full vendor: Intel model: name: core2duo fallback: allow vendor_id: GenuineIntel topology: sockets: 1 cores: 12 threads: 1 cache: level: 3 mode: emulate feature: policy: optional name: lahf_lm numa: 0: cpus: 0-3 memory: 1g discard: 'yes' distances: 0: 10 # sibling id : value 1: 21 2: 31 3: 41 1: cpus: 4-6 memory: 1g memAccess: shared distances: 0: 21 1: 10 2: 21 3: 31 tuning: vcpupin: 0: 1-4,^2 # vcpuid : cpuset 1: 0,1 2: 2,3 3: 0,4 emulatorpin: 1-3 iothreadpin: 1: 5,6 # iothread id: cpuset 2: 7,8 shares: 2048 period: 1000000 quota: -1 global_period: 1000000 global_quota: -1 emulator_period: 1000000 emulator_quota: -1 iothread_period: 1000000 iothread_quota: -1 vcpusched: - scheduler: fifo priority: 1 - scheduler: fifo priority: 2 vcpus: 1-3 - scheduler: rr priority: 3 vcpus: 4 iothreadsched: - scheduler: batch iothreads: 2 emulatorsched: scheduler: idle cachetune: 0-3: # vcpus set 0: # cache id level: 3 type: both size: 4 1: level: 3 type: both size: 6 monitor: 1: 3 0-3: 3 4-5: monitor: 4: 3 # vcpus: level 5: 3 memorytune: 0-3: # vcpus set 0: 60 # node id: bandwidth 4-5: 0: 60 iothreads: 4 .. versionadded:: 3003 :param mem: Amount of memory to allocate to the virtual machine in MiB. Since 3002, a dictionary can be used to contain detailed configuration which support memory allocation or tuning. Supported parameters are ``boot``, ``current``, ``max``, ``slots``, ``hard_limit``, ``soft_limit``, ``swap_hard_limit``, ``min_guarantee``, ``hugepages`` , ``nosharepages``, ``locked``, ``source``, ``access``, ``allocation`` and ``discard``. The structure of the dictionary is documented in :ref:`init-mem-def`. Both decimal and binary base are supported. Detail unit specification is documented in :ref:`virt-units`. Please note that the value for ``slots`` must be an integer. .. code-block:: yaml boot: 1g current: 1g max: 1g slots: 10 hard_limit: 1024 soft_limit: 512m swap_hard_limit: 1g min_guarantee: 512mib hugepages: - size: 2m - nodeset: 0-2 size: 1g - nodeset: 3 size: 2g nosharepages: True locked: True source: file access: shared allocation: immediate discard: True .. versionchanged:: 3002 :param vm_type: force virtual machine type for the new VM. The default value is taken from the host capabilities. This could be useful for example to use ``'qemu'`` type instead of the ``'kvm'`` one. :param disk_profile: Name of the disk profile to use for the new virtual machine :param disks: List of disk to create for the new virtual machine. See :ref:`init-disk-def` for more details on the items on this list. :param nic_profile: Name of the network interfaces profile to use for the new virtual machine :param interfaces: List of network interfaces to create for the new virtual machine. See :ref:`init-nic-def` for more details on the items on this list. :param graphics: Graphics device to create for the new virtual machine. See :ref:`init-graphics-def` for more details on this dictionary :param saltenv: Fileserver environment (Default: ``'base'``). See :mod:`cp module for more details <salt.modules.cp>` :param seed: ``True`` to seed the disk image. Only used when the ``image`` parameter is provided. (Default: ``True``) :param install: install salt minion if absent (Default: ``True``) :param pub_key: public key to seed with (Default: ``None``) :param priv_key: public key to seed with (Default: ``None``) :param seed_cmd: Salt command to execute to seed the image. (Default: ``'seed.apply'``) :param connection: libvirt connection URI, overriding defaults :param username: username to connect with, overriding defaults :param password: password to connect with, overriding defaults :param os_type: type of virtualization as found in the ``//os/type`` element of the libvirt definition. The default value is taken from the host capabilities, with a preference for ``hvm``. Only used when creating a new virtual machine. :param arch: architecture of the virtual machine. The default value is taken from the host capabilities, but ``x86_64`` is prefed over ``i686``. Only used when creating a new virtual machine. :param boot: Specifies kernel, initial ramdisk and kernel command line parameters for the virtual machine. This is an optional parameter, all of the keys are optional within the dictionary. Refer to :ref:`init-boot-def` for the complete boot parameters description. To update any boot parameters, specify the new path for each. To remove any boot parameters, pass a None object, for instance: 'kernel': ``None``. .. versionadded:: 3000 :param boot_dev: Space separated list of devices to boot from sorted by decreasing priority. Values can be ``hd``, ``fd``, ``cdrom`` or ``network``. By default, the value will ``"hd"``. .. versionadded:: 3002 :param numatune: The optional numatune element provides details of how to tune the performance of a NUMA host via controlling NUMA policy for domain process. The optional ``memory`` element specifies how to allocate memory for the domain process on a NUMA host. ``memnode`` elements can specify memory allocation policies per each guest NUMA node. The definition used in the dictionary can be found at :ref:`init-cpu-def`. .. versionadded:: 3003 .. code-block:: python { 'memory': {'mode': 'strict', 'nodeset': '0-11'}, 'memnodes': {0: {'mode': 'strict', 'nodeset': 1}, 1: {'mode': 'preferred', 'nodeset': 2}} } :param hypervisor_features: Enable or disable hypervisor-specific features on the virtual machine. .. versionadded:: 3003 .. code-block:: yaml hypervisor_features: kvm-hint-dedicated: True :param clock: Configure the guest clock. The value is a dictionary with the following keys: adjustment time adjustment in seconds or ``reset`` utc set to ``False`` to use the host local time as the guest clock. Defaults to ``True``. timezone synchronize the guest to the correspding timezone timers a dictionary associating the timer name with its configuration. This configuration is a dictionary with the properties ``track``, ``tickpolicy``, ``catchup``, ``frequency``, ``mode``, ``present``, ``slew``, ``threshold`` and ``limit``. See `libvirt time keeping documentation <https://libvirt.org/formatdomain.html#time-keeping>`_ for the possible values. .. versionadded:: 3003 Set the clock to local time using an offset in seconds .. code-block:: yaml clock: adjustment: 3600 utc: False Set the clock to a specific time zone: .. code-block:: yaml clock: timezone: CEST :param serials: Dictionary providing details on the serials connection to create. (Default: ``None``) See :ref:`init-chardevs-def` for more details on the possible values. .. versionadded:: 3003 :param consoles: Dictionary providing details on the consoles device to create. (Default: ``None``) See :ref:`init-chardevs-def` for more details on the possible values. .. versionadded:: 3003 :param stop_on_reboot: If set to ``True`` the guest will stop instead of rebooting. This is specially useful when creating a virtual machine with an installation cdrom or an autoinstallation needing a special first boot configuration. Defaults to ``False`` .. versionadded:: 3003 :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:: 3003 :param host_devices: List of host devices to passthrough to the guest. The value is a list of device names as provided by the :py:func:`~salt.modules.virt.node_devices` function. (Default: ``None``) .. versionadded:: 3003 :param autostart: If set to ``True`` the host will start the guest after boot. (Default: ``False``) .. rubric:: Example States Make sure a virtual machine called ``domain_name`` is defined: .. code-block:: yaml domain_name: virt.defined: - cpu: 2 - mem: 2048 - boot_dev: network hd - disk_profile: prod - disks: - name: system size: 8192 overlay_image: True pool: default image: /path/to/image.qcow2 - name: data size: 16834 - nic_profile: prod - interfaces: - name: eth0 mac: 01:23:45:67:89:AB - name: eth1 type: network source: admin - graphics: type: spice listen: type: address address: 192.168.0.125 r TNr r r+ r- z virt.update�cpu�mem� disk_profile�disks� nic_profile� interfaces�graphics�liver. r/ r0 �boot�numatune�serials�consoles�boot_dev�hypervisor_features�clock�stop_on_reboot� host_devices� autostartr � definition�Domain � unchangedr r �errorsz% updated with live update(s) failures� updatedz virt.init�os_type�archZ hypervisor�diskZnic�seed�install�pub_key�priv_key�startF� defined)r# r r7 r r; r< ) r rO rP �vm_typerQ rR rS rT rU ri rj rk rl r. r/ r0 rf rg rW rX r[ r\ r] rY rZ r^ rV r_ r` r& �statusrD r r r �defined s v���������� � � � � ����������� , �*�(��������� � � � � ��������������� � � ��rq c # C s� |} t | fi d|�d|�d|�d|�d| �d|�d|�d|�d | �d | �d | �d | �d |�d|�d|�d|�d|�d|�d|�d|�d| �d|�d|�d|�d|�d|�d|��} td s_d nd } | d d u sk| d r�| d �| i ��d!d"�} zZtd# | �} | �| �d$kr�td s�td% | | ||d&� d'| � d(�}!| d) �d*�s�d+�| d) �}!|!| d)< | | d vr�i | d | < d | d | d,< W | S | s�d'| � d-�| d)< W | S W | S tjy� }" zt|"�| d)< d"| d < W Y d }"~"| S d }"~"ww | S ).a�% Starts an existing guest, or defines and starts a new VM with specified arguments. .. versionadded:: 2016.3.0 :param name: name of the virtual machine to run :param cpu: Number of virtual CPUs to assign to the virtual machine or a dictionary with detailed information to configure cpu model and topology, numa node tuning, cpu tuning and iothreads allocation. The structure of the dictionary is documented in :ref:`init-cpu-def`. To update any cpu parameters specify the new values to the corresponding tag. To remove any element or attribute, specify ``None`` object. Please note that ``None`` object is mapped to ``null`` in yaml, use ``null`` in sls file instead. :param mem: Amount of memory to allocate to the virtual machine in MiB. Since 3002, a dictionary can be used to contain detailed configuration which support memory allocation or tuning. Supported parameters are ``boot``, ``current``, ``max``, ``slots``, ``hard_limit``, ``soft_limit``, ``swap_hard_limit``, ``min_guarantee``, ``hugepages`` , ``nosharepages``, ``locked``, ``source``, ``access``, ``allocation`` and ``discard``. The structure of the dictionary is documented in :ref:`init-mem-def`. Both decimal and binary base are supported. Detail unit specification is documented in :ref:`virt-units`. Please note that the value for ``slots`` must be an integer. To remove any parameters, pass a None object, for instance: 'soft_limit': ``None``. Please note that ``None`` is mapped to ``null`` in sls file, pass ``null`` in sls file instead. .. code-block:: yaml - mem: hard_limit: null soft_limit: null .. versionchanged:: 3002 :param vm_type: force virtual machine type for the new VM. The default value is taken from the host capabilities. This could be useful for example to use ``'qemu'`` type instead of the ``'kvm'`` one. .. versionadded:: 2019.2.0 :param disk_profile: Name of the disk profile to use for the new virtual machine .. versionadded:: 2019.2.0 :param disks: List of disk to create for the new virtual machine. See :ref:`init-disk-def` for more details on the items on this list. .. versionadded:: 2019.2.0 :param nic_profile: Name of the network interfaces profile to use for the new virtual machine .. versionadded:: 2019.2.0 :param interfaces: List of network interfaces to create for the new virtual machine. See :ref:`init-nic-def` for more details on the items on this list. .. versionadded:: 2019.2.0 :param graphics: Graphics device to create for the new virtual machine. See :ref:`init-graphics-def` for more details on this dictionary .. versionadded:: 2019.2.0 :param saltenv: Fileserver environment (Default: ``'base'``). See :mod:`cp module for more details <salt.modules.cp>` .. versionadded:: 2019.2.0 :param seed: ``True`` to seed the disk image. Only used when the ``image`` parameter is provided. (Default: ``True``) .. versionadded:: 2019.2.0 :param install: install salt minion if absent (Default: ``True``) .. versionadded:: 2019.2.0 :param pub_key: public key to seed with (Default: ``None``) .. versionadded:: 2019.2.0 :param priv_key: public key to seed with (Default: ``None``) .. versionadded:: 2019.2.0 :param seed_cmd: Salt command to execute to seed the image. (Default: ``'seed.apply'``) .. versionadded:: 2019.2.0 :param connection: libvirt connection URI, overriding defaults .. versionadded:: 2019.2.0 :param username: username to connect with, overriding defaults .. versionadded:: 2019.2.0 :param password: password to connect with, overriding defaults .. versionadded:: 2019.2.0 :param os_type: type of virtualization as found in the ``//os/type`` element of the libvirt definition. The default value is taken from the host capabilities, with a preference for ``hvm``. Only used when creating a new virtual machine. .. versionadded:: 3000 :param arch: architecture of the virtual machine. The default value is taken from the host capabilities, but ``x86_64`` is prefed over ``i686``. Only used when creating a new virtual machine. .. versionadded:: 3000 :param boot: Specifies kernel, initial ramdisk and kernel command line parameters for the virtual machine. This is an optional parameter, all of the keys are optional within the dictionary. Refer to :ref:`init-boot-def` for the complete boot parameters description. To update any boot parameters, specify the new path for each. To remove any boot parameters, pass a None object, for instance: 'kernel': ``None``. .. versionadded:: 3000 :param serials: Dictionary providing details on the serials connection to create. (Default: ``None``) See :ref:`init-chardevs-def` for more details on the possible values. .. versionadded:: 3003 :param consoles: Dictionary providing details on the consoles device to create. (Default: ``None``) See :ref:`init-chardevs-def` for more details on the possible values. .. versionadded:: 3003 :param boot_dev: Space separated list of devices to boot from sorted by decreasing priority. Values can be ``hd``, ``fd``, ``cdrom`` or ``network``. By default, the value will ``"hd"``. .. versionadded:: 3002 :param numatune: The optional numatune element provides details of how to tune the performance of a NUMA host via controlling NUMA policy for domain process. The optional ``memory`` element specifies how to allocate memory for the domain process on a NUMA host. ``memnode`` elements can specify memory allocation policies per each guest NUMA node. The definition used in the dictionary can be found at :ref:`init-cpu-def`. To update any numatune parameters, specify the new value. To remove any ``numatune`` parameters, pass a None object, for instance: 'numatune': ``None``. Please note that ``None`` is mapped to ``null`` in sls file, pass ``null`` in sls file instead. .. versionadded:: 3003 :param stop_on_reboot: If set to ``True`` the guest will stop instead of rebooting. This is specially useful when creating a virtual machine with an installation cdrom or an autoinstallation needing a special first boot configuration. Defaults to ``False`` .. versionadded:: 3003 :param hypervisor_features: Enable or disable hypervisor-specific features on the virtual machine. .. versionadded:: 3003 .. code-block:: yaml hypervisor_features: kvm-hint-dedicated: True :param clock: Configure the guest clock. The value is a dictionary with the following keys: adjustment time adjustment in seconds or ``reset`` utc set to ``False`` to use the host local time as the guest clock. Defaults to ``True``. timezone synchronize the guest to the correspding timezone timers a dictionary associating the timer name with its configuration. This configuration is a dictionary with the properties ``track``, ``tickpolicy``, ``catchup``, ``frequency``, ``mode``, ``present``, ``slew``, ``threshold`` and ``limit``. See `libvirt time keeping documentation <https://libvirt.org/formatdomain.html#time-keeping>`_ for the possible values. .. versionadded:: 3003 Set the clock to local time using an offset in seconds .. code-block:: yaml clock: adjustment: 3600 utc: False Set the clock to a specific time zone: .. code-block:: yaml clock: timezone: CEST :param host_devices: List of host devices to passthrough to the guest. The value is a list of device names as provided by the :py:func:`~salt.modules.virt.node_devices` function. (Default: ``None``) .. versionadded:: 3003 :param autostart: If set to ``True`` the host will start the guest after boot. (Default: ``False``) .. rubric:: Example States Make sure an already-defined virtual machine called ``domain_name`` is running: .. code-block:: yaml domain_name: virt.running Do the same, but define the virtual machine if needed: .. code-block:: yaml domain_name: virt.running: - cpu: 2 - mem: 2048 - disk_profile: prod - boot_dev: network hd - disks: - name: system size: 8192 overlay_image: True pool: default image: /path/to/image.qcow2 - name: data size: 16834 - nic_profile: prod - interfaces: - name: eth0 mac: 01:23:45:67:89:AB - name: eth1 type: network source: admin - graphics: type: spice listen: type: address address: 192.168.0.125 rO rP ro rQ rR rS rT rU ri rj rk rl rf rg rW r[ rX r\ r] r^ r. r/ r0 rY rZ r_ r` r TNr r ra Fr, �runningz virt.startr- rb z startedr Z unchanged�{} and started�startedz exists and is running) rq r# r7 r �endswith�formatr r; r< )#r rO rP ro rQ rR rS rT rU ri rj rk rl r. r/ r0 rf rg rW r[ rX r\ r] rY rZ r^ r_ r` Z merged_disksr& r �changedrB r rD r r r rr � s� �������� � � � � ��������������� � � ��� ��rr c C s t | ddd||||d�S )aR Takes a snapshot of a particular VM or by a UNIX-style wildcard. .. versionadded:: 2016.3.0 :param connection: libvirt connection URI, overriding defaults .. versionadded:: 2019.2.0 :param username: username to connect with, overriding defaults .. versionadded:: 2019.2.0 :param password: password to connect with, overriding defaults .. versionadded:: 2019.2.0 .. code-block:: yaml domain_name: virt.snapshot: - suffix: periodic domain*: virt.snapshot: - suffix: periodic �snapshot�savedzSnapshot has been taken)�suffixr. r/ r0 rI )r rz r. r/ r0 r r r rx * s �rx c C s t | ddd|||d�S )a} Reboots VMs .. versionadded:: 2016.3.0 :param name: :param connection: libvirt connection URI, overriding defaults .. versionadded:: 2019.2.0 :param username: username to connect with, overriding defaults .. versionadded:: 2019.2.0 :param password: password to connect with, overriding defaults .. versionadded:: 2019.2.0 Zreboot�rebootedzMachine has been rebootedr- rI rJ r r r r{ R s �r{ c C s t | ddd�S )z� .. deprecated:: 2016.3.0 Use :py:func:`~salt.modules.virt.powered_off` instead. Stops a VM by power off. .. versionadded:: 2016.3.0 .. code-block:: yaml domain_name: virt.stopped rK rL rM rI )r r r r rL p s rL c C s t | ddd|d�S )ao .. deprecated:: 2016.3.0 Use :py:func:`~salt.modules.virt.snapshot` instead. Takes a snapshot of a particular VM or by a UNIX-style wildcard. .. versionadded:: 2016.3.0 .. code-block:: yaml domain_name: virt.saved: - suffix: periodic domain*: virt.saved: - suffix: periodic rx ry zSnapshots has been taken)rz rI )r rz r r r ry � s �ry c C s� | i ddd�}z�t �td � | �}|s d| � d�|d< W |S t� }t|�dkr.d t� i|d < |D ]R}i }ztd |||d �}||d |d d�}W n" tyk } zt|�dkra|�|t|�d�� W Y d}~nd}~ww t|�dkr~|r}|d d �|� q0||d < t|�t|�k|d< |d r�d�t|�dkr�dp�d�|d< |r�||d d< |d d s�|d � d � W |S W |S t j y� } z t|�|d< W Y d}~|S d}~w ty� } z t|�|d< W Y d}~|S d}~ww )aD .. deprecated:: 2016.3.0 Reverts to the particular snapshot. .. versionadded:: 2016.3.0 .. code-block:: yaml domain_name: virt.reverted: - cleanup: True domain_name_1: virt.reverted: - snapshot: snapshot_name - cleanup: False Fr r r+ z No domains found for criteria "�"r � �revertedr zvirt.revert_snapshot)rx �cleanup�deleted)r1 �currentr� r2 Nr zDomain{} has been reverted�sr3 ) r4 r5 r r6 �lenr r: r< rv �popr r; ) r rx r r& ZdomainsrA r1 r rD r r r r~ � sf (� � � �� �� ������r~ c C sb | i t d sdnddd�}�ztd | || | d�}|r�|| r�|| d r(| p0|| d o0|}td | ||f||||| | | ||||d|| | d ��}|r�t d sktd | ||f||||| | | ||||d || | d �� |rod nd}d |� �|d | < d| � d|� �|d< nld| � d�|d< d|d< n_|}t d s�td | ||fi d|�d|�d|�d|�d| �d| �d| �d |�d |�d |�d |�dd �d d �d!|�d"| �d#| �� |r�d$|d | < d| � d%�|d< nd&|d | < d| � d'�|d< |�r t d �std( | |�rd)nd*|| | d+� W |S W |S W |S tj�y0 } zd |d< |�� |d< W Y d}~|S d}~ww ),a Defines a new network with specified arguments. :param name: Network name :param bridge: Bridge name :param forward: Forward mode(bridge, router, nat) .. versionchanged:: 3003 a ``None`` value creates an isolated network with no forwarding at all :param vport: Virtualport type (Default: ``'None'``) The value can also be a dictionary with ``type`` and ``parameters`` keys. The ``parameters`` value is a dictionary of virtual port parameters. .. code-block:: yaml - vport: type: openvswitch parameters: interfaceid: 09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f .. versionchanged:: 3003 possible dictionary value :param tag: Vlan tag (Default: ``'None'``) The value can also be a dictionary with the ``tags`` and optional ``trunk`` keys. ``trunk`` is a boolean value indicating whether to use VLAN trunking. ``tags`` is a list of dictionaries with keys ``id`` and ``nativeMode``. The ``nativeMode`` value can be one of ``tagged`` or ``untagged``. .. code-block:: yaml - tag: trunk: True tags: - id: 42 nativeMode: untagged - id: 47 .. versionchanged:: 3003 possible dictionary value :param ipv4_config: IPv4 network configuration. See the :py:func:`virt.network_define <salt.modules.virt.network_define>` function corresponding parameter documentation for more details on this dictionary. (Default: None). :param ipv6_config: IPv6 network configuration. See the :py:func:`virt.network_define <salt.modules.virt.network_define>` function corresponding parameter documentation for more details on this dictionary. (Default: None). :param autostart: Network autostart (default ``'True'``) :param connection: libvirt connection URI, overriding defaults :param username: username to connect with, overriding defaults :param password: password to connect with, overriding defaults :param mtu: size of the Maximum Transmission Unit (MTU) of the network. (default ``None``) .. versionadded:: 3003 :param domain: DNS domain name of the DHCP server. The value is a dictionary with a mandatory ``name`` property and an optional ``localOnly`` boolean one. (default ``None``) .. code-block:: yaml - domain: name: lab.acme.org localOnly: True .. versionadded:: 3003 :param nat: addresses and ports to route in NAT forward mode. The value is a dictionary with optional keys ``address`` and ``port``. Both values are a dictionary with ``start`` and ``end`` values. (default ``None``) .. code-block:: yaml - forward: nat - nat: address: start: 1.2.3.4 end: 1.2.3.10 port: start: 500 end: 1000 .. versionadded:: 3003 :param interfaces: whitespace separated list of network interfaces devices that can be used for this network. (default ``None``) .. code-block:: yaml - forward: passthrough - interfaces: "eth10 eth11 eth12" .. versionadded:: 3003 :param addresses: whitespace separated list of addresses of PCI devices that can be used for this network in `hostdev` forward mode. (default ``None``) .. code-block:: yaml - forward: hostdev - interfaces: "0000:04:00.1 0000:e3:01.2" .. versionadded:: 3003 :param physical_function: device name of the physical interface to use in ``hostdev`` forward mode. (default ``None``) .. code-block:: yaml - forward: hostdev - physical_function: "eth0" .. versionadded:: 3003 :param dns: virtual network DNS configuration The value is a dictionary described in :ref:`net-define-dns`. (default ``None``) .. code-block:: yaml - dns: forwarders: - domain: example.com addr: 192.168.1.1 - addr: 8.8.8.8 - domain: www.example.com txt: example.com: "v=spf1 a -all" _http.tcp.example.com: "name=value,paper=A4" hosts: 192.168.1.2: - mirror.acme.lab - test.acme.lab srvs: - name: ldap protocol: tcp domain: ldapserver.example.com target: . port: 389 priority: 1 weight: 10 .. versionadded:: 3003 .. versionadded:: 3001 .. code-block:: yaml network_name: virt.network_defined .. code-block:: yaml network_name: virt.network_defined: - bridge: main - forward: bridge - vport: openvswitch - tag: 180 - autostart: True .. code-block:: yaml network_name: virt.network_defined: - bridge: natted - forward: nat - ipv4_config: cidr: 192.168.42.0/24 dhcp_ranges: - start: 192.168.42.10 end: 192.168.42.25 - start: 192.168.42.100 end: 192.168.42.150 - autostart: True r TNr r �virt.network_infor- r` zvirt.network_update)�vport�tag� ipv4_config� ipv6_config�mtur1 �natrT � addresses�physical_function�dnsr r. r/ r0 F�, autostart flag changedzNetwork updatedr zNetwork re r rc r zvirt.network_definer� r� r� r� r� r1 r� rT r� r� r� rm r. r/ r0 z%Network defined, marked for autostart� defined, marked for autostart�Network definedrn zvirt.network_set_autostart�on�offrH )r# r r r; �get_error_message)r �bridge�forwardr� r� r� r� r` r. r/ r0 r� r1 r� rT r� r� r� r& �info�needs_autostart� needs_update�actionrD r r r �network_defined� s O�� ������ ������ � � � � ������� � � � ���r� c C sZ t | ||f||||| | | ||||||| | d��}| |d v o&|d | �d�}td s-dnd}|d du s9|d r�zStd | || | d �}|�| i ��d d �rXd �|d �|d < n.td sftd | || | d � d}| |d v rwd�|d | �}||d | < d�|d �|d < ||d< W |S tjy� } zd |d< |�� |d < W Y d}~|S d}~ww |S )a� Defines and starts a new network with specified arguments. :param name: Network name :param bridge: Bridge name :param forward: Forward mode(bridge, router, nat) .. versionchanged:: 3003 a ``None`` value creates an isolated network with no forwarding at all :param vport: Virtualport type (Default: ``'None'``) The value can also be a dictionary with ``type`` and ``parameters`` keys. The ``parameters`` value is a dictionary of virtual port parameters. .. code-block:: yaml - vport: type: openvswitch parameters: interfaceid: 09b11c53-8b5c-4eeb-8f00-d84eaa0aaa4f .. versionchanged:: 3003 possible dictionary value :param tag: Vlan tag (Default: ``'None'``) The value can also be a dictionary with the ``tags`` and optional ``trunk`` keys. ``trunk`` is a boolean value indicating whether to use VLAN trunking. ``tags`` is a list of dictionaries with keys ``id`` and ``nativeMode``. The ``nativeMode`` value can be one of ``tagged`` or ``untagged``. .. code-block:: yaml - tag: trunk: True tags: - id: 42 nativeMode: untagged - id: 47 .. versionchanged:: 3003 possible dictionary value :param ipv4_config: IPv4 network configuration. See the :py:func`virt.network_define <salt.modules.virt.network_define>` function corresponding parameter documentation for more details on this dictionary. (Default: None). .. versionadded:: 3000 :param ipv6_config: IPv6 network configuration. See the :py:func`virt.network_define <salt.modules.virt.network_define>` function corresponding parameter documentation for more details on this dictionary. (Default: None). .. versionadded:: 3000 :param autostart: Network autostart (default ``'True'``) :param connection: libvirt connection URI, overriding defaults .. versionadded:: 2019.2.0 :param username: username to connect with, overriding defaults .. versionadded:: 2019.2.0 :param password: password to connect with, overriding defaults .. versionadded:: 2019.2.0 :param mtu: size of the Maximum Transmission Unit (MTU) of the network. (default ``None``) .. versionadded:: 3003 :param domain: DNS domain name of the DHCP server. The value is a dictionary with a mandatory ``name`` property and an optional ``localOnly`` boolean one. (default ``None``) .. code-block:: yaml - domain: name: lab.acme.org localOnly: True .. versionadded:: 3003 :param nat: addresses and ports to route in NAT forward mode. The value is a dictionary with optional keys ``address`` and ``port``. Both values are a dictionary with ``start`` and ``end`` values. (default ``None``) .. code-block:: yaml - forward: nat - nat: address: start: 1.2.3.4 end: 1.2.3.10 port: start: 500 end: 1000 .. versionadded:: 3003 :param interfaces: whitespace separated list of network interfaces devices that can be used for this network. (default ``None``) .. code-block:: yaml - forward: passthrough - interfaces: "eth10 eth11 eth12" .. versionadded:: 3003 :param addresses: whitespace separated list of addresses of PCI devices that can be used for this network in `hostdev` forward mode. (default ``None``) .. code-block:: yaml - forward: hostdev - interfaces: "0000:04:00.1 0000:e3:01.2" .. versionadded:: 3003 :param physical_function: device name of the physical interface to use in ``hostdev`` forward mode. (default ``None``) .. code-block:: yaml - forward: hostdev - physical_function: "eth0" .. versionadded:: 3003 :param dns: virtual network DNS configuration The value is a dictionary described in :ref:`net-define-dns`. (default ``None``) .. code-block:: yaml - dns: forwarders: - domain: example.com addr: 192.168.1.1 - addr: 8.8.8.8 - domain: www.example.com txt: host.widgets.com.: "printer=lpr5" example.com.: "This domain name is reserved for use in documentation" hosts: 192.168.1.2: - mirror.acme.lab - test.acme.lab srvs: - name: ldap protocol: tcp domain: ldapserver.example.com target: . port: 389 priority: 1 weight: 10 .. versionadded:: 3003 .. code-block:: yaml network_name: virt.network_running .. code-block:: yaml network_name: virt.network_running: - bridge: main - forward: bridge - vport: openvswitch - tag: 180 - autostart: True .. code-block:: yaml network_name: virt.network_running: - bridge: natted - forward: nat - ipv4_config: cidr: 192.168.42.0/24 dhcp_ranges: - start: 192.168.42.10 end: 192.168.42.25 - start: 192.168.42.100 end: 192.168.42.150 - autostart: True )r� r� r� r� r� r1 r� rT r� r� r� r` r. r/ r0 r r� r TNr r� r- ZactiveFz{} and is runningr zvirt.network_startzNetwork startedrs ) r� � startswithr# r r7 rv r r; r� )r r� r� r� r� r� r� r` r. r/ r0 r� r1 r� rT r� r� r� r& rq r r� �changerD r r r �network_running sl U����� ���r� > �fs�logical�zfs�netfs�dirrh �vstoragec C s. | i t d sdnddd�} �z�td | ||| d�} d} | �r| | d r'| p/| | d o/|} td | f||||p;i �d �|pAi �d �|pGi �d �|pMi �d�|pSi �d�|pYi �d�|p_i �d�|pei �d�d||| d��} | �r t d s�td | ||||p�i �d �|p�i �d �|p�i �d �|p�i �d�|p�i �d�|p�i �d�|p�i �d�|p�i �d�||| d� d}| | d dkr�|tv r�t d s�z td | ||| d� W n tjy� } zt�d|�� � W Y d}~nd}~ww d}| r�|� d�n|}d|� �| d | < d | � d |� �| d < n�d | � d �| d < d| d!< n�|} t d �s�td" | fi d#|�d$|�d%|�d&|�p5i �d ��d'|�p>i �d ��d(|�pGi �d ��d)|�pPi �d��d*|�pYi �d��d+|�pbi �d��d,|�pki �d��d-|�pti �d��d.|�d/d�d0|�d1|�d2| �� |tv �r�z td | ||| d� W n tj�y� } zt�d|�� � W Y d}~nd}~ww | �r�d3| d | < d | � d4�| d < nd5| d | < d | � d6�| d < | �r�t d �s�td7 | |�r�d8nd9||| d:� W | S W | S W | S tj�y } z|�� | d < d| d!< W Y d}~| S d}~ww );a� Defines a new pool with specified arguments. .. versionadded:: 3001 :param ptype: libvirt pool type :param target: full path to the target device or folder. (Default: ``None``) :param permissions: target permissions. See :ref:`pool-define-permissions` for more details on this structure. :param source: dictionary containing keys matching the ``source_*`` parameters in function :func:`salt.modules.virt.pool_define`. :param transient: when set to ``True``, the pool will be automatically undefined after being stopped. (Default: ``False``) :param autostart: Whether to start the pool when booting the host. (Default: ``True``) :param start: When ``True``, define and start the pool, otherwise the pool will be left stopped. :param connection: libvirt connection URI, overriding defaults :param username: username to connect with, overriding defaults :param password: password to connect with, overriding defaults .. code-block:: yaml pool_name: virt.pool_defined: - ptype: netfs - target: /mnt/cifs - permissions: - mode: 0770 - owner: 1000 - group: 100 - source: dir: samba_share hosts: - one.example.com - two.example.com format: cifs - autostart: True r TNr r �virt.pool_infor- Fr` zvirt.pool_updateZdevicesr� Z initiatorZadapter�hostsZauthr rv )�ptype�target� permissions�source_devices� source_dir�source_initiator�source_adapter� source_hosts� source_auth� source_name� source_formatr r. r/ r0 )r� r� r� r� r� r� r� r� r� r� r� r. r/ r0 r@ rr �virt.pool_buildz(Failed to build libvirt storage pool: %sz, builtr� � Pool updatedr �Pool re r rc r zvirt.pool_definer� r� r� r� r� r� r� r� r� r� r� � transientrm r. r/ r0 z"Pool defined, marked for autostartr� � Pool definedrn zvirt.pool_set_autostartr� r� rH ) r# r r7 �BUILDABLE_POOL_TYPESr r; �log�warningr� )r r� r� r� �sourcer� r` r. r/ r0 r& r� r� r� r� rD r r r � pool_defined/ s: 6�� ��� � � ����� �������� � � � � ����� ���� � � � � ��r� c C s� t | ||||||||| d� } | | d v o | d | �d�} | | d v o+| d | �d�} td s2dnd} | d du s>| d r�z�td | ||| d �}d }|�| i ��d d �dk}|r�| r�d}td sktd | ||| d � |tddh v r�td s�td | ||| d � d|� �}nd}d} |r�| s�| r�td s�td | ||| d � d| � �}d}| | d v r�d�| d �}d�| d | �}|dkr�|� d|� �| d | < |� d|� �| d< | | d< W | S tjy� } z|� � | d< d | d< W Y d}~| S d}~ww | S ) a� Defines and starts a new pool with specified arguments. .. versionadded:: 2019.2.0 :param ptype: libvirt pool type :param target: full path to the target device or folder. (Default: ``None``) :param permissions: target permissions. See :ref:`pool-define-permissions` for more details on this structure. :param source: dictionary containing keys matching the ``source_*`` parameters in function :func:`salt.modules.virt.pool_define`. :param transient: when set to ``True``, the pool will be automatically undefined after being stopped. (Default: ``False``) :param autostart: Whether to start the pool when booting the host. (Default: ``True``) :param connection: libvirt connection URI, overriding defaults :param username: username to connect with, overriding defaults :param password: password to connect with, overriding defaults .. code-block:: yaml pool_name: virt.pool_running .. code-block:: yaml pool_name: virt.pool_running: - ptype: netfs - target: /mnt/cifs - permissions: - mode: 0770 - owner: 1000 - group: 100 - source: dir: samba_share hosts: - one.example.com - two.example.com format: cifs - autostart: True ) r� r� r� r� r� r` r. r/ r0 r r� r� r TNr r� r- rt r@ rG rr Z restarted�virt.pool_stoprh r� r� zbuilt, zalready runningzvirt.pool_startr� ZPoolz{},r � F) r� r� r# r r7 r� rv r r; r� )r r� r� r� r� r� r` r. r/ r0 r& rq �updatedr r� r� Z is_runningr r� rD r r r � pool_running� s� 8� ��� � � � ��r� c C sN | i ddd�}z�t d | |||d�}|r�d|d d< d|d d < d|d d < g |d d < g }|| d d kr�|r�g d�}|| d |vr|t d | |||d� t d | |||d�} | D ] } td } td sot d | | |||d�} | rz|d d �| � qZn|�d� td s�t d | |||d�|d d< nd|d d< |r�g d�} || d | v r�td s�t d | |||d�|d d < n d|d d < n|�d� td s�t d | |||d�|d d < n d|d d < d|d< |r�d �|| d d �|��|d < W |S W |S d | � �|d < W |S tj�y& } zd | �� � �|d < d|d< W Y d} ~ |S d} ~ ww )!a� Deletes a virtual storage pool. :param name: the name of the pool to delete. :param purge: if ``True``, the volumes contained in the pool will be deleted as well as the pool itself. Note that these will be lost for ever. If ``False`` the pool will simply be undefined. (Default: ``False``) :param connection: libvirt connection URI, overriding defaults :param username: username to connect with, overriding defaults :param password: password to connect with, overriding defaults In order to be purged a storage pool needs to be running to get the list of volumes to delete. Some libvirt storage drivers may not implement deleting, those actions are implemented on a best effort idea. In any case check the result's comment property to see if any of the action was unsupported. .. code-block:: yaml pool_name: uyuni_virt.pool_deleted: - purge: True .. versionadded:: 3000 Tr r r� r- Fr rG r� Z undefinedZdeleted_volumesr@ rr )Ziscsiz iscsi-directZmpathZscsi�typezvirt.pool_refreshzvirt.pool_list_volumesr zvirt.volume_deletezdeleting volumer� )r� r� r� r� r� r� zvirt.pool_deletez deleting poolzvirt.pool_undefineNr z-Unsupported actions for pool of type "{}": {}z, r z!Storage pool could not be found: zFailed deleting pool: )r r# r: rv r r r; r� )r �purger. r/ r0 r& r� Z unsupportedZunsupported_volume_deleteZvolumesZvolumer� Zsupported_pool_deleterD r r r � pool_deleted� s� � ����� � � � � � ����r� c C s� |i ddd�} t d | | | d�} | | vr td| � d���t d | || | | d��| i ��|�}|rd | d < |�d �p:i }|�d �|pBi �d �koR|�d �|pNi �d �k}|r`|�d �|krj|durjd| d< d| d < | S t|�d��t|�d d kr}d| d < | S td r�dnd| d< d}z2td s�t d | ||||||||| | | d� d}d�||| �| d < | � d|� �ddd �i| d < W | S tjy� } z|�� | d < d| d< W Y d}~| S d}~ww ) aI Ensure a disk volume is existing. :param pool: name of the pool containing the volume :param name: name of the volume :param size: capacity of the volume to define in MiB :param allocation: allocated size of the volume in MiB. Defaults to 0. :param format: volume format. The allowed values are depending on the pool type. Check the virt.pool_capabilities output for the possible values and the default. :param type: type of the volume. One of file, block, dir, network, netdiri, ploop or None. By default, the type is guessed by libvirt from the pool type. :param permissions: Permissions to set on the target folder. This is mostly used for filesystem-based pool types. See :ref:`pool-define-permissions` for more details on this structure. :param backing_store: dictionary describing a backing file for the volume. It must contain a ``path`` property pointing to the base volume and a ``format`` property defining the format of the base volume. The base volume format will not be guessed for security reasons and is thus mandatory. :param nocow: disable COW for the volume. :param connection: libvirt connection URI, overriding defaults :param username: username to connect with, overriding defaults :param password: password to connect with, overriding defaults .. rubric:: CLI Example: Volume on ESX: .. code-block:: yaml esx_volume: virt.volume_defined: - pool: "[local-storage]" - name: myvm/myvm.vmdk - size: 8192 QCow2 volume with backing file: .. code-block:: bash myvolume: virt.volume_defined: - pool: default - name: myvm.qcow2 - format: qcow2 - size: 8192 - permissions: mode: '0775' owner: '123' group: '345' - backing_store: path: /path/to/base.img format: raw - nocow: True .. versionadded:: 3001 Tr r zvirt.list_poolsr- z Storage pool z not existingzvirt.volume_infoszvolume is existingr � backing_storer rv NFr zMA volume with the same name but different backing store or format is existingZcapacityi z@The capacity of the volume is different, but no resize performedr z would be zvirt.volume_define) � allocationrv r� r� r� �nocowr. r/ r0 z Volume {} {}defined in pool {}�/rq )�oldr r ) r r r7 �intr# rv r r; r� )�poolr �sizer� rv r� r� r� r� r. r/ r0 r& ZpoolsZ vol_infosZbacking_store_infoZsame_backing_storeZ test_commentrD r r r �volume_defined s~ J� ������ ��� � ��r� )r )NNNN)NNN) NNNNNNNNTTNNNNNNNNNNNNNNFTNF)NNNNNNNNTTNNNNNNNNNNNNNNFNF)N)NF)NNNNTNNNNNNNNNN) NNNNFTNNN)FNNN) r NNNNFNNN)&�__doc__r4 �loggingr Zsalt.utils.argsr Zsalt.utils.filesZsalt.utils.stringutilsZsalt.utils.versionsZsalt.exceptionsr r r Z HAS_LIBVIRT� ImportErrorr � getLogger�__name__r� r r* rE rG rN rq rr rx r{ rL ry r~ r� r� r� r� r� r� r� r r r r �<module> sJ � ^ � ? "# � O � W ( �I � D � � O � �
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings