Python API 2.0

python api 2.0
从2.0的事情开始更复杂一些，但是你会得到更多离散和可读的类：

#!/usr/bin/env Python

import JSON
from collections import namedtuple
from ansible.parsing.dataloader import DataLoader
from ansible.vars import VariableManager
from ansible.inventory import Inventory
from ansible.playbook.play import Play
from ansible.executor.task_queue_manager import TaskQueueManager
from ansible.plugins.callback import CallbackBase

class ResultCallback(CallbackBase):
"""用于执行结果的示例回调插件

 如果要将所有结果收集到单个对象进行处理
 执行的结束，看看利用``json``回调插件
 或编写自己的自定义回调插件
"""
def v2_runner_on_ok(self, result, **kwargs):
    """打印结果的json表示

     该方法可以将结果存储在实例属性中以供以后检索
    """
    host = result._host
    print json.dumps({host.name: result._result}, indent=4)

Options = namedtuple('Options', ['connection', 'module_path', 'forks', 'become', 'become_method', 'become_user', 'check'])

variable_manager = VariableManager()
loader = DataLoader()
options = Options(connection='local', module_path='/path/to/mymodules', forks=100, become=None, become_method=None, become_user=None, check=False)
passWords = dict(vault_pass='secret')

＃实例化我们的ResultCallback来处理结果进来时
results_callback = ResultCallback()

＃创建库存并传递给var manager
inventory = Inventory(loader=loader, variable_manager=variable_manager, host_list='localhost')
variable_manager.set_inventory(inventory)

play_source = dict(
name = "Ansible Play",
hosts = 'localhost',
gather_facts = 'no',
tasks = [
dict(action=dict(module='shell', args='ls'), reGISter='shell_out'),
dict(action=dict(module='debug', args=dict(msg='{{shell_out.stdout}}')))
]
)
play = Play().load(play_source, variable_manager=variable_manager, loader=loader)

tqm = None
try:
tqm = TaskQueueManager(
inventory=inventory,
variable_manager=variable_manager,
loader=loader,
options=options,
passwords=passwords,
stdout_callback=results_callback, # Use our custom callback instead of the default callback plugin
)
result = tqm.run(play)
finally:
if tqm is not None:
tqm.cleanup()
Python API pre 2.0
这很简单：

import ansible.runner

runner = ansible.runner.Runner(
module_name='ping',
module_args='',
pattern='WEB*',
forks=10
)
datastructure = runner.run()
运行方法返回每个主机的结果，根据是否可以联系来分组。 返回类型是模块特定的，如关于模块文档中所示：

复制代码
{
"dark" : {
"web1.example.com" : "failure message"
},
"contacted" : {
"web2.example.com" : 1
}
}
复制代码
一个模块可以返回任何类型的JSON数据，所以Ansible可以作为框架来快速构建强大的应用程序和脚本。

详细API示例

以下脚本打印出所有主机的正常运行时间信息：

#!/usr/bin/python

import ansible.runner
import sys

results = ansible.runner.Runner(
pattern='*', forks=10,
module_name='command', module_args='/usr/bin/uptime',
).run()

if results is None:
print "No hosts found"
sys.exit(1)

print "UP ***"
for (hostname, result) in results['contacted'].items():
if not 'failed' in result:
print "%s >>> %s" % (hostname, result['stdout'])

print "FAILED ***"
for (hostname, result) in results['contacted'].items():
if 'failed' in result:
print "%s >>> %s" % (hostname, result['msg'])

print "DOWN *****"
for (hostname, result) in results['dark'].items():
print "%s >>> %s" % (hostname, result)
高级程序员也可能希望将源读取到ansible本身，因为它使用API（具有所有可用选项）来实现可执行的命令行工具（lib / ansible / cli /）。

Http://docs.ansible.com/ansible/latest/dev_guide/developing_api.html