salt-api安装配置

salt-api安装配置

安装

#我使用的安装方式
yum -y install salt-api
#这种安装方式没有尝试;没有理解是个啥意思
[root@saltstack ~]#wget https://pypi.python.org/packages/source/p/pip/pip-1.5.6.tar.gz#md5=01026f87978932060cc86c1dc527903e --no-check-certificate
[root@saltstack ~]#tar xvfz pip-1.5.6.tar.gz
[root@saltstack ~]#cd pip-1.5.6
[root@saltstack pip-1.5.6]#python setup.py build
[root@saltstack pip-1.5.6]#python setup.py install
#安装完成后可以用pip freeze查看已安装的packages
[root@saltstack pip-1.5.6]#pip freeze
安装CherryPy,版本3.2.3

[root@saltstack ~]#pip install cherrypy==3.2.3
安装salt-api,版本0.8.3

[root@saltstack ~]#pip install salt-api==0.8.3

配置

生成自签名证书(用于ssl)

cd /etc/pki/tls/certs
make testcert
cd ../private/
#openssl rsa -in localhost.key
openssl rsa -in localhost.key -out localhost_nopass.key

输出

[root@saltstack ~]# cd /etc/pki/tls/certs
[root@saltstack certs]# make testcert
umask 77 ; \
    /usr/bin/openssl genrsa -aes128 2048 > /etc/pki/tls/private/localhost.key
Generating RSA private key, 2048 bit long modulus
...+++
..................................................................+++
e is 65537 (0x10001)
Enter pass phrase:    #键入加密短语,4到8191个字符
Verifying - Enter pass phrase:    #确认加密短语
umask 77 ; \
    /usr/bin/openssl req -utf8 -new -key /etc/pki/tls/private/localhost.key -x509 -days 365 -out /etc/pki/tls/certs/localhost.crt -set_serial 0
