Saltstack-API（十二）

时间：2025-04-04 14:06:25

Saltstack-API

官方文档 https://docs.saltstack.com/en/latest/ref/netapi/all/salt.netapi.rest_cherrypy.html

参数：http://salt-api.readthedocs.io/en/latest/ref/netapis/all/saltapi.netapi.rest_cherrypy.html#a-rest-api-for-salt

使用条件：1）https调用，需要生成证书  2）配置文件 3）使用PAM验证 4）启动salt-api

安装

yum install -y salt-api

实现方式

1）创建用户useradd -M -s /sbin/nologin saltapi

2）设置密码passwd saltapi

3）生成自签名证书

cd /etc/pki/tls/certs

mv localhost.crt /tmp

make testcert

Saltstack-API（十二）

cd /etc/pki/tls/private

如果上面生成证书时输入了密码，需要取消密码

openssl rsa -in localhost.key  -out salt_nopass.key

4）安装Cherrypy模块，版本3.2.6

pip install Cherrypy==3.2.6

备注：centos6、7可以使用3.2.6版本，centos5安装时不要选版本号

5）修改master配置文件

vi /etc/salt/master

default_include: master.d/*.conf

Saltstack-API（十二）

6）创建api配置文件

cd /etc/salt/master.d/

vi api.conf

rest_cherrypy:

  host: 192.168.137.11

  port: 8000

  ssl_crt: /etc/pki/tls/certs/localhost.crt

  ssl_key: /etc/pki/tls/private/salt_nopass.key

备注：如果加disable_ssl: True，可以通过http请求。

性能优化：

thread_pool: 100

socket_queue_size: 30

Saltstack-API（十二）

7）认证文件

vi eauth.conf

external_auth:

  pam:

    saltapi:

      - .*

      - '@wheel'

      - '@runner'

备注： .*  # 所有模块可执行， '@wheel'  # salt key

centos5.9上yum安装的salt，eauth.conf配置需要注意，如下配置

external_auth:

  pam:

    saltapi:

      - .*

      - '@local'

      - '@local_async'

      - '@wheel'

      - '@wheel_async'

      - '@runner'

      - '@runner_async'

8）重启master

systemctl restart salt-master.service

9）启动api

systemctl restart salt-api

10）需要修改master的配置对saltapi用户进行授权

[root@test1 ~]# vim /etc/salt/master

external_auth:

  pam:

    saltapi:

      - .*

      - '@wheel'

[root@test1 ~]# /etc/init.d/salt-master restart

Stopping salt-master daemon:                               [  OK  ]

Starting salt-master daemon:                               [  OK  ]

使用介绍

1）登录测试，使用curl请求

curl -k https://192.168.137.11:8000/login \

    -H 'Accept: application/x-yaml' \

    -d username=saltapi \

    -d password=saltapi \

    -d eauth=pam

登录成功后系统返回token，用于后续交互使用。

Saltstack-API（十二）

2）获取minion资产数据测试，节点为linux-node1.example.com主机

curl -k https://192.168.137.11:8000/minions/linux-node1.example.com \

    -H 'Accept: application/x-yaml' \

    -H 'X-Auth-Token: token内容'

3）查看所有minion存活主机

curl -k https://192.168.137.11:8000/ \

    -H 'Accept: application/x-yaml' \

    -H 'X-Auth-Token: token内容' \

    -d client='runner' \

    -d fun='manage.status'

备注：client='runner'指的是在master执行，client='local'指的是在minion执行

Saltstack-API（十二）

4）ping测试

curl -k https://192.168.137.11:8000/ \

    -H 'Accept: application/x-yaml' \

    -H 'X-Auth-Token: token内容' \

    -d client='local' \

    -d tgt='*' \

    -d fun='test.ping'

tgt表示目标，可以指定某一台minion

5）查看jobs

curl -k https://192.168.137.11:8000/jobs \

    -H 'Accept: application/x-yaml' \

    -H 'X-Auth-Token: token内容'

6）查看具体一个jobs的执行结果

curl -k https://192.168.137.11:8000/jobs/jobid \

    -H 'Accept: application/x-yaml' \

    -H 'X-Auth-Token: token内容'

相关文章