File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/saltutil.cpython-310.pyc
Back
o ;j�� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddl Z ddl Z ddl Z ddl Z ddl m!Z!m"Z"m#Z#m$Z$ zddl%Z%ddl%m&Z& dZ'W n e(y� dZ'Y nw zddl)Z)dZ*W n e(y� dZ*Y nw zej+Z,W n e-y� ej.Z,Y nw dgZ/e�0e1�Z2dd � Z3dvd d �Z4dwd d �Z5 dxdd�Z6dvdd�Z7 dxdd�Z8 dxdd�Z9dd� Z: dydd�Z; dxdd�Z< dxd d �Z= dzd d �Z> dzd d!�Z? dzd"d#�Z@ dzd$d%�ZA dxd&d'�ZBe jCjD�EeBd(�ZF dxd)d*�ZG dxd+d,�ZH dxd-d.�ZId/d0� ZJ dxd1d2�ZK dyd3d4�ZL dxd5d6�ZM dyd7d8�ZNd9d:� ZOd;d<� ZPd{d>d?�ZQe jCjD�EeQd@�ZRdAdB� ZSdCdD� ZTdEdF� ZUdGdH� ZVd|dJdK�ZWdLdM� ZXdNdO� ZYdPdQ� ZZdRdS� Z[dTdU� Z\dVdW� Z]dXdY� Z^dZd[� Z_d}d\d]�Z`d}d^d_�Za d~d`da�Zb b c d ddedf�Zc b c d ddgdh�Zddidj� Zedkdl� Zf d�dndo�Zgdpdq� ZhG drds� ds�Zidtdu� ZjdS )�z� The Saltutil module is used to manage the state of the salt minion itself. It is used to manage minion modules as well as automate updates to the salt minion. :depends: - esky Python module for update functionality � N)�CommandExecutionError�SaltInvocationError�SaltRenderError�SaltReqTimeoutError)�EskyVersionErrorTF�*c C s� zt d W S tyX tjjtt�� d��2} z| �� }|r*t | � |�� � �p(d}nd}W n t y@ } zt d|� ���d}~ww W d � n1 sKw Y |t d< | Y S w )z0 Get all environments from the top file zsaltutil._top_file_envs)Zinitial_pillar�basez Unable to render top file(s): N)� __context__�KeyError�salt�stateZ HighState�__opts__Z __pillar__�valueZget_top�listZ top_matches�keysr r )Zst_�topZenvs�exc� r �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/saltutil.py�_get_top_file_envsJ s& ���� � �r c C s� |du rt � }t|t�r|�d�}tjjjt| |||d�\}}|rBt j � td d�}tjj � |d�� W d � n1 s=w Y | dkrwt�d�rwt j �t j � td d ��rwzt �t j � td d �� W |S tyv t�d � Y |S w |S ) z; Sync the given directory in the given environment N�,)�saltenv�extmod_whitelist�extmod_blacklist�cachedir�module_refresh�a�grainsZ grains_cachezgrains.cache.pz Could not remove grains cache!)r � isinstance�str�splitr �utils�extmods�syncr �os�path�join�files�fopen�get�isfile�remove�OSError�log�error)Zformr r r �retZtouchedZmod_filer r r �_sync^ s: � ��� � �r0 c C s� i }t s d|d< |S ttdd�sd|d< |S td d�s"d|d< |S t�tjtd �}td }| sUz|� � } W n t j j yT } zd |� �|d< |W Y d }~S d }~ww | s]d |d< |S z|� | � W n ty� } zd | � d|� �|d< |W Y d }~S d }~ww z|�| � W n ty� } zd| � d|� �|d< |W Y d }~S d }~ww z|�� W n ty� } z d|� �|d< W Y d }~nd }~ww i }td D ] }td |�||< q�d|� d| � �|d< ||d< |S )a� Update the salt minion from the URL defined in opts['update_url'] Broadcom, Inc provides the latest builds here: update_url: https://packages.broadcom.com/artifactory/saltproject-generic/windows/ Be aware that as of 2014-8-11 there's a bug in esky such that only the latest version available in the update_url can be downloaded and installed. This feature requires the minion to be running a bdist_esky build. The version number is optional and will default to the most recent version available at opts['update_url']. Returns details about the transaction upon completion. CLI Examples: .. code-block:: bash salt '*' saltutil.update salt '*' saltutil.update 0.10.3 z Esky not available as import�_error�frozenFz#Minion is not running an Esky buildz config.optionZ update_urlz*"update_url" not configured on this minionZ saltversionz(Could not connect to update_url. Error: NzNo updates availablezUnable to fetch version z . Error: zUnable to install version zUnable to cleanup. Error: Zupdate_restart_serviceszservice.restartz Updated from z to Zcomment� restarted)�HAS_ESKY�getattr�sys�__salt__�eskyZEsky� executabler � __grains__Z find_update�urllibr. �URLErrorZ fetch_versionr Zinstall_versionZcleanup� Exception)�versionr/ ZappZ oldversionr r3 Zservicer r r �update~ sb ������ �� r? c C � t d| ||�}|r t� |S )a .. versionadded:: 2015.5.1 Sync beacons from ``salt://_beacons`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for beacons to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available beacons on the minion. This refresh will be performed even if no new beacons are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Example: .. code-block:: bash salt '*' saltutil.sync_beacons salt '*' saltutil.sync_beacons saltenv=dev salt '*' saltutil.sync_beacons saltenv=base,dev �beacons)r0 �refresh_beacons�r �refreshr r r/ r r r � sync_beacons� � #rE c C s t d| ||�}|S )a� .. versionadded:: 2015.5.8,2015.8.3 Sync sdb modules from ``salt://_sdb`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for sdb modules to sync. If no top files are found, then the ``base`` environment will be synced. refresh : False This argument has no affect and is included for consistency with the other sync functions. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Example: .. code-block:: bash salt '*' saltutil.sync_sdb salt '*' saltutil.sync_sdb saltenv=dev salt '*' saltutil.sync_sdb saltenv=base,dev �sdb)r0 )r r r r/ r r r �sync_sdb� s rH c C r@ )aY .. versionadded:: 0.10.0 Sync execution modules from ``salt://_modules`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for execution modules to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new execution modules are synced. Set to ``False`` to prevent this refresh. .. important:: If this function is executed using a :py:func:`module.run <salt.states.module.run>` state, the SLS file will not have access to newly synced execution modules unless a ``refresh`` argument is added to the state, like so: .. code-block:: yaml load_my_custom_module: module.run: - name: saltutil.sync_modules - refresh: True See :ref:`here <reloading-modules>` for a more detailed explanation of why this is necessary. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Example: .. code-block:: bash salt '*' saltutil.sync_modules salt '*' saltutil.sync_modules saltenv=dev salt '*' saltutil.sync_modules saltenv=base,dev �modules�r0 �refresh_modulesrC r r r � sync_modules s 4rL c C r@ )a .. versionadded:: 0.10.0 Sync state modules from ``salt://_states`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for state modules to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available states on the minion. This refresh will be performed even if no new state modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_states salt '*' saltutil.sync_states saltenv=dev salt '*' saltutil.sync_states saltenv=base,dev �statesrJ rC r r r � sync_statesG rF rN c K sZ t jjjdi | ��} | �dd�}| �dd�}| r t jj�| � |r(t|d� dS t� dS )a= .. versionadded:: 2016.3.6,2016.11.4,2017.7.0 Refresh the minion's grains without syncing custom grains modules from ``salt://_grains``. .. note:: The available execution modules will be reloaded as part of this proceess, as grains can affect which modules are available. refresh_pillar : True Set to ``False`` to keep pillar data from being refreshed. clean_pillar_cache : False Set to ``True`` to refresh pillar cache. CLI Examples: .. code-block:: bash salt '*' saltutil.refresh_grains �refresh_pillarT�clean_pillar_cacheF�� clean_cacheNr )r r! �args� clean_kwargs�popZinvalid_kwargsrO rK )�kwargsZ_refresh_pillarrP r r r �refresh_grainsp s �rW c C s t d| ||�}|rt|d� |S )a� .. versionadded:: 0.10.0 Sync grains modules from ``salt://_grains`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for grains modules to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules and recompile pillar data for the minion. This refresh will be performed even if no new grains modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type clean_pillar_cache : False Set to ``True`` to refresh pillar cache. CLI Examples: .. code-block:: bash salt '*' saltutil.sync_grains salt '*' saltutil.sync_grains saltenv=dev salt '*' saltutil.sync_grains saltenv=base,dev r rQ )r0 rO �r rD r r rP r/ r r r � sync_grains� s + rY c C r@ )aQ .. versionadded:: 0.10.0 Sync renderers from ``salt://_renderers`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for renderers to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new renderers are synced. Set to ``False`` to prevent this refresh. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_renderers salt '*' saltutil.sync_renderers saltenv=dev salt '*' saltutil.sync_renderers saltenv=base,dev � renderersrJ rC r r r �sync_renderers� s $r[ c C r@ )a� .. versionadded:: 0.10.0 Sync returners from ``salt://_returners`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for returners to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new returners are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_returners salt '*' saltutil.sync_returners saltenv=dev � returnersrJ rC r r r �sync_returners� � "r] c C r@ )a2 .. versionadded:: 2015.8.2 Sync proxy modules from ``salt://_proxy`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for proxy modules to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new proxy modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_proxymodules salt '*' saltutil.sync_proxymodules saltenv=dev salt '*' saltutil.sync_proxymodules saltenv=base,dev �proxyrJ rC r r r �sync_proxymodules rF r` c C r@ )a� .. versionadded:: 2019.2.0 Sync engine modules from ``salt://_matchers`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for engines to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new matcher modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_matchers salt '*' saltutil.sync_matchers saltenv=base,dev �matchersrJ rC r r r � sync_matchersD r^ rb c C r@ )a� .. versionadded:: 2016.3.0 Sync engine modules from ``salt://_engines`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for engines to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new engine modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_engines salt '*' saltutil.sync_engines saltenv=base,dev �enginesrJ rC r r r � sync_enginesl r^ rd c C r@ )a� .. versionadded:: 2018.3.0 Sync Thorium modules from ``salt://_thorium`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for engines to sync. If no top files are found, then the ``base`` environment will be synced. refresh: ``True`` If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new Thorium modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist comma-separated list of modules to sync extmod_blacklist comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_thorium salt '*' saltutil.sync_thorium saltenv=base,dev �thoriumrJ rC r r r � sync_thorium� r^ rf c C r@ )a� Sync outputters from ``salt://_output`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for outputters to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new outputters are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_output salt '*' saltutil.sync_output saltenv=dev salt '*' saltutil.sync_output saltenv=base,dev �outputrJ rC r r r � sync_output� s !rh �sync_outputtersc C r@ )aG .. versionadded:: 2017.7.0 Sync cloud modules from ``salt://_cloud`` to the minion saltenv : base The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new utility modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_clouds salt '*' saltutil.sync_clouds saltenv=dev salt '*' saltutil.sync_clouds saltenv=base,dev �cloudsrJ rC r r r � sync_clouds� s rk c C r@ )a# .. versionadded:: 2014.7.0 Sync utility modules from ``salt://_utils`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for utility modules to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new utility modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_utils salt '*' saltutil.sync_utils saltenv=dev salt '*' saltutil.sync_utils saltenv=base,dev r! rJ rC r r r � sync_utils rF rl c C r@ )a= .. versionadded:: 2019.2.0 Sync serializers from ``salt://_serializers`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for serializer modules to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new serializer modules are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-seperated list of modules to sync extmod_blacklist : None comma-seperated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_serializers salt '*' saltutil.sync_serializers saltenv=dev salt '*' saltutil.sync_serializers saltenv=base,dev � serializersrJ rC r r r �sync_serializers4 rF rn c C s� i } t j�td d�}t �|�}|D ]2}t� | |< tjj�t j�||��D ]\}}}|D ]}| | � |� d�d � q,q%t | | �| |< q| S )z� .. versionadded:: 2017.7.0 List Salt modules which have been synced externally CLI Examples: .. code-block:: bash salt '*' saltutil.list_extmods r r" �.r ) r$ r% r& r �listdir�setr r! Zos_walk�addr r )r/ Zext_dirZ mod_typesZmod_type�_r' Zfh_r r r � list_extmods] s "�rt c C r@ )a6 .. versionadded:: 2015.8.0 Sync log handlers from ``salt://_log_handlers`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for log handlers to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new log handlers are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_log_handlers salt '*' saltutil.sync_log_handlers saltenv=dev salt '*' saltutil.sync_log_handlers saltenv=base,dev � log_handlersrJ rC r r r �sync_log_handlersu rF rv c C s4 t d dkr td��td| ||�}|rt|d� |S )a� .. versionadded:: 2015.8.11,2016.3.2 Sync pillar modules from the ``salt://_pillar`` directory on the Salt fileserver. This function is environment-aware, pass the desired environment to grab the contents of the ``_pillar`` directory from that environment. The default environment, if none is specified, is ``base``. refresh : True Also refresh the execution modules available to the minion, and refresh pillar data. extmod_whitelist : None comma-separated list of modules to sync extmod_blacklist : None comma-separated list of modules to blacklist based on type clean_pillar_cache : False Set to ``True`` to refresh pillar cache. .. note:: This function will raise an error if executed on a traditional (i.e. not masterless) minion CLI Examples: .. code-block:: bash salt '*' saltutil.sync_pillar salt '*' saltutil.sync_pillar saltenv=dev � file_client�localz7Pillar modules can only be synced to masterless minions�pillarrQ )r r r0 rO rX r r r � sync_pillar� s '� rz c C r@ )a# .. versionadded:: 3000 Sync executors from ``salt://_executors`` to the minion saltenv The fileserver environment from which to sync. To sync from more than one environment, pass a comma-separated list. If not passed, then all environments configured in the :ref:`top files <states-top>` will be checked for log handlers to sync. If no top files are found, then the ``base`` environment will be synced. refresh : True If ``True``, refresh the available execution modules on the minion. This refresh will be performed even if no new log handlers are synced. Set to ``False`` to prevent this refresh. extmod_whitelist : None comma-seperated list of modules to sync extmod_blacklist : None comma-seperated list of modules to blacklist based on type CLI Examples: .. code-block:: bash salt '*' saltutil.sync_executors salt '*' saltutil.sync_executors saltenv=dev salt '*' saltutil.sync_executors saltenv=base,dev � executorsrJ rC r r r �sync_executors� rF r| c C sn t �d� i }t| d||�|d< t| d||�|d< t| d||�|d< t| d||�|d< t| ||�|d< t| d||�|d< t| d||�|d < t | d||�|d < t | d||�|d < t | d||�|d < t | d||�|d < t | d||�|d< t| d||�|d< t| d||�|d< t| d||�|d< t| d||�|d< t| d||�|d< td dkr�t| d||�|d< |r�t|d� |S )a� .. versionchanged:: 2015.8.11,2016.3.2 On masterless minions, pillar modules are now synced, and refreshed when ``refresh`` is set to ``True``. Sync down all of the dynamic modules from the file server for a specific environment. This function synchronizes custom modules, states, beacons, grains, returners, output modules, renderers, and utils. refresh : True Also refresh the execution modules and recompile pillar data available to the minion. This refresh will be performed even if no new dynamic modules are synced. Set to ``False`` to prevent this refresh. .. important:: If this function is executed using a :py:func:`module.run <salt.states.module.run>` state, the SLS file will not have access to newly synced execution modules unless a ``refresh`` argument is added to the state, like so: .. code-block:: yaml load_my_custom_module: module.run: - name: saltutil.sync_all - refresh: True See :ref:`here <reloading-modules>` for a more detailed explanation of why this is necessary. extmod_whitelist : None dictionary of modules to sync based on type extmod_blacklist : None dictionary of modules to blacklist based on type clean_pillar_cache : False Set to ``True`` to refresh pillar cache. CLI Examples: .. code-block:: bash salt '*' saltutil.sync_all salt '*' saltutil.sync_all saltenv=dev salt '*' saltutil.sync_all saltenv=base,dev salt '*' saltutil.sync_all extmod_whitelist={'modules': ['custom_module']} z Syncing allFrj rA rI rM rG r rZ r\ rg r! ru r{ Z proxymodulesrc re rm ra rw rx ry rQ )r- �debugrk rE rL rN rH rY r[ r] rh rl rv r| r` rd rf rn rb r rz rO rX r r r �sync_all� sH 8������ r~ c C �8 z t d i d�} W | S ty t�d� d} Y | S w )z� Signal the minion to refresh the beacons. CLI Example: .. code-block:: bash salt '*' saltutil.refresh_beacons � event.fireZbeacons_refresh�2Event module not available. Module refresh failed.F�r7 r r- r. �r/ r r r rB X � � �rB c C r )z� Signal the minion to refresh its matchers. CLI Example: .. code-block:: bash salt '*' saltutil.refresh_matchers r� Zmatchers_refreshz3Event module not available. Matcher refresh failed.Fr� r� r r r �refresh_matchersj r� r� � c C s� d|i}zP| rKt jjjdtdd��,}td |d�}t�d� |jt jj j |d�}|r0|d d u r6t� d |� W d � n 1 s@w Y W |S W |S td |d�}W |S t ye t� d � d }Y |S w )a Signal the minion to refresh the in-memory pillar data. See :ref:`pillar-in-memory`. :param wait: Wait for pillar refresh to complete, defaults to False. :type wait: bool, optional :param timeout: How long to wait in seconds, only used when wait is True, defaults to 30. :type timeout: int, optional :param clean_cache: Clean the pillar cache, only used when `pillar_cache` is True. Defaults to True :type clean_cache: bool, optional .. versionadded:: 3005 :return: Boolean status, True when the pillar_refresh event was fired successfully. CLI Example: .. code-block:: bash salt '*' saltutil.refresh_pillar salt '*' saltutil.refresh_pillar wait=True timeout=60 rR �minionT��opts�listenr� �pillar_refreshz5refresh_pillar waiting for pillar refresh to complete��tag�waitZcompleteFz1Pillar refresh did not complete within timeout %sNz2Event module not available. Pillar refresh failed.)r r! �event� get_eventr r7 r- �trace�defaults�eventsZ MINION_PILLAR_REFRESH_COMPLETE�warningr r. )r� �timeoutrR �data�eventerr/ Z event_retr r r rO | s: � ��� ��� � �rO r� c K s� t | �dd��}zC|rtd i d�}W |S tjjjdtdd��"}td ddid�}t� d� |jtj j j d d � W d � W |S 1 sDw Y W |S t y\ t�d � d }Y |S w )a# Signal the minion to refresh the module and grain data The default is to refresh module asynchronously. To block until the module refresh is complete, set the 'async' flag to False. CLI Example: .. code-block:: bash salt '*' saltutil.refresh_modules �asyncTr� r r� r� �notifyz6refresh_modules waiting for module refresh to completer� r� Nr� F)�boolr) r7 r r! r� r� r r- r� r� r� ZMINION_MOD_REFRESH_COMPLETEr r. )rV Z asynchronousr/ r� r r r rK � s. �� � � � � �rK c C s6 t � }g }|D ]}t�|�dd�| �r|�|� q|S )z� If the named function is running return the data associated with it/them. The argument can be a glob CLI Example: .. code-block:: bash salt '*' saltutil.is_running state.highstate �fun� )�running�fnmatchr) �append)r� �runr/ r� r r r � is_running� s �r� c C s t jj�t�S )z� Return the data on all running salt processes on the minion CLI Example: .. code-block:: bash salt '*' saltutil.running )r r! r� r� r r r r r r� � s r� c C s~ t jjjtd dd�D ]1\} }}|D ])}z t�tj�| |�� W q t y; } zt � d|� W Y d}~ dS d}~ww q dS )a6 Forcibly removes all caches on a minion. .. versionadded:: 2014.7.0 WARNING: The safest way to clear a minion cache is by first stopping the minion and then deleting the cache files before restarting it. CLI Example: .. code-block:: bash salt '*' saltutil.clear_cache r F�� followlinksz@Attempt to clear cache with saltutil.clear_cache FAILED with: %sNT) r r! r' � safe_walkr r$ r+ r% r& r, r- r. )�root�dirsr' �namer r r r � clear_cache� s ����� r� � c C s� t � � | d }tjjjtj�td d�dd�D ]=\}}}|D ]5}ztj�||�}tj� |�}||k r8t � |� W q t yT } zt �d|� W Y d}~ dS d}~ww qdS ) aT Forcibly removes job cache folders and files on a minion. .. versionadded:: 2018.3.0 WARNING: The safest way to clear a minion cache is by first stopping the minion and then deleting the cache files before restarting it. CLI Example: .. code-block:: bash salt '*' saltutil.clear_job_cache hours=12 i r � minion_jobsFr� zDAttempt to clear cache with saltutil.clear_job_cache FAILED with: %sNT)�timer r! r' r� r$ r% r& r �getmtime�shutil�rmtreer, r- r. ) �hoursZ thresholdr� r� r' r� � directory�mtimer r r r �clear_job_cache s* � ����� r� c C s& t � D ] }|d | kr| S qdD ]~}tj�td |�}tj�|�s$qzcd| � d�}t�|�D ]U}|�|�r�tj�||�}z;tj j � |d��}tj � |�}W d � n1 sXw Y t|t�rx|�dd � d |d < ||d < |W W S W q0 ttfy� Y q0w q0W q ty� Y qw i S ) am Return the data for a specific job id that is currently running. jid The job id to search for and return data. CLI Example: .. code-block:: bash salt '*' saltutil.find_job <job id> Note that the find_job function only returns job information when the job is still running. If the job is currently running, the output looks something like this: .. code-block:: bash # salt my-minion saltutil.find_job 20160503150049487736 my-minion: ---------- arg: - 30 fun: test.sleep jid: 20160503150049487736 pid: 9601 ret: tgt: my-minion tgt_type: glob user: root If the job has already completed, the job cannot be found and therefore the function returns an empty dictionary, which looks like this on the CLI: .. code-block:: bash # salt my-minion saltutil.find_job 20160503150049487736 my-minion: ---------- �jid)Z state_queueZ job_queuer rs z.p�rbN�pidr TZqueuedZ queue_type)r� r$ r% r& r �isdirrp �endswithr r! r' r( �payload�loadr �dict� setdefaultr, � ValueError)r� r� Z queue_nameZ queue_dir�suffix�fnr% �fp_r r r �find_job3 s@ . � � ���� �r� c C s� t j�td d�}t j�|t| ��}t j�|�s&t�d�s dS d|� d�S t j�|d�}tjj � |d�� }|� � }W d � n1 sDw Y |reztj � |�}W n ty] Y d S w t|t�re|S d S ) z� Return the data for a specific cached job id. Note this only works if cache_jobs has previously been set to True on the minion. CLI Example: .. code-block:: bash salt '*' saltutil.find_cached_job <job id> r r� Z cache_jobszVLocal jobs cache directory not found; you may need to enable cache_jobs on this minionzLocal jobs cache directory z not foundzreturn.pr� N)r$ r% r& r r r� r) r r! r' r( �readr� �loads� NameErrorr r� )r� Zproc_dirZjob_dirr% r� �bufr� r r r �find_cached_job� s* � � � r� c C s t du r t�d� t� D ]u}|d | kr�zEt r+tj|d d�jdd�D ]}|�|� q#t� t |d �|� t du rLd|v rL|d D ] }t� t |�|� qAd � t |�| |d �W S t y� tj �td d t| ��}tj �|�rwt�|� d � | � Y S w q d S )z� Sends a signal to the named salt job's process CLI Example: .. code-block:: bash salt '*' saltutil.signal_job <job id> 15 Fz|saltutil.signal job called, but psutil is not installed. Install psutil to ensure more reliable and accurate PID management.r� r� )r� T)� recursiveZ child_pidsz"Signal {} sent to job {} at pid {}r �procz7Job {} was not running and job data has been cleaned upr� )� HAS_PSUTILr- r� r� �psutil�Process�children� send_signalr$ �kill�int�formatr, r% r& r r r* r+ )r� �sigr� r� r� r% r r r � signal_job� s: � � � ���r� c C s t | tj�S )z� Sends a termination signal (SIGTERM 15) to the named salt job's process CLI Example: .. code-block:: bash salt '*' saltutil.term_job <job id> )r� �signal�SIGTERM�r� r r r �term_job� s r� c C s* g } t � D ] }| �t|d tj�� q| S )z� Sends a termination signal (SIGTERM 15) to all currently running jobs CLI Example: .. code-block:: bash salt '*' saltutil.term_all_jobs r� )r� r� r� r� r� �r/ r� r r r � term_all_jobs� s r� c C s t | t�S )z� Sends a kill signal (SIGKILL 9) to the named salt job's process CLI Example: .. code-block:: bash salt '*' saltutil.kill_job <job id> )r� � salt_SIGKILLr� r r r �kill_job� s r� c C s( g } t � D ] }| �t|d t�� q| S )z� Sends a kill signal (SIGKILL 9) to all currently running jobs CLI Example: .. code-block:: bash salt '*' saltutil.kill_all_jobs r� )r� r� r� r� r� r r r � kill_all_jobs s r� c C s� t �td �D ]} t j�td | �}zt �|� W q ty" Y qw tjj j � t��}t � d� W d � dS 1 s<w Y dS )z Used to regenerate the minion keys. CLI Example: .. code-block:: bash salt '*' saltutil.regen_keys Zpki_dirz%Recreating channel to force key regenN)r$ rp r r% r& r+ r, r �channel�client� ReqChannel�factoryr- r} )Zfn_r% r� r r r � regen_keys s � "�r� c C s� t � }d}dtv rtd D ]}|�|� q n|�td � |D ]7}tjjjjt|d��#}dtd | d�}z|�|� W n t yF d}Y nw W d � n1 sQw Y q |S ) a� The minion sends a request to the master to revoke its own key. Note that the minion session will be revoked and the minion may not be able to return the result of this command back to the master. If the 'preserve_minion_cache' flag is set to True, the master cache for this minion will not be removed. CLI Example: .. code-block:: bash salt '*' saltutil.revoke_auth TZmaster_uri_list� master_uri)r� � revoke_auth�id)�cmdr� �preserve_minion_cacheFN) r r r� r r� r� r� r� �sendr )r� Zmastersr/ r� �masterr� r� r r r r� + s2 � �� �� �� r� c C s( |r t jjj�| �}|S t j�| �}|S �N)r r� �ssh� SSHClient�get_local_client)�cfgfiler� r� r r r �_get_ssh_or_api_clientR s �r� c K s� i } d} |||||||d�} |r| j }| �d|i� n| r)| j}| �| dd�� n| j}| �| � |d i | ��D ]}| �|� | d7 } |dkrOt|�| krO nq8|rr| i }} |�� D ]\}}t|t�rj|�dd �nd |d �| |< q[| S ) Nr )�tgtr� �argr� �tgt_typer/ �kwarg�batchT)�subsetZcli� r �outZ highstate)r� r/ r ) Z cmd_batchr? Z cmd_subset�cmd_iter�len�itemsr r� r) )r� r� r� r� r� r� r/ r� r� r� rV �fcn_ret�seen� cmd_kwargsZ_cmdZret_compZold_ret�keyr r r r �_execZ sB � � � � r� r �globr� c K s� t d } t| |��} t| | ||||||fi |��} W d � n1 s#w Y | dd� � d�} | si| �d�tjjd��ritj�| �rit| |��} t| | ||||||fi |��} W d � | S 1 sdw Y | S )a% .. versionchanged:: 2017.7.0 The ``expr_form`` argument has been renamed to ``tgt_type``, earlier releases must use ``expr_form``. Assuming this minion is a master, execute a salt command CLI Example: .. code-block:: bash salt '*' saltutil.cmd � conf_fileNi����r� z{}{}r� ) r r� r� r� r� r$ r% �sep�exists) r� r� r� r� r� r/ r� r� rV r� r� r� Zmaster_cfgfiler r r r� � s* ��� � �� ��r� c k sZ � |rt jjj�td �} nt j�td �} | j| ||||||fi |��D ]}|V q%dS )a* .. versionchanged:: 2017.7.0 The ``expr_form`` argument has been renamed to ``tgt_type``, earlier releases must use ``expr_form``. Assuming this minion is a master, execute a salt command CLI Example: .. code-block:: bash salt '*' saltutil.cmd_iter r� N)r r� r� r� r r� r� ) r� r� r� r� r� r/ r� r� rV r� r r r r� � s �"�r� c C s@ | � d�}|r|tjj�� krdS ttd�r t�� dkr dS |S )a Return the master's configured user to drop to before running a master-side function, or ``None`` when no privilege change is needed or possible. ``saltutil.runner``/``saltutil.wheel`` run master-side functions inside the minion's process, which usually runs as ``root``. Since the 3006 packages the Salt master runs as the ``salt`` user by default, so those functions would otherwise touch master-owned resources (the git_pillar/gitfs cache, the pki tree, ...) as the wrong user. See #67716. �userN�geteuidr )r) r r! r Zget_user�hasattrr$ r )r� �runasr r r �_master_user_runas� s r c s� t �d�}|�� �� ����fdd�}|j|dd�}|�� z ��� \}}W |�� n|�� w |dkrAtd�� d�� d |� ���|S ) a7 Run ``client.cmd(name, **cmd_kwargs)`` in a child process that has dropped privileges to ``runas``, returning its result. Used so master-side functions invoked through ``saltutil.runner``/``saltutil.wheel`` execute as the master's configured user rather than the minion's user. See #67716. �forkc st zt jj��� ��d� j�fi ���f� W d S ty9 } z��d| jj� d| � �f� W Y d } ~ d S d } ~ ww )Nr/ �errz: ) r r! r Zchugid�putr� r= � __class__�__name__)r �r� r� r� �queuer r r �_run s "*��z _client_cmd_as.<locals>._runT)�target�daemonr zFailed to run 'z ' as user 'z': )�multiprocessingZ get_context�Queuer� �startr) r& r ) r r� r� r� �ctxr r� �statusr� r r r �_client_cmd_as� s �r r c K sR |du rg }|du r i }i }|� d|�}|� d|�}|� dd�|d< tjjjdi |��}|r3|�|� dtvrQtj� tj� td �d �}tj � |�} tj �| �} nt} tj �t�} | | jv rqtjj�| j| �} d | jv rq||d < | d v ry||d < |r�tjjjt|d | ||d�dd� |||d|d�} t| �} | r�t| | | | �S | j| fi | ��S )a[ Execute a runner function. This function must be run on the master, either by targeting a minion running on a master or by using salt-call on a master. .. versionadded:: 2014.7.0 name The name of the function to run kwargs Any keyword arguments to pass to the runner function CLI Example: In this example, assume that `master_minion` is a minion running on a master. .. code-block:: bash salt master_minion saltutil.runner jobs.list_jobs salt master_minion saltutil.runner test.arg arg="['baz']" kwarg="{'foo': 'bar'}" N�__orchestration_jid__�__env__Z __pub_user�UNKNOWNr Zmaster_job_cacher� r� r )zstate.orchestratez state.orchz state.slsZorchestration_jid�runner)�typer� rS rV r� ��prefixF�r� �pub_datar� Z print_event� full_returnr )rU r r! rS rT r? r r$ r% r& �dirname�config� master_configr Z RunnerClient� functions�get_function_argspecr� � fire_argsr r r� )r� r� r� r r r� rV r r" � master_optsZrclient�aspecr� r r r r r sP ��r c O sP |� dd�}|� dd�}td dkr,tj�tj�td �d�}tj�|�}tj � |�}nt}tj � t�}i }i } |� � D ]\} } | � d �rJ| || < q<| | | < q<zM| |j v rhtjj�|j | �} d | jv rh|| d < |rytjjjt|d | | d �d d� ||| ddd�} t|�}|r�t||| | �}W |S |j| fi | ��}W |S ty� td��w )a� Execute a wheel module and function. This function must be run against a minion that is local to the master. .. versionadded:: 2014.7.0 name The name of the function to run args Any positional arguments to pass to the wheel function. A common example of this would be the ``match`` arg needed for key functions. .. versionadded:: 2015.8.11 kwargs Any keyword arguments to pass to the wheel function CLI Example: .. code-block:: bash salt my-local-minion saltutil.wheel key.accept jerry salt my-local-minion saltutil.wheel minions.connected .. note:: Since this function must be run against a minion that is running locally on the master in order to get accurate returns, if this function is run against minions that are not local to the master, "empty" returns are expected. The remote minion does not have access to wheel functions and their return data. r Nr r Z__roler� r� r� �__r �wheel)r r� rS r� r FTr zLThis command can only be executed on a minion that is located on the master.)rU r r$ r% r& r r r! Z client_configr) Z WheelClientr� � startswithr# r! rS r$ r� r% r r r� r r )r� rS rV r� r r" r& Z wheel_clientr Z valid_kwargsr� �valr' r� r r/ r r r r) a sV # �� � ���r) c @ s e Zd Zddd�ZdS )�_MMinionFc C s� dt � vri a|tvs |r@t�t�}|d= t�t�}tj�|�}|a||j d< |j d | }dd� |D �|j d< |� � |t|< t| S )N� _mminionsZ file_rootsr c S s g | ]}|d �qS )z /_modulesr )�.0�fpr r r � <listcomp>� s z$_MMinion.__new__.<locals>.<listcomp>Z module_dirs) �globalsr- �copy�deepcopyr r: r r� Z MasterMinionr� Z gen_modules)�clsr Z reload_envr� r �mZ env_rootsr r r �__new__� s z_MMinion.__new__N�F)r � __module__� __qualname__r6 r r r r r, � s r, c O s t | �}|j| |i |��S )z� Loads minion modules from an environment so that they can be used in pillars for that environment CLI Example: .. code-block:: bash salt '*' saltutil.mmodule base test.ping )r, r# )r r� rS rV Zmminionr r r �mmodule� s r: )NNNr� )NTNN)NTNNF)NFNN)Fr� T)r� r7 )FF)r Nr� r� NF)NNFr N)k�__doc__r2 r� �loggingr r$ r� r� r6 r� � urllib.errorr; r Zsalt.channel.clientZ salt.clientZsalt.client.ssh.clientZ salt.configZsalt.defaults.eventsZ salt.payloadZ salt.runnerZ salt.stateZsalt.utils.argsZsalt.utils.eventZsalt.utils.extmodsZsalt.utils.filesZsalt.utils.functoolsZsalt.utils.minionZsalt.utils.pathZsalt.utils.processZsalt.utils.urlZsalt.utils.userZ salt.wheelZsalt.exceptionsr r r r r8 r r4 � ImportErrorr� r� �SIGKILLr� �AttributeErrorr� Z__proxyenabled__� getLoggerr r- r r0 r? rE rH rL rN rW rY r[ r] r` rb rd rf rh r! � functoolsZalias_functionri rk rl rn rt rv rz r| r~ rB r� rO r� rK r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r) r, r: r r r r �<module> s, � � � C � )% �; �)( �3 �+ �) �* �) �) �) �' �& �* �) �* �3 �* �_ /$ #V%) ' �? �/ � ! �K]
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings