Current File : //lib/python2.7/site-packages/salt/modules/mine.pyc
�
���^c @@ so 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 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 d d d d d
d d g � Z d
g Z e j e � Z d � Z d � Z d � Z d � Z e d d � Z d � Z! d e d � Z" d � Z# d � Z$ d d e d � Z% d � Z& d S( up
The function cache system allows for data to be stored on the master so it can be easily read by other minions
i ( t absolute_importt print_functiont unicode_literalsN( t SaltClientError( t sixu
__pub_useru __pub_argu __pub_funu __pub_jidu __pub_tgtu __pub_tgt_typeu __pub_retu *c C@ sR d t k rJ y t j j t � t d <WqJ t k
rF t j d � qJ Xn t d S( u
Return the auth object
u authuE Could not authenticate with master.Mine data will not be transmitted.( t __context__t saltt cryptt SAutht __opts__R t logt error( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt _auth( s
c C@ s$ | t k r t j d | � t St S( Nu+ Function %s in mine_functions not available( t __salt__R
R t Falset True( t func( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt _mine_function_available5 s c C@ s> t j j j | d t �} | j | d � } t j d � | S( Nt listenu _minion_mineg �?( R t utilst eventt MinionEventR t
fire_eventt timet sleep( t loadt optst eventert event_ret( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt
_mine_send< s
c C@ s� | j d d � d k rW y t � j d � | d <WqW t k
rS t j d � t SXn t j j j
j | � } z | j | � } Wd | j
� X| S( Nu transportu u zeromqu tcpR u tokuE Mine could not authenticate with master. Mine could not be retrieved.( u zeromqu tcp( t getR t gen_tokent AttributeErrorR
R R R t transportt clientt
ReqChannelt factoryt sendt close( R R t channelt ret( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt _mine_getE s
c C@ s� i } | s, t d d i � } | s| d SnP | rZ t | t � rZ t d � | D� � } n" | rx t | t � rx | } n d Si } xy| D]q} y(| | r� t | | t � r� | | j d | � } t | � s� w� n t | | | � | | <n� | | r�t | | t � r�| } t | | d t � rfd | | d k rf| | d d } | | j d � n t | � sxw� n t | | | � | | <n# t | � s�w� n t | � | | <Wq� t k
r�t j � } t j
d | � t j d | � q� q� Xq� Wt d d
k r]| sLt d d � } t | t � rL| j
| � | } qLn t d
d | � Si d d 6| d 6t d d 6| d 6} t | t � S( u
Execute the configured functions and send the data back up to the master.
The functions to be executed are merged from the master config, pillar and
minion config under the option `mine_functions`:
.. code-block:: yaml
mine_functions:
network.ip_addrs:
- eth0
disk.usage: []
This function accepts the following arguments:
clear: False
Boolean flag specifying whether updating will clear the existing
mines, or will update. Default: `False` (update).
mine_functions
Update the mine data on certain functions only.
This feature can be used when updating the mine for functions
that require refresh at different intervals than the rest of
the functions specified under `mine_functions` in the
minion/master config or pillar.
A potential use would be together with the `scheduler`, for example:
.. code-block:: yaml
schedule:
lldp_mine_update:
function: mine.update
kwargs:
mine_functions:
net.lldp: []
hours: 12
In the example above, the mine for `net.lldp` would be refreshed
every 12 hours, while `network.ip_addrs` would continue to be updated
as specified in `mine_interval`.
The function cache will be populated with information from executing these
functions
CLI Example:
.. code-block:: bash
salt '*' mine.update
u config.mergeu mine_functionsNc s@ s | ] } | i f Vq d S( N( ( t .0t fun( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pys <genexpr>� s u
mine_functioni u/ Function %s in mine_functions failed to executeu Error: %su file_clientu localu data.getu
mine_cacheu data.updateu _mineu cmdu datau idu clear( R
t
isinstancet listt dictt popR t Exceptiont tracebackt
format_excR
R t debugR t updateR ( t cleart mine_functionst m_datat dataR t mine_funct tracet oldR ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyR4 V s^ 2
+
c O@ s t j j j | � } | j d | � } | t k r7 t Si } t j j j t | � } t j | � } xT t
| j d g � � D]: \ } } y | | | | d | <Wq~ t k
r� q~ Xq~ Wt j j j
t | | d t �} x2 | D]* }
|
| d k r� | d j |
� q� q� WyJ d | k rDt | | d | d � | | <n t | | d � | | <Wn' t k
r�} t j d | | � t SXt d d k r�t d d � } t | t � r�| j | � | } n t d
d | � Si d d 6| d
6t d d 6}
t |
t � S( u�
Send a specific function to the mine.
CLI Example:
.. code-block:: bash
salt '*' mine.send network.ip_addrs eth0
salt '*' mine.send eth0_ip_addrs mine_function=network.ip_addrs eth0
u
mine_functionu argst expected_extra_kwsu kwargsu. Function %s in mine.send failed to execute: %su file_clientu localu data.getu
mine_cacheu data.updateu _mineu cmdu datau id( R R t argst clean_kwargsR/ R
R t
arg_lookupt copyt deepcopyt enumerateR t
IndexErrort format_callt MINE_INTERNAL_KEYWORDSt appendR0 R
R R R, R. R4 R ( R R= t kwargsR9 R8 t arg_datat func_datat indt _t f_callt argt excR; R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyR% � sL %
"
u globc C@ s= t d d k r� i } i t d d 6t d d 6t d d 6t d d
6t d d 6t d
d 6t d d 6t d d 6t d d 6| | � } | r� t d d � } t | t � r� | | k r� | | | t d <q� n | Si d d 6t d d 6| d 6| d 6| d 6} t | t � } | r9t d | k r9| t d =q9n | S( u�
Get data from the mine based on the target, function and tgt_type
Targets can be matched based on any standard matching system that can be
matched on the master via these keywords:
- glob
- pcre
- grain
- grain_pcre
- compound
- pillar
- pillar_pcre
Note that all pillar matches, whether using the compound matching system or
the pillar matching system, will be exact matches, with globbing disabled.
exclude_minion
Excludes the current minion from the result set
CLI Example:
.. code-block:: bash
salt '*' mine.get '*' network.interfaces
salt '*' mine.get 'os:Fedora' network.interfaces grain
salt '*' mine.get 'G@os:Fedora and S@192.168.5.0/24' network.ipaddrs compound
.. seealso:: Retrieving Mine data from Pillar and Orchestrate
This execution module is intended to be executed on minions.
Master-side operations such as Pillar or Orchestrate that require Mine
data should use the :py:mod:`Mine Runner module <salt.runners.mine>`
instead; it can be invoked from a Pillar SLS file using the
:py:func:`saltutil.runner <salt.modules.saltutil.runner>` module. For
example:
.. code-block:: jinja
{% set minion_ips = salt.saltutil.runner('mine.get',
tgt='*',
fun='network.ip_addrs',
tgt_type='glob') %}
u file_clientu localu
match.globu globu
match.pcreu pcreu
match.listu listu match.grainu grainu match.grain_pcreu
grain_pcreu match.ipcidru ipcidru match.compoundu compoundu match.pillaru pillaru match.pillar_pcreu pillar_pcreu data.getu
mine_cacheu idu _mine_getu cmdu tgtu funu tgt_type( R R
R, R. R) ( t tgtR+ t tgt_typet exclude_minionR( t is_targetR8 R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyR � s8 0
c C@ s� t d d k rV t d d � } t | t � rE | | k rE | | =n t d d | � Si d d 6t d d 6| d 6} t | t � S(
u�
Remove specific function contents of minion. Returns True on success.
CLI Example:
.. code-block:: bash
salt '*' mine.delete 'network.interfaces'
u file_clientu localu data.getu
mine_cacheu data.updateu _mine_deleteu cmdu idu fun( R R
R, R. R ( R+ R8 R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt deleteD s
c C@ sF t d d k r! t d d i � Si d d 6t d d 6} t | t � S( u�
Remove all mine contents of minion. Returns True on success.
CLI Example:
.. code-block:: bash
salt '*' mine.flush
u file_clientu localu data.updateu
mine_cacheu _mine_flushu cmdu id( R R
R ( R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt flush[ s
c C@ s� | r: g } | j t | t � r' | n | g � | } n | rt g } | j t | t � ra | n | g � | } n d } t d | � } i } x�t j | � D]�} | j d � } g }
| sx� t j | d � D]; } d | k r� x& | d D] } |
j | d � q� Wq� q� Wni xf | D]^ }
|
| d k r d | d |
k r{x. | d |
d D] } |
j | d � qZWq{q q Wt t |
� � }
| r�g } xJ | D]B } x9 |
D]1 } t j
j j | | g � r�| j | � q�q�Wq�Wt t | � � }
n x�t j | � D]t} | d d } | d | k rDi | | d <n x<| d
D]0} | j d � } | d k r�x |
D]} } | | d j
d
i � j
| d g � } d j | | d � } | r�| | f } n | } | | k rw| j | � qwqwWqO| rO| | d j
d
i � j
| d g � } d j | d | d � } | rZ| | f } n | } | | k r| j | � qqOqOWqWq� W| S( u�
.. versionchanged:: 2017.7.8,2018.3.3
When :conf_minion:`docker.update_mine` is set to ``False`` for a given
minion, no mine data will be populated for that minion, and thus none
will be returned for it.
.. versionchanged:: 2019.2.0
:conf_minion:`docker.update_mine` now defaults to ``False``
Get all mine data for :py:func:`docker.ps <salt.modules.dockermod.ps_>` and
run an aggregation routine. The ``interfaces`` parameter allows for
specifying the network interfaces from which to select IP addresses. The
``cidrs`` parameter allows for specifying a list of subnets which the IP
address must match.
with_container_id
Boolean, to expose container_id in the list of results
.. versionadded:: 2015.8.2
CLI Example:
.. code-block:: bash
salt '*' mine.get_docker
salt '*' mine.get_docker interfaces='eth0'
salt '*' mine.get_docker interfaces='["eth0", "eth1"]'
salt '*' mine.get_docker cidrs='107.170.147.0/24'
salt '*' mine.get_docker cidrs='["107.170.147.0/24", "172.17.42.0/24"]'
salt '*' mine.get_docker interfaces='["eth0", "eth1"]' cidrs='["107.170.147.0/24", "172.17.42.0/24"]'
u docker.psu *u hostu
interfacesu inetu addressu Infou Idu Imageu Portsu IPu 0.0.0.0u ipv4u PrivatePortu {0}:{1}u
PublicPort( t extendR, R- R R t
itervaluesR/ RF t setR R t networkt in_subnett
setdefaultt format( t
interfacest cidrst with_container_idt
interface_t cidr_t cmdt docker_hostst proxy_listst
containerst hostt host_ipst infot ip_t interfacet itemt good_ipst cidrt containert container_idt dock_portt
ip_addresst container_network_footprintt value( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt
get_dockern sp !% %
* * c C@ sS t d d i � } | s d Si } x)| D]!} | | r� t | | t � r� | | j d | � } t | � su q* n i | | | 6| | <q* | | r+t | | t � r+| } t | | d t � rd | | d k r| | d d } | | j d � n t | � sq* n i | | | 6| | <q* t | � s=q* n | | | | <q* W| S( u|
List valid entries in mine configuration.
CLI Example:
.. code-block:: bash
salt '*' mine.valid
u config.mergeu mine_functionsNu
mine_functioni ( R
R, R. R/ R R- ( R7 R8 R R9 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt valid� s,
+ (' t __doc__t
__future__R R R R@ t loggingR R1 t
salt.cryptR t salt.payloadt salt.utils.argst salt.utils.eventt salt.utils.networkt salt.transport.clientt salt.exceptionsR t salt.extR t frozensetRE t __proxyenabled__t getLoggert __name__R
R R R R) R t NoneR4 R% R RS RT Rs Rt ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/mine.pyt <module> sF
i 8 L l
Mini Shell