Current File : //lib/python2.7/site-packages/salt/states/esxvm.pyo
�
���^c @@ sH 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 j
j Z d d l m
Z
y d d l Z e Z Wn e k
r� e Z n Xy d d l m Z e Z Wn e k
r� e Z n Xe j e � Z d � Z d d d d e e e d � Z d � Z d d d e d � Z d d d d e d
� Z e d � Z d S( u�
Salt state to create, update VMware ESXi Virtual Machines.
Dependencies
============
- pyVmomi
- jsonschema
States
======
vm_configured
-------------
Enforces correct virtual machine configuration. Creates, updates and registers
a virtual machine.
This state identifies the action which should be taken for the virtual machine
and applies that action via the create, update, register state functions.
Supported proxies: esxvm
Example:
1. Get the virtual machine ``my_vm`` status with an ``esxvm`` proxy:
Proxy minion configuration for ``esxvm`` proxy:
.. code-block:: yaml
proxy:
proxytype: esxvm
datacenter: my_dc
vcenter: vcenter.fake.com
mechanism: sspi
domain: fake.com
principal: host
State configuration:
.. code-block:: yaml
myvm_state:
esxvm.vm_configured:
- vm_name: my_vm
- cpu: {{ {'count': 4, 'cores_per_socket': 2} }}
- memory: {{ {'size': 16384, 'unit': 'MB'} }}
- image: rhel7_64Guest
- version: vmx-12
- interfaces: {{ [{
'adapter': 'Network adapter 1',
'name': 'my_pg1',
'switch_type': 'distributed',
'adapter_type': 'vmxnet3',
'mac': '00:50:56:00:01:02,
'connectable': { 'start_connected': true,
'allow_guest_control': true,
'connected': true}},
{
'adapter': 'Network adapter 2',
'name': 'my_pg2',
'switch_type': 'distributed',
'adapter_type': 'vmxnet3',
'mac': '00:50:56:00:01:03',
'connectable': { 'start_connected': true,
'allow_guest_control': true,
'connected': true}}
] }}
- disks: {{ [{
'adapter': 'Hard disk 1',
'unit': 'MB',
'size': 51200,
'filename': 'my_vm/sda.vmdk',
'datastore': 'my_datastore',
'address': '0:0',
'thin_provision': true,
'eagerly_scrub': false,
'controller': 'SCSI controller 0'},
{
'adapter': 'Hard disk 2',
'unit': 'MB',
'size': 10240,
'filename': 'my_vm/sdb.vmdk',
'datastore': 'my_datastore',
'address': '0:1',
'thin_provision': true,
'eagerly_scrub': false,
'controller': 'SCSI controller 0'}
] }}
- scsi_devices: {{ [{
'adapter': 'SCSI controller 0',
'type': 'paravirtual',
'bus_sharing': 'no_sharing',
'bus_number': 0}
] }}
- serial_ports: {{ [{
'adapter': 'Serial port 1',
'type': 'network',
'yield': false,
'backing': {
'uri': 'my_uri',
'direction': 'server',
'filename': 'my_file'},
'connectable': {
'start_connected': true,
'allow_guest_control': true,
'connected': true}}
] }}
- datacenter: {{ 'my_dc' }}
- datastore: 'my_datastore'
- placement: {{ {'cluster': 'my_cluster'} }}
- cd_dvd_drives: {{ [] }}
- advanced_configs: {{ {'my_param': '1'} }}
- template: false
- tools: false
- power_on: false
- deploy: false
vm_updated
----------
Updates a virtual machine to a given configuration.
vm_created
----------
Creates a virtual machine with a given configuration.
vm_registered
-------------
Registers a virtual machine with it's configuration file path.
Dependencies
============
pyVmomi
-------
PyVmomi can be installed via pip:
.. code-block:: bash
pip install pyVmomi
.. note::
Version 6.0 of pyVmomi has some problems with SSL error handling on
certain versions of Python. If using version 6.0 of pyVmomi, Python 2.6,
Python 2.7.9, or newer must be present. This is due to an upstream
dependency in pyVmomi 6.0 that is not supported in Python versions
2.7 to 2.7.8. If the version of Python is not in the supported range,
you will need to install an earlier version of pyVmomi.
See `Issue #29537`_ for more information.
.. _Issue #29537: https://github.com/saltstack/salt/issues/29537
Based on the note above, to install an earlier version of pyVmomi than the
version currently listed in PyPi, run the following:
.. code-block:: bash
pip install pyVmomi==6.0.0.2016.4
The 5.5.0.2014.1.1 is a known stable version that this original ESXi State
Module was developed against. To be able to connect through SSPI you must
use pyvmomi 6.0.0.2016.4 or above. The ESXVM State Module was tested with
this version.
About
-----
This state module was written to be used in conjunction with Salt's
:mod:`ESXi Proxy Minion <salt.proxy.esxi>` For a tutorial on how to use Salt's
ESXi Proxy Minion, please refer to the
:ref:`ESXi Proxy Minion Tutorial <tutorial-esxi-proxy>` for
configuration examples, dependency installation instructions, how to run remote
execution functions against ESXi hosts via a Salt Proxy Minion, and a larger state
example.
i ( t absolute_importt print_functiont unicode_literalsN( t ESXVirtualMachineConfigSchema( t VmomiSupportc C@ s[ t s t d f St s t d f Sd t j k rW t j d k rW t j d k rW t d f St S(
Nu/ State module did not load: jsonschema not foundu, State module did not load: pyVmomi not foundu vim25/6.0i i i ua State module did not load: Incompatible versions of Python and pyVmomi present. See Issue #29537.( i i ( i i i ( t HAS_JSONSCHEMAt Falset HAS_PYVMOMIR t
versionMapt syst version_infot True( ( ( s5 /usr/lib/python2.7/site-packages/salt/states/esxvm.pyt __virtual__� s
c C@ s� i | d 6d' d 6i d 6d d 6} t j d � t j � } t j d | � y� t j i | d 6| d 6| d
6| d 6| d 6| d
6| d 6| d 6| d 6|
d 6| d 6|
d 6| d 6| d 6| d 6| d 6| d 6| d 6| � Wn+ t j j k
r
} t j j
| � � n Xt d � } y! t d | d d g d | �Wn(t j j k
rct d | |
| | d | �} | r�t
d r�| j i d j | � d 6� t d! | � | St | |
| | d" | �} | St
d r| j i d# j | � d 6� t d! | � | S| rt | � } nB t | | | | | | | | | | |
| | d$ |
d% | d" | �
} | Sn Xt | | | | | | | | | | |
| d$ |
d& | d% | d" | � } t d! | � t j | � | S(( u�
Selects the correct operation to be executed on a virtual machine, non
existing machines will be created, existing ones will be updated if the
config differs.
u nameu resultu changesu u commentu( Validating virtual machine configurationu schema = %su vm_nameu cpuu memoryu imageu versionu
interfacesu disksu scsi_devicesu serial_portsu
cd_dvd_drivesu sata_controllersu
datacenteru datastoreu placementu templateu toolsu power_onu deployu& vsphere.get_service_instance_via_proxyu vsphere.get_vmt
vm_propertiest service_instanceu vsphere.get_vm_config_fileu testu+ The virtual machine {0} will be registered.u vsphere.disconnectt power_onu( The virtual machine {0} will be created.t
cd_dvd_drivest advanced_configst sata_controllersN( t Nonet logt traceR t serializet
jsonschemat validatet
exceptionst ValidationErrort saltt InvalidConfigErrort __salt__t VMwareObjectRetrievalErrort __opts__t updatet formatt
vm_registeredt vm_clonedt
vm_createdt
vm_updated( t namet vm_namet cput memoryt imaget versiont
interfacest diskst scsi_devicest serial_portst
datacentert datastoret placementR R R t templatet toolsR t deployt resultt schemat excR t vm_file( ( s5 /usr/lib/python2.7/site-packages/salt/states/esxvm.pyt
vm_configured� s�
c C@ s& i | d 6t d 6i d 6d d 6} | S( uu
Clones a virtual machine from a template virtual machine if it doesn't
exist and a template is defined.
u nameu resultu changesu u comment( R ( R& R6 ( ( s5 /usr/lib/python2.7/site-packages/salt/states/esxvm.pyR# ; s
c C@ s
i | d 6d' d 6i d 6d d 6} t d � } t d | d |
d t d
| �} t d i | d 6| d 6| d
6| d 6| d 6| d 6| d 6| d 6| d 6|
d 6| d 6| d 6|
d 6| d 6| � } | s� | j i t d 6i d 6d j | � d 6� | St d r�d j | |
d j g t j | � D]$ \ } } d j | | j
g � ^ q'� � } | j i d' d 6| d 6� t d | � | SyJ t d | | | | | | | | | |
| d | d! |
d" | d
| � } Wne t j j
k
r5} t j d# | � | r
t d | � n | j i t d 6t j | � d 6� | SX| r�y t d$ | |
� Wne t j j k
r�} t j d# | � | r�t d | � n | j i t d 6t j | � d 6� | SX| j i t d% 6� n t d | � i | d 6t d 6| d 6d& j | � d 6} | S(( u|
Updates a virtual machine configuration if there is a difference between
the given and deployed configuration.
u nameu resultu changesu u commentu& vsphere.get_service_instance_via_proxyu vsphere.get_vm_configR0 t objectsR u vsphere.compare_vm_configsu cpuu memoryu imageu versionu
interfacesu disksu scsi_devicesu serial_portsu
datacenteru datastoreu cd_drivesu sata_controllersu advanced_configsu) Virtual machine {0} is already up to dateu testuK State vm_updated will update virtual machine '{0}' in datacenter '{1}':
{2}u
u :
u vsphere.disconnectu vsphere.update_vmR R R u Error: %su vsphere.power_on_vmu power_onu, Virtual machine {0} was updated successfullyN( R R R R R R! R t joint sixt iteritemst changes_strR R t CommandExecutionErrorR t errort text_typet VMwarePowerOnError( R& R' R( R) R* R+ R, R- R. R/ R0 R1 R R R R R6 R t current_configt diffst keyt
differencet commentt changesR8 ( ( s5 /usr/lib/python2.7/site-packages/salt/states/esxvm.pyR% H s�
=
c C@ s� i | d 6d d 6i d 6d d 6} t d rC d j | � | d <| St d � } yV t d | | | | | |
| | | | | d
| d |
d | d
| d | d | � } Wne t j j k
r
} t j d | � | r� t d | � n | j i t
d 6t j | � d 6� | SX| r�y t d | |
d | �Wne t j j
k
r�} t j d | � | rnt d | � n | j i t
d 6t j | � d 6� | SX| | d <n i | d 6| d 6} t d | � i | d 6t d 6| d 6d j | � d 6} | S( uR
Creates a virtual machine with the given properties if it doesn't exist.
u nameu resultu changesu u commentu testu# Virtual machine {0} will be createdu& vsphere.get_service_instance_via_proxyu vsphere.create_vmR/ t ide_controllersR t cd_drivesR R u Error: %su vsphere.disconnectu vsphere.power_on_vmu power_onu infou( Virtual machine {0} created successfullyN( R R R! R R R R@ R RA R R R= RB RC R ( R& R' R( R) R* R+ R, R- R. R/ R0 R1 R2 RJ R R R R R6 R t infoR8 RI ( ( s5 /usr/lib/python2.7/site-packages/salt/states/esxvm.pyR$ � sb
c C@ s( i | d 6d d 6i d 6d d 6} d j | j | j d j � } t j d j | � � t d � } y! t d
| | | | d | �Wn� t j j
k
r� } t j d | � | r� t d
| � n | j i t
d 6t j | � d 6� | St j j k
rP} t j d | � | r(t d
| � n | j i t
d 6t j | � d 6� | SX| r�y t d | | d | �Wq�t j j k
r�} t j d | � | r�t d
| � n | j i t
d 6t j | � d 6� | SXn t d
| � | j i t d 6i | d 6| d 6d 6d j | � d 6� | S( uc
Registers a virtual machine if the machine files are available on
the main datastore.
u nameu resultu changesu u commentu {0}{1}i u. Registering virtual machine with vmx file: {0}u& vsphere.get_service_instance_via_proxyu vsphere.register_vmR u Error: %su vsphere.disconnectu vsphere.power_on_vmu power_onu+ Virtual machine {0} registered successfullyN( R R! t
folderPatht filet pathR R R R R t VMwareMultipleObjectsErrorRA R R R= RB t VMwareVmRegisterErrorRC R ( R' R0 R2 R9 R R6 t vmx_pathR R8 ( ( s5 /usr/lib/python2.7/site-packages/salt/states/esxvm.pyR" � sV
( t __doc__t
__future__R R R R t loggingt salt.exceptionsR t salt.ext.sixt extR= t salt.config.schemas.esxvmR R R R t ImportErrorR t pyVmomiR R t getLoggert __name__R R R R: R# R% R$ R" ( ( ( s5 /usr/lib/python2.7/site-packages/salt/states/esxvm.pyt <module>� s6
T _<
Mini Shell