Current File : //lib/python2.7/site-packages/salt/pillar/vmware_pillar.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l j j Z d d l Z
d d l m Z y* d d l
m Z d d l m Z e Z Wn e k
r� e Z n Xd Z e j e � Z d � Z d � Z d
� Z d � Z d � Z d S(
ui
Pillar data from vCenter or an ESXi host
.. versionadded:: 2017.7.0
:depends: - pyVmomi
This external pillar can pull attributes from objects in vCenter or an ESXi host and provide those attributes
as pillar data to minions. This can allow for pillar based targeting of minions on ESXi host, Datastore, VM
configuration, etc. This setup requires only the salt master have access to the vCenter server/ESXi hosts.
The pillar will return an empty dict if the 'os' or 'virtual' grain are not 'VMWare', 'ESXi', or 'VMWare ESXi'.
Defaults
========
- The external pillar will search for Virtual Machines with the VM name matching the minion id.
- Data will be returned into the 'vmware' pillar key.
- The external pillar has a default set of properties to return for both VirtualMachine and HostSystem types.
Configuring the VMWare pillar
=============================
The required minimal configuration in the salt master ext_pillar setup:
.. code-block:: yaml
ext_pillar:
- vmware:
host: <vcenter/esx host>
username: <user to connect with>
password: <password>
Optionally, the following keyword arguments can be passed to the ext_pillar for customized configuration:
pillar_key
Optionally set the pillar key to return the data into. Default is ``vmware``.
protocol
Optionally set to alternate protocol if the vCenter server or ESX/ESXi host is not
using the default protocol. Default protocol is ``https``.
port
Optionally set to alternate port if the vCenter server or ESX/ESXi host is not
using the default port. Default port is ``443``.
property_name
Property name to match the minion id against. Defaults to ``name``.
property_types
Optionally specify a list of pyVmomi vim types to search for the minion id in 'property_name'.
Default is ``['VirtualMachine']``.
For example, to search both vim.VirtualMachine and vim.HostSystem object types:
.. code-block:: yaml
ext_pillar:
- vmware:
host: myesx
username: root
password: complex_password
property_types:
- VirtualMachine
- HostSystem
Additionally, the list of property types can be dicts, the item of the dict being a list specifying
the attribute to return for that vim object type.
The pillar will attempt to recurse the attribute and return all child attributes.
To explicitly specify deeper attributes without attempting to recurse an attribute, convert the list
item to a dict with the item of the dict being the child attributes to return. Follow this pattern
to return attributes as deep within the object as necessary.
.. note::
Be careful when specifying custom attributes! Many attributes have objects as attributes which
have the parent object as an attribute and which will cause the pillar to fail due to the attempt
to convert all sub-objects recursively (i.e. infinite attribute loops). Specifying only the
sub-attributes you would like returned will keep the infinite recursion from occurring.
A maximum recursion exception will occur in this case and the pillar will not return as desired.
.. code-block:: yaml
ext_pillar:
- vmware:
host: myvcenter
username: my_user
password: my_pass
replace_default_attributes: True
property_types:
- VirtualMachine:
- config:
- bootOptions:
- bootDelay
- bootRetryDelay
- HostSystem:
- datastore:
- name
The above ext_pillar example would return a pillar like the following for a VirtualMachine object that's
name matched the minion id:
.. code-block:: yaml
vmware:
config:
bootOptions:
bootDelay: 1000
bootRetryDelay: 1000
If you were to retrieve these virtual machine attributes via pyVmomi directly, this would be the same as
.. code-block:: python
vmObject.config.bootOptions.bootDelay
vmObject.config.bootOptionis.bootRetryDelay
The above ext_pillar example would return a pillar like the following for a HostySystem object that's name
matched the minion id:
.. code-block:: yaml
vmware:
datastore:
- name: Datastore1
- name: Datastore2
The 'datastore' property of a HostSystem object is a list of datastores, thus a list is returned.
replace_default_attributes
If custom attributes are specified by the property_types parameter, replace_default_attributes determines
if those will be added to default attributes (False) or replace the default attributes completely (True).
The default setting is 'False'.
.. note::
vCenter "Custom Attributes" (i.e. Annotations) will always be returned if it exists on the object as
part of the pillar regardless of this setting.
i ( t absolute_importt print_functiont unicode_literalsN( t six( t vim( t
Disconnectu vmwarec C@ s t r
t St S( u1
Only return if python-etcd is installed
( t HAS_LIBSt __virtualname__t False( ( ( s= /usr/lib/python2.7/site-packages/salt/pillar/vmware_pillar.pyt __virtual__� s c K@ sB i } d^ } d^ } d^ } g } d } d^ } d^ }
d } t } i i d d d d d d d d
d d d
d d d g d 6i i i d i d d 6g d 6d g d 6i d d d d g d 6i d d g d 6i d d d g d 6i d! g d" 6g d# 6i i i d d$ 6d d d g d% 6g d 6g d& 6i d d' i d( d) d* d+ d, d- i d. d/ d0 d1 d d2 i d3 d4 g d5 6d6 d7 d8 g
d9 6g d# 6i d d: 6g d$ 6i d d' i i d; d 6g d# 6g d: 6g d< 6}
i d' g d# 6i d i i d d= 6d 6g d> 6i d g d$ 6i d g d 6g } d? | k r| d? } n i | | <d | k r9t j d@ � | S| d } t j dA | � dB | k rpt j dC � | S| dB } t j dD | � dE | k r�t j dF � | S| dE } t j dG | � dH | k r�| dH } | r�g } i }
q�n dI | k r�x� | dI D]� } t | t � r�| j t t | j
� dJ � � t | | j
� dJ t � rs| | | j
� dJ } q�t j dK � q| j t t | � � qWn t j
g } t j dL | � dM | k r�| dM } n d } t j dN | � dO | k r| dO } t j dP | � n dQ | k r=| dQ }
t j dR |
� n d^ } d^ } dS t k rht dS j � } n dT t k r�t dT j � } n | d k s�| dU k s�| dV k r:i | | <y`t j j j | | | | |
� } | rd^ } x| D]} t j j j | | | dW | �} | r�t | � j j dX dY � } t | dZ � r�i | | d[ <xU | j D]G } x> | j D]3 } | j | j k rk| j | | d[ | j <qkqkWq[Wn g } | |
k r�|
| } n t j | | t | | | � � | | <Pq�q�Wt! | � n t j d\ | � Wn t" k
r5t j d] � n X| Si Sd^ S(_ u+
Check vmware/vcenter for all data
u nameu vmwareu versionu guestIdu filesu toolsu flagsu memoryHotAddEnabledu cpuHotAddEnabledu cpuHotRemoveEnabledu datastoreUrlu
swapPlacementu bootOptionsu scheduledHardwareUpgradeInfou memoryAllocationu
cpuAllocationu configu parentu hostu bootTimeu runtimeu toolsStatusu toolsVersionStatusu toolsVersionStatus2u toolsRunningStatusu guestu cpuReservationu memoryReservationu committedu uncommittedu unsharedu storageu dasProtectedu dasVmProtectionu summaryu datastoreu perDatastoreUsageu VirtualMachineu
overallStatusu urlu freeSpaceu maxFileSizeu maxVirtualDiskCapacityu maxPhysicalRDMFileSizeu maxVirtualRDMFileSizeu capacityu blockSizeMbu maxBlocksu majorVersionu uuidu diskNameu partitionu extentu vmfsUpgradeableu ssdu localu vmfsu vmu
powerStateu
HostSystemu distributedVirtualSwitchu networku
pillar_keyuX VMWare external pillar configured but host is not specified in ext_pillar configuration.u vmware_pillar -- host = %su usernameu[ VMWare external pillar requested but username is not specified in ext_pillar configuration.u vmware_pillar -- username = %su passwordu[ VMWare external pillar requested but password is not specified in ext_pillar configuration.u vmware_pillar -- password = %su replace_default_attributesu property_typesi u? A property_type dict was specified, but its value is not a listu$ vmware_pillar -- property_types = %su
property_nameu# vmware_pillar -- property_name = %su protocolu vmware_pillar -- protocol = %su portu vmware_pillar -- port = %su virtualu osu vmware esxiu esxit
property_nameu vim.u u availableFieldu annotationsuY Unable to obtain a connection with %s, please verify your vmware ext_pillar configurationu� A runtime error occurred in the vmware_pillar, this is likely caused by an infinite recursion in a requested attribute. Verify your requested attributes and reconfigure the pillar.N(# t NoneR t logt errort debugt
isinstancet dictt appendt getattrR t keyst listt warningt VirtualMachinet
__grains__t lowert saltt utilst vmwaret get_service_instancet get_mor_by_propertyt typet __name__t replacet hasattrt availableFieldt customValuet keyt valuet namet
dictupdatet updatet _crawl_attributeR t RuntimeError( t minion_idt pillart kwargst
vmware_pillart hostt usernamet passwordt property_typesR
t protocolt portt
pillar_keyt replace_default_attributest type_specific_pillar_attributest pillar_attributest prop_typet virtualgraint osgraint _connt datat type_nameR" R# t type_specific_pillar_attribute( ( s= /usr/lib/python2.7/site-packages/salt/pillar/vmware_pillar.pyt
ext_pillar� sd
"
$
&
c C@ s� t | t d � � s� t | t � rR g } x! | D] } | j t | � � q1 W| St | t � r� i } x- t j | � D] \ } } t | � | | <qw W| St | d � r� t | j
� St | � Sn d S( ua
helper function to recurse through a vim object and attempt to return all child objects
u __dict__N( R R R R R t _recurse_config_to_dictR R t iteritemsR! t __dict__t _serializer( t t_datat t_listt it t_dictt kt v( ( s= /usr/lib/python2.7/site-packages/salt/pillar/vmware_pillar.pyRA � s
c C@ s t | t � r@ g } x$ | D] } | j t | | � � q W| St | t � r� i } xC | D]; } t | | � r\ t t | | d � | | � | | <q\ q\ W| St | t � r� i } x) | D]! } t j | t | | � � } q� W| Si t
t | | d � � | 6Sd S( uG
helper function to crawl an attribute specified for retrieval
N( R R R R) R R! R R R' R( RA ( t this_datat this_attrRF t dRH RI t this_dictt l( ( s= /usr/lib/python2.7/site-packages/salt/pillar/vmware_pillar.pyR) � s"
*
c C@ sQ d d l } t | | j � rM | j � d k rC | | j � } n | j � S| S( uG
helper function to serialize some objects for prettier return
i N( t datetimeR t utcoffsetR t __str__( t objRP ( ( s= /usr/lib/python2.7/site-packages/salt/pillar/vmware_pillar.pyRD s
( t __doc__t
__future__R R R t loggingt salt.utils.dictupdateR R' t salt.utils.vmwareR t salt.extR t pyVmomiR t
pyVim.connectR t TrueR t ImportErrorR R t getLoggerR R R R@ RA R) RD ( ( ( s= /usr/lib/python2.7/site-packages/salt/pillar/vmware_pillar.pyt <module>� s&
� )
Mini Shell