golden hour

/opt/saltstack/salt/lib/python3.10/site-packages/salt/pillar/__pycache__

File/Folder	Size	Actions
__init__.cpython-310.pyc	27.26 KB
azureblob.cpython-310.pyc	11.38 KB
cmd_json.cpython-310.pyc	772 B
cmd_yaml.cpython-310.pyc	845 B
cmd_yamlex.cpython-310.pyc	780 B
cobbler.cpython-310.pyc	1.77 KB
confidant.cpython-310.pyc	2.89 KB
consul_pillar.cpython-310.pyc	9.77 KB
csvpillar.cpython-310.pyc	2.04 KB
digicert.cpython-310.pyc	1.21 KB
django_orm.cpython-310.pyc	6.04 KB
ec2_pillar.cpython-310.pyc	6.72 KB
etcd_pillar.cpython-310.pyc	4.09 KB
extra_minion_data_in_pillar.cpython-310.pyc	1.94 KB
file_tree.cpython-310.pyc	14.62 KB
foreman.cpython-310.pyc	3.28 KB
git_pillar.cpython-310.pyc	18.37 KB
gpg.cpython-310.pyc	806 B
hg_pillar.cpython-310.pyc	4.02 KB
hiera.cpython-310.pyc	1.01 KB
http_json.cpython-310.pyc	3.09 KB
http_yaml.cpython-310.pyc	2.79 KB
libvirt.cpython-310.pyc	3.8 KB
makostack.cpython-310.pyc	20.4 KB
mongo.cpython-310.pyc	5.5 KB
mysql.cpython-310.pyc	3.91 KB
nacl.cpython-310.pyc	1 KB
netbox.cpython-310.pyc	27.71 KB
neutron.cpython-310.pyc	2.59 KB
nodegroups.cpython-310.pyc	1.71 KB
pepa.cpython-310.pyc	16.02 KB
pillar_ldap.cpython-310.pyc	8.87 KB
postgres.cpython-310.pyc	3.13 KB
puppet.cpython-310.pyc	856 B
reclass_adapter.cpython-310.pyc	2.95 KB
redismod.cpython-310.pyc	2.85 KB
rethinkdb_pillar.cpython-310.pyc	3.77 KB
s3.cpython-310.pyc	12 KB
saltclass.cpython-310.pyc	1.13 KB
sql_base.cpython-310.pyc	11.91 KB
sqlcipher.cpython-310.pyc	3.79 KB
sqlite3.cpython-310.pyc	3.06 KB
stack.cpython-310.pyc	21.51 KB
svn_pillar.cpython-310.pyc	5.19 KB
varstack_pillar.cpython-310.pyc	1.29 KB
vault.cpython-310.pyc	6.16 KB
venafi.cpython-310.pyc	1.17 KB
virtkey.cpython-310.pyc	670 B
vmware_pillar.cpython-310.pyc	11.18 KB

Edit: vmware_pillar.cpython-310.pyc

�����xeRC����������������������@���s����d�Z�ddlZddlm��mZ�ddlZzddlmZ�ddl	m
Z
�dZW�n�ey.���dZY�nw�dZ
e�e�Zdd	��Zd
d��Zdd
��Zdd��Zdd��ZdS�)ai��
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.

�����N)�
Disconnect)�vimTF�vmwarec�������������������C���s���t�rtS�dS�)z1
    Only return if python-etcd is installed
    F)�HAS_LIBS�__virtualname__��r���r����M/opt/saltstack/salt/lib/python3.10/site-packages/salt/pillar/vmware_pillar.py�__virtual__����s���r	���c�����������������K���sT��i�}d}d}d}g�}d}d}	d}
