学习salt的源码2-run_job

最新推荐文章于 2024-09-01 08:42:19 发布

cgw5566

最新推荐文章于 2024-09-01 08:42:19 发布

阅读量638

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/baidu_25506889/article/details/50350541

本博客介绍了一个关键函数 `drun_job` 的使用，该函数用于异步发送命令到连接的 minions。它包括参数如目标 minions、命令、表达形式等，返回 pub_data 字典或空字典，用于跟踪 job ID 和 minions 的响应。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

def run_job(
#关键函数
self,
tgt,
fun,
arg=(),
expr_form='glob',
ret='',
timeout=None,
jid='',
kwarg=None,
**kwargs):
'''
Asynchronously send a command to connected minions
#异步执行
Prep the job directory and publish a command to any targeted minions.
#准备job字典，并推送命令给minions

:return: A dictionary of (validated) ``pub_data`` or an empty
#返回一个pub_data,或者返回一个空字典 pub_data包含job ID 和minions和客户端主机名
dictionary on failure. The ``pub_data`` contains the job ID and a
list of all minions that are expected to return data.

.. code-block:: python

>>> local.run_job('*', 'test.sleep', [300])
{'jid': '20131219215650131543', 'minions': ['jerry']}
'''
arg = salt.utils.args.condition_input(arg, kwarg)
#这里应该是整理参数吧。这个函数的说明是“Return a single arg structure for the publisher to safely use”
try:
pub_data = self.pub(
tgt,
fun,
arg,
expr_form,
ret,
jid=jid,
timeout=self._get_timeout(timeout),
**kwargs)
#这个pub也是关键函数
except SaltClientError:
# Re-raise error with specific message
raise SaltClientError(
'The salt master could not be contacted. Is master running?'
)
except Exception as general_exception:
# Convert to generic client error and pass along mesasge
raise SaltClientError(general_exception)

return self._check_pub_data(pub_data)
#返回check_pub_data。实际上是返回job id和minions的主机名