说明

这是一个Ansible Python Api的封装。it is so easy!

特性:

1. 自定义模块，以及Ansible内置模块
2. 自定义回调插件以及Ansible内置回调插件
3. 组织小型Ansible Play
4. 执行结果可以使用Json格式数据返回

安装

$ git clone https://github.com/idweball/Asi.git
$ cd Asi
$ python setup.py install

OR

$ pip install -U Asi

简单使用

from Asi import Api


if __name__ == "__main__":
	hosts = [
		{
			"hostname": "localhost",
			"port": 22,
			"vars": {
				"ansible_ssh_user": "root",
				"ansible_ssh_pass": "p@ssw0rd"
			}
		},
		{
			"hostname": "192.168.152.142",
			"port": 22,
			"vars": {
				"ansible_ssh_user": "root",
				"ansible_ssh_pass": "p@ssw0rd"
			}
		}
	]

	Api().module("shell", args="ls", register='shell_out', task_name="test")\
		 .module("debug", args={"msg":"{{shell_out.stdout}}"})\
		 .run(hosts)	

获取返回数据

在run方法前面调用json方法，并且run方法中callback参数需为None，如果自己实现callback, 则需要在callback增添属性results

from Asi import Api
import json


if __name__ == "__main__":
	hosts = [
		dict(hostname="127.0.0.1", port=22)
	]

	api = Api()
	api = api.module("shell", args="ls", register="shell_out")
	api = api.module("debug", args=dict(msg="{{shell_out}}"))
	api = api.json()
	print("result")
	print(json.dumps(api.run(hosts), indent=4))

获取主机监听的TCP端口

#!/usr/bin/python

from Asi import Api
import sys


if __name__ == "__main__":
	hosts = [
		dict(hostname="127.0.0.1"),
	]
	
	api = Api()
	api = api.module("shell", args="""netstat -tunlp | awk -F "[ :]+" '/^tcp/&&/0.0.0.0/{print$5}'""")
	api = api.json()
	results = api.run(hosts)
	
	for task in results[0]["tasks"]:
		hosts = task["hosts"]
		for host, value in hosts.items():
			host_result = hosts[host]
			sys.stdout.write("hostname: {} ".format(host))
			if host_result.get("unreachable", False):
				print("error: {}".format(host_result["msg"]))
			elif host_result["rc"] == 0:
				print("listen ports: {}".format(",".join(host_result["stdout_lines"])))
			else:
				print("error: {}".format(host_result["stderr"]))

文件分发

#!/usr/bin/python

from Asi import Api


if __name__ == "__main__":
	hosts = [
		dict(hostname="127.0.0.1"),
	]
	
	api = Api()
	api = api.module("copy", args=dict(src="./hostname.py", dest="/usr/local"))
	api.run(hosts)