d}d}dg�d�iddd	dd
digidgidg�d
�idddgidg�d�iddgigiddddidddgigigddddddddddd d!d"d#d$d%d&d'd(d)gid*d+d,g
igid-digid-ddddd.igigigd/�}
ddgid0ddd1diigiddgid
dgig}d2|v�r�|d2�}i�||<�d	|vr�t��d3��|S�|d	�}t��d4|��d5|vr�t��d6��|S�|d5�}t��d7|��d8|vr�t��d9��|S�|d8�}t��d:|��d;|v�r�|d;�}|r�g�}i�}
d<|v��r&|d<�D�]3}t|t��rtt|��}|�tt	|���t||�t
��r|||��}q�t��d=��q�|�tt	|���q�nt	jg}t��d>|��d?|v��r:|d?�}nd}t��d@|��dA|v��rQ|dA�}	t��dB|	��dC|v��r`|dC�}
t��dD|
��d}d}dEt
v��rot
dE����}dFt
v��rzt
dF����}|dk�s�|dGk�s�|dHk�r(i�||<�z�tjjj||||	|
|�dIdJ�dK�}|�rd}|D�]a}tjjj|||�|dL�}|�rt|�j�dMdN�}t|dO��r�i�||�dP<�|jD�]}|jD�]}|j|jk�r�|j||�dP�|j<��qӐq�g�}||
v��r�|
|�}t�||�t |||���||<��n�q�t!|��W�|S�t��dQ|��W�|S��t"�y'���t��dR��Y�|S�w�i�S�)Sz+
    Check vmware/vcenter for all data
    N�namer���FZconfig)�versionZguestId�filesZtools�flagsZmemoryHotAddEnabledZcpuHotAddEnabledZcpuHotRemoveEnabledZdatastoreUrlZ
swapPlacementZbootOptionsZscheduledHardwareUpgradeInfoZmemoryAllocationZ
cpuAllocationZsummaryZruntime�host�parentZbootTimeZguest)ZtoolsStatusZtoolsVersionStatusZtoolsVersionStatus2ZtoolsRunningStatusZcpuReservationZmemoryReservationZstorage)�	committed�uncommitted�unsharedZdasVmProtectionZdasProtectedZperDatastoreUsageZ	datastorer���r���r���Z
overallStatus�urlZ	freeSpaceZmaxFileSizeZmaxVirtualDiskCapacityZmaxPhysicalRDMFileSizeZmaxVirtualRDMFileSizeZvmfsZcapacityZblockSizeMbZ	maxBlocksZmajorVersionr���ZuuidZextentZdiskName�	partitionZvmfsUpgradeableZssd�localZvmZ
powerState)�VirtualMachineZ
HostSystemZnetworkZdistributedVirtualSwitch�
pillar_keyzXVMWare external pillar configured but host is not specified in ext_pillar configuration.zvmware_pillar -- host = %s�usernamez[VMWare external pillar requested but username is not specified in ext_pillar configuration.zvmware_pillar -- username = %s�passwordz[VMWare external pillar requested but password is not specified in ext_pillar configuration.zvmware_pillar -- password = %s�replace_default_attributes�property_typesz?A property_type dict was specified, but its value is not a listz$vmware_pillar -- property_types = %s�
property_namez#vmware_pillar -- property_name = %s�protocolzvmware_pillar -- protocol = %s�portzvmware_pillar -- port = %sZvirtual�oszvmware esxiZesxi�
verify_sslT)r ���)r���zvim.���availableFieldZannotationszYUnable to obtain a connection with %s, please verify your vmware ext_pillar configurationz�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.)#�log�error�debug�
isinstance�dict�next�iter�append�getattrr����list�warningr���Z
__grains__�lower�salt�utilsr���Zget_service_instance�getZget_mor_by_property�type�__name__�replace�hasattrr"����customValue�key�valuer
����
dictupdate�update�_crawl_attributer����RuntimeError)Z	minion_idZpillar�kwargsZ
vmware_pillarr���r���r���r���r���r���r���r���r���Ztype_specific_pillar_attributesZpillar_attributesZ	prop_typeZnext_prop_type_keyZvirtualgrainZosgrainZ_conn�data�	type_namer"���r6���Ztype_specific_pillar_attributer���r���r����
ext_pillar����sz����

�������2
������ ����[����

���

��

����
����
��
���
r@���c�����������������C���s����t�|�td��sBt�|�t�rg�}|�D�]	}|�t|���q|S�t�|�t�r4i�}|����D�]
\}}t|�||<�q'|S�t|�d�r>t|�j�S�t	|��S�dS�)za
    helper function to recurse through a vim object and attempt to return all child objects
    N�__dict__)
r&���r2���r,���r*����_recurse_config_to_dictr'����itemsr5���rA����_serializer)Zt_data�t_list�i�t_dict�k�vr���r���r���rB������s���

�rB���c�����������������C���s����t�|�t�rg�}|�D�]
}|�t||���q	|S�t�|t�r6i�}|D�]}t|�|�r3tt|�|d�||��||<�q|S�t�|t�rMi�}|D�]}t�|t|�|��}q?|S�|t	t|�|d��iS�)zG
    helper function to crawl an attribute specified for retrieval
    N)
r&���r,���r*���r;���r'���r5���r+���r9���r:���rB���)Z	this_dataZ	this_attrrE����drG���rH���Z	this_dict�lr���r���r���r;������s*���

��
�r;���c�����������������C���s8���ddl�}t|�|j��r|����dur|�|�����}�|����S�|�S�)zG
    helper function to serialize some objects for prettier return
    r���N)�datetimer&����	utcoffset�__str__)�objrL���r���r���r���rD������s���rD���)�__doc__ZloggingZsalt.utils.dictupdater0���r9���Zsalt.utils.vmwarer/���Z
pyVim.connectr���ZpyVmomir���r����ImportErrorr���Z	getLoggerr3���r#���r	���r@���rB���r;���rD���r���r���r���r����<module>���s(������
�}