saltstack的rest接口salt-api开发使用指南

前言：

   saltsatck本身就提供了一套算完整的api，专业说法 sdk。 saltstack 的webui hahite就是用cherrypy框架和salt接口组成的。

salt-api 简单配置下

安装：

yum -y install salt-api

配置：

[root@65 ~]# tail -n 10 /etc/salt/master
#         - '*'
rest_cherrypy:
  port: 8000
  debug: True
  ssl_crt: /etc/pki/tls/certs/ca.crt
  ssl_key: /etc/pki/tls/certs/ca.key
external_auth:
  pam:
    admin:
      - .*

下面的测试用的是curl做的，线上环境调用的话，肯定不能这么搓，可以用python的urllib2 。

登录，然后获取token

curl -k https://10.10.10.65:8000/login -H "Accept: application/x-yaml"  -d username='admin'  -d password='123123'  -d eauth='pam'

原文：http://rfyiamcool.blog.51cto.com/1030776/1362979

这里是使用获取的token，查询硬盘的使用情况

curl -k https://10.10.10.65:8000 \
        -H "Accept: application/x-yaml" \
        -H "X-Auth-Token: f43a327ec50615ee0e3dc988cc7e290276ac959e" \
        -d client=local \
        -d tgt='*' \
        -d fun='status.diskusage'

调用它的模块

curl -k https://10.10.10.65:8000 \
        -H "Accept: application/x-yaml" \
        -H "X-Auth-Token: f43a327ec50615ee0e3dc988cc7e290276ac959e" \
        -d client=local \
        -d tgt='*' \
        -d fun='cmd.run' \
        -d arg="free -m"

   我这里测试了下他的性能，不是对他性能的测试，因为就算是bottle这样的web框架也能抗住500+的压力，这里测试他的是他的堵塞，我开了两个终端，都是sleep 5 ，第二个链接花费了9s，很明显是堵塞的接口。 当然，我的测试方法也很是片面，salt-api 也是有jobs的jid支持的。也可以cherrypy nginx的uwsgi配合，多开几个线程。

虽然salt-api的接口相对来说，不管是文档还是使用易度算方便，但是这东西是cherrypy写的，绝对不主流的东西，我先前搞hahite的时候，研究一段时间的cherrypy，基本的mvc和session也都过了一遍，感觉用起来还是不爽。 所以 个人觉得完全可以自己写一套自己的api，不用非要rest，在接口上把安全做好就行了。

这里讲解下，saltsatck的api，我发现群里有人迷茫了，saltstack api 是一个直接调用函数的集合罢了，salt-api是一个基于cherrypy的rest接口 ！！！

In [8]: import salt.client
In [9]: local = salt.client.LocalClient()
In [10]: local.cmd('*', 'cmd.run', ['ip a'])
Out[10]: {'66.ruifengyun.com': '1: lo:  mtu 16436 qdisc noqueue state UNKNOWN \n    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00\n    inet 127.0.0.1/8 scope host lo\n    inet6 ::1/128 scope host \n       valid_lft forever preferred_lft forever\n2: eth0:  mtu 1500 qdisc pfifo_fast state UNKNOWN qlen 1000\n    link/ether 00:0c:29:06:f2:dc brd ff:ff:ff:ff:ff:ff\n    inet 10.10.10.66/24 brd 10.10.10.255 scope global eth0\n    inet6 fe80::20c:29ff:fe06:f2dc/64 scope link \n       valid_lft forever preferred_lft forever'}

可以一次套用多个模块 ！

>>> local.cmd('*', [
        'grains.items',
        'sys.doc',
        'cmd.run',
    ],
    [
        [],
        [],
        ['uptime'],
    ])

通过saltstack的run_job可以实现任务的后台执行，扔到后面之前，会扔出一个job id ！

得到jid后，salt-run jobs.lookup_jid 直接获取数据 ！

在api里面可以用runner.low 方法：

runner.low({'fun': 'jobs.lookup_jid', 'jid': '20131219215921857715'})

就说到这里啦，大家自己玩玩吧，有问题，拿出来咱们讨论下 ~ 有更好的见解，请指出，绝对受教 ！！！