Current File : //lib/python2.7/site-packages/salt/modules/vboxmanage.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d 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 e j e � Z e j d j d � � Z e j d j d � � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z e d � Z! d � Z" d d e$ d d d � Z% d d d d d d d d d e d d � Z& d d d d d d e d � Z' e d d � Z( d S( uX
Support for VirtualBox using the VBoxManage command
.. versionadded:: 2016.3.0
If the ``vboxdrv`` kernel module is not loaded, this module can automatically
load it by configuring ``autoload_vboxdrv`` in ``/etc/salt/minion``:
.. code-block: yaml
autoload_vboxdrv: True
The default for this setting is ``False``.
:depends: virtualbox
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionError( t sixu [^{0}]u a-zA-Z0-9._-c C@ sS t � rI t j d t � t k rE t d d � sE t d d � qE n t St d f S( u9
Only load the module if VBoxManage is installed
u autoload_vboxdrvu kmod.is_loadedu vboxdrvu kmod.loaduM The vboxmanaged execution module failed to load: VBoxManage is not installed.( t vboxcmdt __opts__t gett Falset Truet __salt__( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt __virtual__' s c C@ s t j j j d � S( u�
Return the location of the VBoxManage command
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.vboxcmd
u
VBoxManage( t saltt utilst patht which( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyR 3 s
c C@ s t d t d � S( u{
List the available OS Types
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.list_ostypes
u ostypesu ID( t
list_itemsR ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt list_ostypes@ s
c C@ s� i } d j t � � } xa t j j j | � j � D]D } | j � sL q4 n | j � } | d j d d � } t
| | <q4 W| S( u�
Return a list of registered VMs, with minimal information
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.list_nodes_min
u {0} list vmsi u "u ( t formatR R t modulest cmdmodt runt
splitlinest stript splitt replaceR ( t rett cmdt linet compst name( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt list_nodes_minM s
" c C@ s t d t d � S( u�
Return a list of registered VMs, with detailed information
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.list_nodes_full
u vmsu Name( R R ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt list_nodes_fullb s
c C@ s� i } t � } x� | D]| } i | | d d 6| | d d 6| | d d 6d d 6g d 6g d 6| | <d
j | | d | | d � | | d
<q W| S( u}
Return a list of registered VMs
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.list_nodes
u UUIDu idu Guest OSu imageu Nameu nameu stateu private_ipsu
public_ipsu {0} RAM, {1} CPUu Memory sizeu Number of CPUsu sizeN( R t NoneR ( R t nodest node( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt
list_nodeso s
c C@ s: i } d j t � | � } t j j j | � j � } | S( ui
Start a VM
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.start my_vm
u {0} startvm {1}( R R R R R R R ( R R R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt start� s
c C@ s4 d j t � | � } t j j j | � j � } | S( ug
Stop a VM
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.stop my_vm
u {0} controlvm {1} poweroff( R R R R R R R ( R R R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt stop� s
c C@ sp t j j | � s* t d j | � � � n d j t � | � } t j j j | � } | d d k rh t
S| d S( ux
Register a VM
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.register my_vm_filename
u, The specified filename ({0}) does not exist.u {0} registervm {1}u retcodei u stderr( t osR t isfileR R R R R R t run_allR ( t filenameR R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt register� s
c C@ s� t � } | | k r- t d j | � � � n d j t � | � } | t k r[ | d 7} n t j j j | � } | d d k r� t S| d S( u|
Unregister a VM
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.unregister my_vm_filename
u) The specified VM ({0}) is not registered.u {0} unregistervm {1}u --deleteu retcodei u stderr( R R R R R R R R R) ( R t deleteR" R R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt
unregister� s
c C@ s
t | t � S( u|
Unregister and destroy a VM
CLI Example:
.. code-block:: bash
salt '*' vboxmanage.destroy my_vm
( R- R ( R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt destroy� s
c K@ s� t � } | | k r- t d j | � � � n d } | rm t j | � rW t d � � n | d j | � 7} n | r� t | t j � r� | g } n t | t � r� | d j d j | � � 7} q� t d � � n t
� } | | k r� t d j | � � � n | d | 7} | t k r"| d
7} n | rht j
j | � sRt d j | � � � n | d j | � 7} n | r�t j | � r�t d
� � n | d j | � 7} n d j t � | � }
t j j j |
� } | d d k r�t S| d S( uy
Create a new VM
CLI Example:
.. code-block:: bash
salt 'hypervisor' vboxmanage.create <name>
u- The specified VM ({0}) is already registered.u u' New VM name contains invalid charactersu --name {0}u
--groups {0}u ,u3 groups must be either a string or a list of stringsu- The specified OS type ({0}) is not available.u
--ostype u --registeru basefolder {0} was not foundu --basefolder {0}u$ New UUID contains invalid charactersu --uuid {0}u {0} create {1}u retcodei u stderr( R R R t NAME_REt searcht
isinstanceR t string_typest listt joinR R R' R t existsR R R R R) ( R t groupst ostypeR+ t
basefoldert new_uuidt kwargsR" t paramst ostypesR R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt create� sH
u machinec
K@ s] | r | s | r) | r) t d � � n d } t � }
t d t d � j � } | r� | |
k rz t d j | � � � n | d | 7} n; | r� | | k r� t d j | � � � n | d | 7} n | r� | r� t d � � n | rt j | � rt d � � n | d j | � 7} n: | rUt j | � r?t d � � n | d j | � 7} n d$ } | r�| | k r�t d
j d j | � � � � n | d | 7} d% } | r�| | k r�t d j d j | � � � � n | d | 7} | r t j | � rt d � � n | d j | � 7} n |
r~t
|
t j � rA|
g }
n t
|
t
� ro| d j d j |
� � 7} q~t d � � n | r�t j j | � s�t d j | � � � n | d j | � 7} n | r�t j | � r�t d � � n | d j | � 7} n | t k r| d 7} n d j t � | � } t j j j | � } | d! d" k rUt S| d# S(& u�
Clone a new VM from an existing VM
CLI Example:
.. code-block:: bash
salt 'hypervisor' vboxmanage.clonevm <name> <new_name>
u8 Either a name or a uuid must be specified, but not both.u u vmsu UUIDu) The specified VM ({0}) is not registered.u uH Either a snapshot_name or a snapshot_uuid may be specified, but not bothu) Snapshot name contains invalid charactersu --snapshot {0}u machineu machineandchildrenu allu, Mode must be one of: {0} (default "machine")u , u --mode u linku keepallmacsu keepnatmacsu
keepdisknamesu) If specified, options must be one of: {0}u --options u$ New name contains invalid charactersu --name {0}u
--groups {0}u ,u3 groups must be either a string or a list of stringsu basefolder {0} was not foundu --basefolder {0}u$ New UUID contains invalid charactersu --uuid {0}u --registeru {0} clonevm {1}u retcodei u stderr( u machineu machineandchildrenu all( u linku keepallmacsu keepnatmacsu
keepdisknames( R R R R t keysR R/ R0 t UUID_RER4 R1 R R2 R3 R' R R5 R R R R R) ( R t uuidt new_namet
snapshot_uuidt
snapshot_namet modet optionsR8 R9 R+ R6 R: R; t nodes_namest nodes_uuidst valid_modest
valid_optionsR R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt clonevm) s~
c K@ s� d } d# }
| |
k r% | | 7} n t d j d j |
� � � � | rO | s] | rl | rl t d � � n | r� | d k r� d } n* | d k r� d } n | d k r� d
} n t | � } | | k r� t d j | � � � n | d | 7} nA | r3t j j | � s"t d
j | � � � n | d | 7} n | r?| sM| r\| r\t d � � n | rs| d | 7} nm | r�y; t j j j
| d � j � t j | � | d | 7} Wq�t
k
r�t d j | � � � q�Xn | r*d$ }
| |
k rt d j d j |
� � � � q*| d | 7} n d% } | r�| | k r�t j j | � sut d j d j | � � � � q�| d | 7} n | r�| d 7} n d j t � | � } t j j j | � } | d d! k r�t S| d" S(& u�
Clone a new VM from an existing VM
CLI Example:
.. code-block:: bash
salt 'hypervisor' vboxmanage.clonemedium <name> <new_name>
u u disku dvdu floppyu Medium must be one of: {0}.u , u5 Either uuid_in or file_in must be used, but not both.u hddsu dvdsu floppiesu UUID {0} was not foundu u File {0} was not foundu7 Either uuid_out or file_out must be used, but not both.u wu {0} is not a valid filenameu VDIu VMDKu VHDu RAWu) If specified, mformat must be one of: {0}u
--format u Standardu Fixedu Split2Gu Streamu ESXu) If specified, variant must be one of: {0}u --variant u --existingu {0} clonemedium {1}u retcodei u stderr( u disku dvdu floppy( u VDIu VMDKu VHDu RAW( u Standardu Fixedu Split2Gu Streamu ESX( R R R4 R R' R R5 R R
t filest fopent closet unlinkt OSErrorR R R R) R ( t mediumt uuid_int file_int uuid_outt file_outt mformatt variantt existingR: R; t
valid_mediumst itemt itemst
valid_mformatt
valid_variantR R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt clonemedium� sn
u UUIDc C@ s: d } | | k r3 t d j d j | � � � � n d } | t k rN d } n i } d! } i } d j t � | | � } x� t j j j | � j
� D]� } | j � s� q� n | j d � }
t
|
� d k r� q� n | d! k r� | | | <n d j |
d � j � } |
d | k r$| } i } n | | |
d <q� W| S(" u�
Return a list of a specific type of item. The following items are available:
vms
runningvms
ostypes
hostdvds
hostfloppies
intnets
bridgedifs
hostonlyifs
natnets
dhcpservers
hostinfo
hostcpuids
hddbackends
hdds
dvds
floppies
usbhost
usbfilters
systemproperties
extpacks
groups
webcams
screenshotformats
CLI Example:
.. code-block:: bash
salt 'hypervisor' vboxmanage.items <item>
salt 'hypervisor' vboxmanage.items <item> details=True
salt 'hypervisor' vboxmanage.items <item> details=True group_by=Name
Some items do not display well, or at all, unless ``details`` is set to
``True``. By default, items are grouped by the ``UUID`` field, but not all
items contain that field. In those cases, another field must be specified.
u vmsu
runningvmsu ostypesu hostdvdsu hostfloppiesu intnetsu
bridgedifsu hostonlyifsu natnetsu dhcpserversu hostinfou
hostcpuidsu hddbackendsu hddsu dvdsu floppiesu usbhostu
usbfiltersu systempropertiesu extpacksu groupsu webcamsu screenshotformatsu Item must be one of: {0}.u , u u -lu {0} list{1} {2}u :i i ( u vmsu
runningvmsu ostypesu hostdvdsu hostfloppiesu intnetsu
bridgedifsu hostonlyifsu natnetsu dhcpserversu hostinfou
hostcpuidsu hddbackendsu hddsu dvdsu floppiesu usbhostu
usbfiltersu systempropertiesu extpacksu groupsu webcamsu screenshotformatsN( R R R4 R R! R R R R R R R R t len( RY t detailst group_byt typest flagR t tmp_idt tmp_dictR R R t line_val( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyR � s: ) "
() t __doc__t
__future__R R R t ret os.pathR' t loggingt salt.utils.filesR t salt.utils.patht salt.exceptionsR t salt.extR t getLoggert __name__t LOGt compileR R? R/ R R R R R R$ R% R& R+ R R- R. R! R R= RJ R] R ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/vboxmanage.pyt <module> s\
> b V
Mini Shell