Current File : //usr/lib/python2.7/site-packages/salt/runners/jobs.pyc
�
���^c @@ s� 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 y d d l j Z e Z Wn e k
r� e Z n Xe j e � Z e d � Z d e e e d � Z d e d � Z! d d d d d d d e d � Z" e d d e d
� Z# d d � Z$ d d � Z% d d d d d e d
� Z& d � Z' d � Z( d � Z) e d � Z* d S( uB
A convenience system to manage jobs, both active and already run
i ( t absolute_importt print_functiont unicode_literalsN( t six( t SaltClientErrorc C@ s/ i } t j j t d � } y | j d d d t d �} Wn t k
r\ } t | � | SX| r� t j i d j t
| j � � � d 6d � n x� t j
| � D]� \ } } | r� t j i d j | � d 6d � n t | t
� s� q� n x� | D]� } | d
| k r`t | d
| � | | d
<| | d
j i i | j d d � | 6g d 6g d
6� q� | | d
d j i | d | 6� q� Wq� Wt j j t � } x� | D]� } t t d t d f � }
| j d j |
� | � } | r�x= | D]2 } | | | d
k r�| | d
j | � q�q�Wq�q�W| S( u�
Return a report on all actively running jobs from a job id centric
perspective
CLI Example:
.. code-block:: bash
salt-run jobs.active
u conf_fileu *u saltutil.runningt timeoutu timeoutu" Attempting to contact minions: {0}u messageu progressu Received reply from minion {0}u jidu pidu Runningu Returnedu
ext_job_cacheu master_job_cacheu {0}.get_jidN( t saltt clientt get_local_clientt __opts__t cmdR t printt
__jid_event__t
fire_eventt formatt listt keysR t iteritemst
isinstancet _format_jid_instancet updatet gett Nonet appendt miniont MasterMiniont
_get_returnert returners( t display_progresst retR t active_t client_errorR t datat jobt mminiont jidt returner( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt active" s<
#
<,
#c
@ s� i } t j j t � } t t d | t d f � } y t | d | d | �} Wn t k
re d SX| j d g � } | j d i � � � rx� � D]y }
| r� t j i |
d 6d � n d
� |
k r� | r� |
j d
� | |
<qq� | r� � |
j d
� | |
<q� q� Wn | rKx+ � f d � | D� D] } d | | <q4Wn y# � t
t � � � j d
� } Wn t t
f k
r�d } n X| r�i | d 6| d 6S| Sd S( u�
Return the printout from a previously executed job
jid
The jid to look up.
ext_source
The external job cache to use. Default: `None`.
returned : True
If ``True``, include the minions that did return from the command.
.. versionadded:: 2015.8.0
missing : False
If ``True``, include the minions that did *not* return from the
command.
display_progress : False
If ``True``, fire progress events.
.. versionadded:: 2015.5.0
CLI Example:
.. code-block:: bash
salt-run jobs.lookup_jid 20130916125524463507
salt-run jobs.lookup_jid 20130916125524463507 --out=highstate
u
ext_job_cacheu master_job_cachet
ext_sourceR uC Requested returner could not be loaded. No JIDs could be retrieved.u Minionsu Resultu messageu progressu returnc 3@ s! | ] } | � k r | Vq d S( N( ( t .0t x( t returns( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pys <genexpr>� s u Minion did not returnu outu outputteru dataN( R R R R R t list_jobt TypeErrorR R R
t nextt itert
StopIterationt AttributeErrorR (
R# R& t returnedt missingR R R" R$ R t targeted_minionsR t minion_idt outputter( ( R) s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt
lookup_jidQ sD #
! #
c C@ s i | d 6} t j j t � } t t d | t d f � } | re t j i d j | � d 6d � n | j d j | � | � } | j t
| | � � | j d j | � | � | d <d
j t d � } t j d � r| | j k r| j | | � } | r| | d <qn | S(
u�
List a specific job given by its jid
ext_source
If provided, specifies which external job cache to use.
display_progress : False
If ``True``, fire progress events.
.. versionadded:: 2015.8.8
CLI Example:
.. code-block:: bash
salt-run jobs.list_job 20130916125524463507
salt-run jobs.list_job 20130916125524463507 --out=pprint
u jidu
ext_job_cacheu master_job_cacheu Querying returner: {0}u messageu progressu {0}.get_loadu {0}.get_jidu Resultu {0}.get_endtimeu job_cache_store_endtimeu EndTime( R R R R R R R
R R R R R ( R# R& R R R" R$ R! t fstrt endtime( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyR* � s(
c C@ s* t t d | t d f � } | rF t j i d j | � d 6d � n t j j t � } | j d j | � � }
i } x�|
D]�} t }
| rt
}
d |
| k rt | t � rxZ | D]B } | |
| d k r� |
| d | | | k r� t }
q� q� q� Wqt
j d � qn | r�|
r�t
}
d |
| k r�|
| d } t | t j � rf| g } n xL | D]A } x8 t j j j | � D]! } t j | | � r�t }
q�q�WqmWq�n | r#|
r#t
}
d
|
| k r#xC t j j j | � D]) } t j |
| d
| � r�t }
q�q�Wq#n | r�|
r�t
}
t ryt j | � } t j |
| d � } | | k r�t }
q�q�t
j d � n | r�|
r�t
}
t r�t j | � } t j |
| d � } | | k r�t }
q�q�t
j d
� n |
r~ |
| | | <q~ q~ W| r"i | d 6| d 6S| Sd S( u�
List all detectable jobs and associated functions
ext_source
If provided, specifies which external job cache to use.
**FILTER OPTIONS**
.. note::
If more than one of the below options are used, only jobs which match
*all* of the filters will be returned.
search_metadata
Specify a dictionary to match to the job's metadata. If any of the
key-value pairs in this dictionary match, the job will be returned.
Example:
.. code-block:: bash
salt-run jobs.list_jobs search_metadata='{"foo": "bar", "baz": "qux"}'
search_function
Can be passed as a string or a list. Returns jobs which match the
specified function. Globbing is allowed. Example:
.. code-block:: bash
salt-run jobs.list_jobs search_function='test.*'
salt-run jobs.list_jobs search_function='["test.*", "pkg.install"]'
.. versionchanged:: 2015.8.8
Multiple targets can now also be passed as a comma-separated list.
For example:
.. code-block:: bash
salt-run jobs.list_jobs search_function='test.*,pkg.install'
search_target
Can be passed as a string or a list. Returns jobs which match the
specified minion name. Globbing is allowed. Example:
.. code-block:: bash
salt-run jobs.list_jobs search_target='*.mydomain.tld'
salt-run jobs.list_jobs search_target='["db*", "myminion"]'
.. versionchanged:: 2015.8.8
Multiple targets can now also be passed as a comma-separated list.
For example:
.. code-block:: bash
salt-run jobs.list_jobs search_target='db*,myminion'
start_time
Accepts any timestamp supported by the dateutil_ Python module (if this
module is not installed, this argument will be ignored). Returns jobs
which started after this timestamp.
end_time
Accepts any timestamp supported by the dateutil_ Python module (if this
module is not installed, this argument will be ignored). Returns jobs
which started before this timestamp.
.. _dateutil: https://pypi.python.org/pypi/python-dateutil
CLI Example:
.. code-block:: bash
salt-run jobs.list_jobs
salt-run jobs.list_jobs search_function='test.*' search_target='localhost' search_metadata='{"bar": "foo"}'
salt-run jobs.list_jobs start_time='2015, Mar 16 19:00' end_time='2015, Mar 18 22:00'
u
ext_job_cacheu master_job_cacheu Querying returner {0} for jobs.u messageu progressu {0}.get_jidsu MetadatauK The search_metadata parameter must be specified as a dictionary. Ignoring.u Targetu Functionu StartTimeuA 'dateutil' library not available, skipping start_time comparison.u? 'dateutil' library not available, skipping end_time comparison.u outputteru dataN( R R R R
R R R R R t Truet FalseR t dictt logt infoR t string_typest utilst argst split_inputt fnmatcht DATEUTIL_SUPPORTt dateutil_parsert parset error( R& R4 t search_metadatat search_functiont
search_targett
start_timet end_timeR R$ R" R t mrett itemt _matcht keyt targetst targett parsed_start_timet _start_timet parsed_end_time( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt list_jobs� sz T
c C@ s� t t d | t d f � } | rF t j i d j | � d 6d � n t j j t � } d j | � } | | j k r� t d j | � � � n | j | | | � } | r� i | d 6| d 6S| Sd
S( u
List all detectable jobs and associated functions
ext_source
The external job cache to use. Default: `None`.
CLI Example:
.. code-block:: bash
salt-run jobs.list_jobs_filter 50
salt-run jobs.list_jobs_filter 100 filter_find_job=False
u
ext_job_cacheu master_job_cacheu Querying returner {0} for jobs.u messageu progressu {0}.get_jids_filteru, '{0}' returner function not implemented yet.u outputteru dataN(
R R R R
R R R R R t NotImplementedError( t countt filter_find_jobR& R4 R R$ R" t funR ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt list_jobs_filtery s"
c C@ s i } t t d | t d f � } t j j t � } y3 | j d j | � | � } t | | � | | <Wn) t k
r� d j | � | | d <| SX| j d j | � | � | | d <d j t d � } t j d � r| | j k r| j | | � } | r| | | d <qn | S(
u�
Print a specific job's detail given by it's jid, including the return data.
CLI Example:
.. code-block:: bash
salt-run jobs.print_job 20130916125524463507
u
ext_job_cacheu master_job_cacheu {0}.get_loadu` Requested returner {0} is not available. Jobs cannot be retrieved. Check master log for details.u Resultu {0}.get_jidu {0}.get_endtimeu job_cache_store_endtimeu EndTime(
R R R R R R R R R+ R ( R# R& R R$ R" R! R6 R7 ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt print_job� s*
$c C@ s� t � } t | d | �} | j d g � } | j d i � } xU | D]M } | | k r� d | | k r� | | d r| t n t | | <qF t | | <qF Wx9 | D]1 } d | | k r� | | d r� t | | <q� q� W| S( u
Check if a job has been executed and exit successfully
jid
The jid to look up.
ext_source
The external job cache to use. Default: `None`.
CLI Example:
.. code-block:: bash
salt-run jobs.exit_success 20160520145827701627
R& u Minionsu Resultu return( R: R* R R8 R9 ( R# R& R R t minionst resultR ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt exit_success� s
!
c
C@ s� | r) t | t � s) t j d � t Sn t d | d | d | d | d | d | � } | ry t | � d } t | | � St Sd S(
uA
.. versionadded:: 2015.8.0
List all detectable jobs and associated functions
CLI Example:
.. code-block:: bash
salt-run jobs.last_run
salt-run jobs.last_run target=nodename
salt-run jobs.last_run function='cmd.run'
salt-run jobs.last_run metadata="{'foo': 'bar'}"
u8 The metadata parameter must be specified as a dictionaryR& R4 RF RG RH R i����N( R R: R; R< R9 RT t sortedRZ ( R& R4 t metadatat functionRP R t _all_jobst last_job( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt last_run� s
c C@ s+ x$ | D] } | r | d k r | Sq Wd S( uF
Helper to iterate over returner_types and pick the first one
N( R ( t returner_typesR$ ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyR s
c C@ s | s i d d 6} | Si | j d d � d 6t | j d g � � d 6| j d d � d
6| j d d � d
6| j d d � d 6} d | k r� | j d i � | d <n< d | k r� d | d k r� | d j d i � | d <q� n d | k r | d | d <n | S( u)
Helper to format a job instance
u/ Cannot contact returner or no job with this jidu Erroru funu unknown-functionu Functionu argu Argumentsu tgtu unknown-targetu Targetu tgt_typeu listu Target-typeu useru rootu Useru metadatau Metadatau kwargsu Minions( R R ( R! R ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt _format_job_instance" s
c C@ s3 t | � } | j i t j j j | � d 6� | S( u'
Helper to format jid instance
u StartTime( Re R R R> R# t jid_to_time( R# R! R ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyR = s #c
c@ s3 t j j t � } xt j | � D] } t j j | | � } x� t j | � D]� } t j j | | d � } t j j j
| d � � } | j | � } Wd QXt j j | � s� qM n t j j j
| d � � } | j | � } Wd QX| d } | rt
j i d j | � d 6d � n | | | | f VqM Wq" Wd S( u2
Walk through the job dir and return jobs
u .load.pu rbNu jidu
Found JID {0}u messageu progress( R t payloadt SerialR t ost listdirt patht joinR> t filest fopent loadt isfileR R
R (
t job_dirR t serialt topt t_patht finalt load_patht rfhR! R# ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt
_walk_throughF s"
(+ t __doc__t
__future__R R R RA t loggingRi t salt.clientR t salt.payloadt salt.utils.argst salt.utils.filest salt.utils.jidt salt.miniont salt.returnerst salt.extR t salt.exceptionsR t dateutil.parsert parserRC R8 RB t ImportErrorR9 t getLoggert __name__R; R% R R5 R* RT RY RZ R] Rc R Re R Rx ( ( ( s5 /usr/lib/python2.7/site-packages/salt/runners/jobs.pyt <module> sb
0 Q. � ( ( % "
Mini Shell