Current File : //lib/python2.7/site-packages/salt/states/virt.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z y d d l Z e Z Wn e
k
ri e Z n Xd d l Z
d d l Z
d d l Z
d d l Z
d d l m Z d d l m Z d Z d � Z d d � Z d d d d
� Z d d d d � Z d d d d � Z d d d d d d d d d e e d d e d d d d d d
� Z d d d d d � Z d d d d � Z d � Z d d � Z d e d � Z! d d e d d d d � Z" d d d d e e d d d d � Z# d S( u�
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
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionError( t sixu virtc C@ s d t k r t St S( u9
Only if virt module is available.
:return:
u virt.node_info( t __salt__t __virtualname__t False( ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt __virtual__' s u /etc/pkic
K@ s� i | d 6i d 6t d 6d d 6} i } x0 t j | � D] \ } } | | d j | � <q8 Wt d i d d 6| � } i t j j | d d
d � d 6t j j | d d
� d 6t j j | d d
d � d 6t j j | d d � d 6t j j | d d � d 6} x� | D]� } d j | � } | | k r,qn t j j t j j | | � � snt j
t j j | | � � n t j j | | � r�t j
j j | | d � �= }
t j
j j |
j � � | | k r�d | d | <n Wd QXqd | d | <qW| d s d | d <n� t d r6d | d <d | d <i | d <nm x` | d D]T } t j
j j | | d � �0 }
|
j t j
j j | d j | � � � Wd QXqAWd | d <| S( u�
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
u nameu changesu resultu u commentu ext_pillar_virt.{0}u
pillar.extu _u libvirtu privateu
serverkey.pemu serverkeyu servercert.pemu
servercertu
clientkey.pemu clientkeyu clientcert.pemu
clientcertu CAu
cacert.pemu cacertu libvirt.{0}.pemu ru updateNu newu All keys are correctu testu" Libvirt keys are set to be updatedu w+u Updated libvirt certs and keys( t TrueR t iteritemst formatR t ost patht joint existst dirnamet makedirst isfilet saltt utilst filest fopent stringutilst
to_unicodet readt __opts__t Nonet writet to_str( t namet basepatht kwargst rett
pillar_kwargst keyt valuet pillart pathst p_keyt fp_( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt keys3 sN *"
" %
!
c
K@ sZ i | d 6i d 6t d 6d d 6} t j t d � | � } t � }
t � } x� | D]� } yi t d j | � | d | d | d
| | �}
t |
t � r� |
d }
n |
j i | d 6|
| 6� WqT t j
k
r� } | j i | d 6t j | � d 6� qT XqT W|
s;t
| d <d
| d <| rVi | d 6| d <qVn i |
| 6| d <| | d <| S( u�
Helper to call the virt functions. Wildcards supported.
:param domain:
:param function:
:param section:
:param comment:
:return:
u nameu changesu resultu u commentu virt.list_domainsu virt.{0}t
connectiont usernamet passwordu domainu issueu No changes had happenedu ignored( R t fnmatcht filterR t listR t
isinstancet dictt appendt libvirtt libvirtErrorR t text_typeR ( t domaint functiont sectiont commentR* R+ R, R R! t targeted_domainst changed_domainst ignored_domainst targeted_domaint responset err( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt
_virt_call� s0 "
,
c C@ s% t | d d d d | d | d | �S( u�
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
u shutdownu stoppedu Machine has been shut downR* R+ R, ( R@ ( R R* R+ R, ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt stopped� s c C@ s% t | d d d d | d | d | �S( u�
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
u stopu unpoweredu Machine has been powered offR* R+ R, ( R@ ( R R* R+ R, ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt powered_off� s c & C@ s� i | d 6i d 6t d 6d j | � d 6} y}y�t d | � t d | � d k rd } | r� t d | d
| d | d | d
| d | d | d | d t d | d | d | � } | d r� d } q� n t d | � d j | � | d | <d j | | � | d <n� | r�t d | d
| d | d | d
| d | d | d | d | d | d | �
} | | d | <| j d d- � r�d j | � | d <q�| d s�d j | � | d <q�d j | � | d <n d j | � | d <Wn� t k
r�| rt j j j
d d � n t d | d
| d | d! | d" | d# | d$ | d% | d
| d& | d | d | d' |
d( | d) | d* |
d | d | d | �d+ | d | <d, j | � | d <n XWn3 t j k
r�} t
j | � | d <t | d <n X| S(. u�
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 CPUs for the virtual machine to create
:param mem: amount of memory in MiB for the new virtual machine
:param image: disk image to use for the first disk of the new VM
.. deprecated:: 2019.2.0
: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 update: set to ``True`` to update a defined module. (Default: ``False``)
.. 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:: Neon
: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:: Neon
.. 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
- 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
u nameu changesu resultu {0} is runningu commentu
virt.vm_stateu runningu startedu virt.updatet cput memt disk_profilet diskst nic_profilet
interfacest graphicst liveR* R+ R, u
definitionu updated and startedu
virt.startu
Domain {0}u Domain {0} {1}u errorsu2 Domain {0} updated, but some live update(s) failedu Domain {0} exists and is runningu6 Domain {0} updated, restart to fully apply the changesu Sodiumu� 'image' parameter has been deprecated. Rather use the 'disks' parameter to override or define the image. 'image' will be removed in {version}.u virt.initt os_typet archt imaget
hypervisort diskt nict seedt installt pub_keyt priv_keyu Domain defined and startedu Domain {0} defined and startedN( R R R R t getR R R R t versionst
warn_untilR3 R4 R R5 ( R RC RD RM t vm_typeRE RF RG RH RI RQ RR RS RT t updateR* R+ R, RK RL R! t
action_msgt statusR? ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt running� s� �
c
C@ s+ t | d d d d | d | d | d | �S( uR
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
u snapshotu savedu Snapshot has been takent suffixR* R+ R, ( R@ ( R R] R* R+ R, ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt snapshot� s c C@ s% t | d d d d | d | d | �S( u}
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
u rebootu rebootedu Machine has been rebootedR* R+ R, ( R@ ( R R* R+ R, ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt rebooted� s c C@ s t | d d d � S( u�
.. 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
u stopu unpoweredu Machine has been powered off( R@ ( R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt unpowered s c C@ s t | d d d d | �S( uo
.. 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
u snapshotu savedu Snapshots has been takenR] ( R@ ( R R] ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt saved s c C@ sV i | d 6i d 6t d 6d d 6} y�t j t d � | � } | sZ d j | � | d <n�t � } t | � d k r� i t � d 6| d <n x� | D]� } i } yC t d
| d | d | �} i | d
6| d d 6| d d 6} WnL t k
r0} t | � d k r1| j i | d
6t j
| � d 6� q1n Xt | � d k rd| ro| d d j | � qoq� | | d <Pq� Wt | � t | � k | d <| d r�d j t | � d k r�d p�d � | d <n | r�| | d d <n | d d s | d j d � n WnN t j
k
r,} t j
| � | d <n& t k
rQ} t j
| � | d <n X| S( uD
.. 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
u nameu changesu resultu u commentu virt.list_domainsu# No domains found for criteria "{0}"i u revertedu virt.revert_snapshotR^ t cleanupu domainu currentu deletedu issueu Domain{0} has been revertedu su ignored( R R- R. R R R/ t lenR R2 R R5 t popR3 R4 ( R R^ Rb R! t domainsR< R6 t resultR? ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt reverted7 sB "
'+
.c C@ sE i | d 6i d 6t d 6d d 6} y� t d | d | d | d | �}
|
r� |
d
rm d j | � | d <q
t d | d | d | d | �d
| d | <d j | � | d <n\ t d | | | | d | d | d t d | d | d | �d | d | <d j | � | d <Wn0 t j k
r@} t | d <| j � | d <n X| S( u�
Defines and starts a new network with specified arguments.
: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.network_define
.. code-block:: yaml
network_name:
virt.network_define:
- bridge: main
- forward: bridge
- vport: openvswitch
- tag: 180
- autostart: True
u nameu changesu resultu u commentu virt.network_infoR* R+ R, u activeu! Network {0} exists and is runningu virt.network_startu Network startedu Network {0} startedu virt.network_definet tagt autostartt startu Network defined and startedu Network {0} defined and started( R R R R3 R4 R t get_error_message( R t bridget forwardt vportRh Ri R* R+ R, R! t infoR? ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt network_runningr s8 &
"
c
' C@ sQ i | d 6i d 6t d 6d d 6}
y�t d | d | d | d | �} | r� | d
d k rs d j | � |
d <qt d
| d | d | d | �d |
d | <d j | � |
d <nbt d | d | d | d | d | p� i j d d* � d | p� i j d d* � d | pi j d d* � d | p'i j d d* � d | p?i j d d* � d | pWi j d d* � d | poi j d d* � d! | d" t d | d | d | �| r�t d# | d$ | r�d% n d& d | d | d | �n t d' | d | d | d | �d( |
d | <d) j | � |
d <Wn0 t j k
rL} | j � |
d <t |
d <n X|
S(+ u
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 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_define
.. code-block:: yaml
pool_name:
virt.pool_define:
- 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
u nameu changesu resultu u commentu virt.pool_infoR* R+ R, u stateu runningu Pool {0} exists and is runningu virt.pool_startu Pool startedu Pool {0} startedu virt.pool_definet ptypet targett permissionst source_devicesu devicest
source_diru dirt source_adapteru adaptert source_hostsu hostst source_authu autht source_namet
source_formatu formatt transientRj u virt.pool_set_autostartt stateu onu offu virt.pool_buildu Pool defined and startedu Pool {0} defined and startedN( R R R RU R R R3 R4 Rk (
R Rq Rr Rs t sourceR{ Ri R* R+ R, R! Ro R? ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt pool_running� sX 8
"
($ t __doc__t
__future__R R R R- R R3 R t HAS_LIBVIRTt ImportErrorR t salt.utils.argsR t salt.utils.filest salt.utils.stringutilst salt.utils.versionst salt.exceptionsR t salt.extR R R R) R R@ RA RB R\ R^ R_ R` Ra Rg Rp R~ ( ( ( s4 /usr/lib/python2.7/site-packages/salt/states/virt.pyt <module>
sv
b& � > B
Mini Shell