SaltSack 中Job管理

一、简介

Jid： job id的格式为%Y%m%d%H%M%S%f

master在下发指令消息时，会附带上产生的jid，minion在接收到指令开始执行时，会在本地的cachedir(默认是/var/cache/salt/minion)下的proc目录下产生该jid命名的文件，用于在执行过程中master查看当前任务执行的情况，在指令执行完毕蒋结果传送给master后，删除该临时文件。 master将minion的执行结果存放在本地/var/cache/salt/master/jobs目录中，默认缓存24小时（可以通过修改master配置文件中keepjobs选项调整）

在执行指令时添加 -v 选项可以显示命令执行的job id 如：

[root@master reactor]# salt -v 'master' test.ping
Executing job with jid    #可以显示任务的Job id
-------------------------------------------

master:
    True

-------------------------------------------
Summary
-------------------------------------------
# of minions targeted:
# of minions returned:
# of minions that did not return:
# of minions with errors:
-------------------------------------------
[root@master reactor]#

二、Job基本管理

saltutil模块中的job管理方法

通过salt  *  sys.doc saltutil |grep job

[root@master reactor]# salt master sys.doc saltutil | grep job
saltutil.clear_job_cache:
    Forcibly removes job cache folders and files on a minion.
        salt '*' saltutil.clear_job_cache hours=
saltutil.find_cached_job:
    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.
        salt '*' saltutil.find_cached_job <job id>
saltutil.find_job:
    Return the data for a specific job id that is currently running.
        The job id to search for and return data.
        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:
        # salt my-minion saltutil.find_job
    If the job has already completed, the job cannot be found and therefore the function returns
        # salt my-minion saltutil.find_job
saltutil.kill_all_jobs:
    Sends a kill signal (SIGKILL ) to all currently running jobs
        salt '*' saltutil.kill_all_jobs
saltutil.kill_job:
    Sends a kill signal (SIGKILL ) to the named salt job's process
        salt '*' saltutil.kill_job <job id>
        salt master_minion saltutil.runner jobs.list_jobs
saltutil.signal_job:
    Sends a signal to the named salt job's process
        salt '*' saltutil.signal_job <job id>
saltutil.term_all_jobs:
    Sends a termination signal (SIGTERM ) to all currently running jobs
        salt '*' saltutil.term_all_jobs
saltutil.term_job:
    Sends a termination signal (SIGTERM ) to the named salt job's process
        salt '*' saltutil.term_job <job id>

1、salt '*' saltutil.running  　　　　　　　　　　#查看minion当前正在运行的jobs

2、salt '*' saltutil.find_job <jid>  　　　　　　    #查看指定jid的job（minion正在运行的jobs）

3、salt '*' saltutil.signal_job <jid> <single>  　　#给指定的jid进程发送信号

4、salt '*' saltutil.term_job <jid>　　　　　　　 #终止指定的jid进程(信号为15)

5、salt '*' saltutil.kill_job <jid>  　　　　　　　 #终止指定的jid进程（信号为9）

salt runner中的job管理方法

可以执行salt-run -d |grep jobs  查看到相关jobs命令

[root@master reactor]# salt-run  -d | grep jobs
jobs.active:
    Return a report on all actively running jobs from a job id centric
        salt-run jobs.active
jobs.exit_success:
        salt-run jobs.exit_success
jobs.last_run:
    List all detectable jobs and associated functions
        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'}"
jobs.list_job:
        salt-run jobs.list_job
        salt-run jobs.list_job  --out=pprint
jobs.list_jobs:
    List all detectable jobs and associated functions
        If more than one of the below options are used, only jobs which match
            salt-run jobs.list_jobs search_metadata='{"foo": "bar", "baz": "qux"}'
        Can be passed as a string or a list. Returns jobs which match the
            salt-run jobs.list_jobs search_function='test.*'
            salt-run jobs.list_jobs search_function='["test.*", "pkg.install"]'
                salt-run jobs.list_jobs search_function='test.*,pkg.install'
        Can be passed as a string or a list. Returns jobs which match the
            salt-run jobs.list_jobs search_target='*.mydomain.tld'
            salt-run jobs.list_jobs search_target='["db*", "myminion"]'
                salt-run jobs.list_jobs search_target='db*,myminion'
        module is not installed, this argument will be ignored). Returns jobs
        module is not installed, this argument will be ignored). Returns jobs
        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'
jobs.list_jobs_filter:
    List all detectable jobs and associated functions
        salt-run jobs.list_jobs_filter
        salt-run jobs.list_jobs_filter  filter_find_job=False
jobs.lookup_jid:
        salt-run jobs.lookup_jid
        salt-run jobs.lookup_jid  --out=highstate
jobs.print_job:
        salt-run jobs.print_job
    It can also be used to schedule jobs directly on the master, for example:
[root@master reactor]# 

1、salt-run jobs.active    　　　　　　　　　　　　 #查看所有minion当前正在运行的jobs（在所有minions上运行saltutil.running）

2、salt-run jobs.lookup_jid <jid>　　　　　　　　　#从master jobs cache中查询指定jid的运行结果

3、salt-run jobs.list_jobs   　　　　　　　　　　　  #列出当前master jobs cache中所有job