Enter pass phrase for /etc/pki/tls/private/localhost.key:    #再次输入相同的加密短语
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [XX]:CN    #都可以选填
State or Province Name (full name) []:Shanghai
Locality Name (eg, city) [Default City]:Shanghai
Organization Name (eg, company) [Default Company Ltd]:
Organizational Unit Name (eg, section) []:
Common Name (eg, your name or your server's hostname) []:
Email Address []:1989051805@qq.com
[root@saltstack certs]# cd ../private/
[root@saltstack private]# openssl rsa -in localhost.key -out localhost_nopass.key
Enter pass phrase for localhost.key:    #输入之前的加密短语
writing RSA key

如果遇到这样的错误
删掉文件/etc/pki/tls/private/localhost.key文件,然后再make testcert。

创建用于salt-api的用户

salt-api创建用户并设定密码,saltapi

useradd -M -s /sbin/nologin saltapi
#由于是测试,故采用了弱密码"123456",正式环境必须采用强密码,多用特殊字符
passwd 123456 

注意:
测试环境; 给saltapi 用户一个root 权限;不然执行会报错

vim /etc/sudoers
#添加如下配置
saltapi ALL=(ALL)       NOPASSWD:ALL

新增加配置文件

/etc/salt/master.d/api.conf
/etc/salt/master.d/eauth.conf

  • 配置eauth, /etc/salt/master.d/eauth.conf
external_auth:
  pam:
    saltapi:
      - .*
      - '@wheel'
      - '@runner'
      - '@jobs'
  • 配置Salt-API, /etc/salt/master.d/api.conf
rest_cherrypy:
  port: 8888
  ssl_crt: /etc/pki/tls/certs/localhost.crt
  ssl_key: /etc/pki/tls/private/localhost_nopass.key

禁用https服务;测试环境方便,上线建议调试为https

rest_cherrypy:
  port: 8888
  disable_ssl: True

启动Salt-API

#service salt-master restart
service salt-api start

#安装完成salt api 之后,需要重启salt master 服务
#否则会出现 http(401)
#Failed to authenticate! This is most likely because this user is not permitted to execute commands, but there is a small possibility that a disk error occurred (check disk/inode usage).

调试

首先在 salt-master 上直接用命检验一下这个用户的权限。

sudo salt -a pam '*' test.ping
username: saltapi
password:

Salt-API使用

登录

curl -k https://192.168.178.129:8888/login -H "Accept: application/x-yaml" -d username='saltapi' -d password='123456' -d eauth='pam'
return:
- eauth: pam
  expire: 1461628036.919152
  perms:
  - .*
  - '@wheel'
  - '@runner'
  - '@jobs'
  start: 1461584836.9191511
  token: 9c8acb70007e91a5332b96a89ef8b285d8b44956
  user: saltapi
````
其中 token 后边的串为认证成功后获取的token串,之后可以不用再次输入密码,直接使用本Token即可





<div class="se-preview-section-delimiter"></div>

### 查询Minion(dev01)的信息




<div class="se-preview-section-delimiter"></div>

```bash
curl -k https://192.168.178.129:8888/minions/dev01 -H "Accept: application/x-yaml" -H "X-Auth-Token: 9c8acb70007e91a5332b96a89ef8b285d8b44956"
return:
- dev01:
    SSDs: []
    cpu_flags:
    - fpu
    - vme
    ....

其中 X-Auth-Token 后边的串为之前Login获取到的Token串, 如果请求的URL不包含 dev01 ,则请求的为所有Minion的信息

job管理

  • 获取缓存的jobs列表
curl -k https://192.168.178.129:8888/jobs -H "Accept: application/x-yaml" -H "X-Auth-Token: 9c8acb70007e91a5332b96a89ef8b285d8b44956"
return:
- '20160425071404030151':
    Arguments: []
    Function: test.ping
    StartTime: 2016, Apr 25 07:14:04.030151
    Target: 192.168.178.129
    Target-type: glob
    User: root
    ... ...
  • 查询指定的job
curl -k https://192.168.178.129:8888/jobs/20160425195411402340 -H "Accept: application/x-yaml" -H "X-Auth-Token: 9c8acb70007e91a5332b96a89ef8b285d8b44956"
info:
- Arguments: []
  Function: grains.items
  Minions:
  - dev01
  Result:
    dev01:
      return:
        SSDs: []
        cpu_flags:
        ... ...

远程执行模块

curl -k https://192.168.178.129:8888/ -H "Accept: application/x-yaml" -H "X-Auth-Token: 9c8acb70007e91a5332b96a89ef8b285d8b44956" -d client='local' -d tgt='*' -d fun='test.ping'
return:
- dev00: true
  dev01: true
  dev02: true

运行runner

curl -k https://192.168.178.129:8888/ -H "Accept: application/x-yaml" -H "X-Auth-Token: 9c8acb70007e91a5332b96a89ef8b285d8b44956" -d client='runner' -d fun='age.status'
return:
- down: []
  up:
  - dev00
  - dev01
  - dev02

运行wheel

curl -k https://192.168.178.129:8888/ -H "Accept: application/x-yaml" -H "X-Auth-Token: 9c8acb70007e91a5332b96a89ef8b285d8b44956" -d client='wheel' -d fun='klist_all'
return:
- data:
    _stamp: '2016-04-25T12:15:14.657980'
    fun: wheel.key.list_all
    jid: '20160425201334130905'
    return:
      local:
      - master.pem
      - master.pub
      minions:
      - dev00
      - dev01
      - dev02
      minions_denied: []
      minions_pre: []
      minions_rejected: []
    success: true
    tag: salt/wheel/20160425201334130905
    user: saltapi
  tag: salt/wheel/20160425201334130905

总结

参考
http://pylixm.cc/posts/2015-12-15-Salt-api.html
http://ohmystack.com/articles/salt-5-salt-api/
http://pengyao.org/salt-api-deploy-and-use.html

作者:{微尘大海}(weichenddahai),日期:2016-6-21, email:784456305@qq.com

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值