saltstack 的 api

最新推荐文章于 2022-05-19 22:53:41 发布
最新推荐文章于 2022-05-19 22:53:41 发布
阅读量236 收藏
点赞数
文章标签： 运维 python 网络
原文链接：https://my.oschina.net/u/3314358/blog/1841992
版权

2019独角兽企业重金招聘Python工程师标准>>> hot3.png

上篇记录了 saltstack 的安装与配置和简单的使用，但是你会发现基本所有操作，都需要登录到 master机上进行命令行操作，虽然命令行才是最强大的，但是对于新手和入门时的学习使用和管理非常不友好。
然而 salt 已经为我们想到了，下面将为 saltstack 配置一个 web 界面，通过 web 界面来实现一些管理功能，由于 saltstack 官方本身时没有 web 界面的。

 

一、环境准备

系统为 centos7.2，python 版本为2.7

安装 salt-api

[root@V1 ~]# yum install -y salt-api


二、具体配置

添加用户，用户 api 认证

[root@V1 ~]# useradd -M Amos

创建master的配置文件目录

[root@V1 ~]# mkdir /etc/salt/master.d

添加 api 的配置文件,同来配置 api 接口服务的端口和一些设定

[root@V1 ~]# cat /etc/salt/master.d/api.conf
rest_cherrypy:
  port: 8000
  debug: True
  #ssl_crt: /etc/pki/tls/certs/localhost.crt
  #ssl_key: /etc/pki/tls/certs/localhost.key
  disable_ssl: true

添加 eauth.conf 认证配置文件

[root@V1 ~]# cat /etc/salt/master.d/eauth.conf 
external_auth:
  pam:
    saltapi:
      - .*
      - '@wheel'
      - '@runner'

Amos 登陆用户名，下面为权限设置，可以根据用户自定义不同的权限。上述为全部权限。

启动 salt-api 服务，并查看运行状态

[root@V1 ~]# systemctl start salt-api
[root@V1 ~]# 
[root@V1 ~]# systemctl status salt-api
● salt-api.service - The Salt API
   Loaded: loaded (/usr/lib/systemd/system/salt-api.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2018-07-03 13:39:00 CST; 4s ago
 Main PID: 1688 (salt-api)
    Tasks: 107
   Memory: 32.9M
   CGroup: /system.slice/salt-api.service
           ├─1688 /usr/bin/python /usr/bin/salt-api
           └─1695 /usr/bin/python /usr/bin/salt-api

Jul 03 13:39:00 PaulV1 salt-api[1688]: [03/Jul/2018:13:39:00] ENGINE Listening for SIGTERM.
Jul 03 13:39:00 PaulV1 salt-api[1688]: [03/Jul/2018:13:39:00] ENGINE Listening for SIGUSR1.
Jul 03 13:39:00 PaulV1 salt-api[1688]: [03/Jul/2018:13:39:00] ENGINE Bus STARTING
Jul 03 13:39:00 PaulV1 salt-api[1688]: [WARNING ] CherryPy Checker:
Jul 03 13:39:00 PaulV1 salt-api[1688]: 'log_file' is obsolete. Use 'log.error_file' instead.
Jul 03 13:39:00 PaulV1 salt-api[1688]: section: [saltopts]
Jul 03 13:39:00 PaulV1 salt-api[1688]: [03/Jul/2018:13:39:00] ENGINE Started monitor threa...r'.
Jul 03 13:39:00 PaulV1 salt-api[1688]: [03/Jul/2018:13:39:00] ENGINE Started monitor threa...r'.
Jul 03 13:39:01 PaulV1 salt-api[1688]: [03/Jul/2018:13:39:00] ENGINE Serving on 0.0.0.0:8000
Jul 03 13:39:01 PaulV1 salt-api[1688]: [03/Jul/2018:13:39:01] ENGINE Bus STARTED
Hint: Some lines were ellipsized, use -l to show in full.

OK，到此，salt-api 服务启动，可以查看下端口，是否已经监听 8000 端口。

[root@V1 ~]# netstat -antlp|grep 8000
tcp        0      0 0.0.0.0:8000            0.0.0.0:*               LISTEN      1695/python

查看网页内容显示如下

[root@V1 ~]# curl 127.0.0.1:8000
{"clients": ["_is_master_running", "local", "local_async", "local_batch", "runner", "runner_async", "ssh", "ssh_async", "wheel", "wheel_async"], "return": "Welcome"}

然后建立用户进行 pam 认证登录。

useradd -m saltapi                      # 建立账户
echo saltapi |passwd --stdin saltapi    # 更新密码

尝试通过 pam 与 minion 进行连接

[root@V1 ~]# salt -a pam '*' test.ping
[DEBUG   ] Configuration file path: /root/.saltrc
[WARNING ] Insecure logging configuration detected! Sensitive data may be logged.
[DEBUG   ] Reading configuration from /etc/salt/master
[DEBUG   ] Including configuration from '/etc/salt/./master.d/api.conf'
[DEBUG   ] Reading configuration from /etc/salt/./master.d/api.conf
[DEBUG   ] Including configuration from '/etc/salt/./master.d/eauth.conf'
[DEBUG   ] Reading configuration from /etc/salt/./master.d/eauth.conf
[DEBUG   ] Using cached minion ID from /etc/salt/minion_id: PaulV1
[DEBUG   ] Reading configuration from /root/.saltrc
[DEBUG   ] MasterEvent PUB socket URI: /var/run/salt/master/master_event_pub.ipc
[DEBUG   ] MasterEvent PULL socket URI: /var/run/salt/master/master_event_pull.ipc
[DEBUG   ] LazyLoaded pam.auth
username: saltapi
password: 
[DEBUG   ] Initializing new AsyncZeroMQReqChannel for (u'/etc/salt/pki/master', u'PaulV1_master', u'tcp://xxx.xxx.xxx.xxx:4506', u'clear')
[DEBUG   ] Connecting the Minion to the Master URI (for the return server): tcp://xxx.xxx.xxx.xxx:4506
[DEBUG   ] Trying to connect to: tcp://xxx.xxx.xxx.xxx:4506
[DEBUG   ] Initializing new IPCClient for path: /var/run/salt/master/master_event_pub.ipc
[DEBUG   ] LazyLoaded local_cache.get_load
[DEBUG   ] Reading minion list from /var/cache/salt/master/jobs/e9/8204414907fdfdbca4b1975501eb10ae6204a34234d5ab7acb22ae0024c169/.minions.p
[DEBUG   ] get_iter_returns for jid 20180705114214068068 sent to set(['master', 'client-zyy']) will timeout at 11:42:19.082920
[DEBUG   ] jid 20180705114214068068 return from client-zyy
[DEBUG   ] return event: {u'client-zyy': {u'jid': u'20180705114214068068', u'retcode': 0, u'ret': True}}
[DEBUG   ] LazyLoaded nested.output
client-zyy:
    True
[DEBUG   ] jid 20180705114214068068 return from master
[DEBUG   ] return event: {u'master': {u'jid': u'20180705114214068068', u'retcode': 0, u'ret': True}}
[DEBUG   ] LazyLoaded nested.output
master:
    True
[DEBUG   ] jid 20180705114214068068 found all minions set([u'master', u'client-zyy'])

从信息中可以看出是成功的，这里因为设置了 debug 模式，所以展现了很多信息，如果出现认证失败的话，一般为401，可以参照 saltstack获取token时报错401 排除问题。

 

三、获取 token 和执行 module

3.1 获取 token

Headers 里面是用来存放 headers 的信息的 Body 里面来存放数据的，常用的 data 数据就是 x-www-form-url encoded form-data 是用来存放页面 form 表单数据的 只要 salt-api 不重启，token 就不会过期，salt-api 重启以后，token 就会过期。

1）使用 curl

[root@V1 ~]# curl -X POST -k http://127.0.0.1:8000/login -d username='saltapi' -d password='saltapi' -d eauth='pam' |python -mjson.tool 
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   240  100   197  100    43   6055   1321 --:--:-- --:--:-- --:--:--  6156
{
    "return": [
        {
            "eauth": "pam",
            "expire": 1530881436.314184,
            "perms": [
                ".*",
                "@wheel",
                "@runner"
            ],
            "start": 1530838236.314184,
            "token": "70b01a990ad722cea357ee73f847ad5edd15762c",
            "user": "saltapi"
        }
    ]
}

2）使用 postman

a. json 格式

bd2b096a44edf090f84bf4fd7be36a8ee82.jpg

b. yaml 格式

在 a 点获取到的 json 格式的基础上，在 headers 添加如下内容，即可获取到 yaml 格式

a03a0adc1f65c5c0032b945ee496abc7458.jpg

3.2 配置证书

依赖关系：CherryPy Python模块

值得注意的是 CherryPy 版本 （3.2.5-3.7.x） 有一个已知的 SSL 跟踪。 请使用 3.2.3 版本或最新的版本。

1）安装 PyOpenSSL

[root@V1 ~]# pip install PyOpenSSL
Looking in indexes: http://mirrors.aliyun.com/pypi/simple/
Requirement already satisfied: PyOpenSSL in /usr/lib64/python2.7/site-packages (18.0.0)
Requirement already satisfied: cryptography>=2.2.1 in /usr/lib64/python2.7/site-packages (from PyOpenSSL) (2.2.2)
Requirement already satisfied: six>=1.5.2 in /usr/lib/python2.7/site-packages (from PyOpenSSL) (1.11.0)
Requirement already satisfied: idna>=2.1 in /usr/lib/python2.7/site-packages (from cryptography>=2.2.1->PyOpenSSL) (2.6)
Requirement already satisfied: cffi>=1.7; platform_python_implementation != "PyPy" in /usr/lib64/python2.7/site-packages (from cryptography>=2.2.1->PyOpenSSL) (1.11.5)
Requirement already satisfied: enum34; python_version < "3" in /usr/lib/python2.7/site-packages (from cryptography>=2.2.1->PyOpenSSL) (1.1.6)
Requirement already satisfied: asn1crypto>=0.21.0 in /usr/lib/python2.7/site-packages (from cryptography>=2.2.1->PyOpenSSL) (0.24.0)
Requirement already satisfied: ipaddress; python_version < "3" in /usr/lib/python2.7/site-packages (from cryptography>=2.2.1->PyOpenSSL) (1.0.16)
Requirement already satisfied: pycparser in /usr/lib/python2.7/site-packages (from cffi>=1.7; platform_python_implementation != "PyPy"->cryptography>=2.2.1->PyOpenSSL) (2.18)

上述显示要求已经满足。

2）更新 cherrypy

[root@V1 salt]# pip install --upgrade cherrypy
Looking in indexes: http://mirrors.aliyun.com/pypi/simple/
Collecting cherrypy
  Downloading http://mirrors.aliyun.com/pypi/packages/2b/ea/1726f07c12a8e21d9e776fbb860a53cca689504900fffc0d09c985c6c854/CherryPy-16.0.2-py2.py3-none-any.whl (421kB)
    100% |████████████████████████████████| 430kB 2.1MB/s 
Collecting portend>=2.1.1 (from cherrypy)
  Downloading http://mirrors.aliyun.com/pypi/packages/81/43/21afd5914b74d4271184ee76f4093b45aa6a580dc6627d72dfc33664c6ac/portend-2.3-py2.py3-none-any.whl
Collecting six>=1.11.0 (from cherrypy)
  Downloading http://mirrors.aliyun.com/pypi/packages/67/4b/141a581104b1f6397bfa78ac9d43d8ad29a7ca43ea90a2d863fe3056e86a/six-1.11.0-py2.py3-none-any.whl
Collecting cheroot>=6.2.4 (from cherrypy)
  Downloading http://mirrors.aliyun.com/pypi/packages/89/18/6e88f695e96eb9c69809bf3c01b5594ac8e6dc2ef64b9c4275a1943fb247/cheroot-6.3.2.post0-py2.py3-none-any.whl (67kB)
    100% |████████████████████████████████| 71kB 3.0MB/s 
Collecting tempora>=1.8 (from portend>=2.1.1->cherrypy)
  Downloading http://mirrors.aliyun.com/pypi/packages/05/1e/7ebc487798b6762438a79eabdc90d62677efc38258dcbacf409d2721f0a4/tempora-1.12-py2.py3-none-any.whl
Collecting backports.functools-lru-cache (from cheroot>=6.2.4->cherrypy)
  Downloading http://mirrors.aliyun.com/pypi/packages/03/8e/2424c0e65c4a066e28f539364deee49b6451f8fcd4f718fefa50cc3dcf48/backports.functools_lru_cache-1.5-py2.py3-none-any.whl
Collecting more-itertools>=2.6 (from cheroot>=6.2.4->cherrypy)
  Downloading http://mirrors.aliyun.com/pypi/packages/9e/92/d05d8679c3bcaa263169aa47de660080df36d35697855515745657c1ba78/more_itertools-4.2.0-py2-none-any.whl (45kB)
    100% |████████████████████████████████| 51kB 46.0MB/s 
Collecting pytz (from tempora>=1.8->portend>=2.1.1->cherrypy)
  Downloading http://mirrors.aliyun.com/pypi/packages/30/4e/27c34b62430286c6d59177a0842ed90dc789ce5d1ed740887653b898779a/pytz-2018.5-py2.py3-none-any.whl (510kB)
    100% |████████████████████████████████| 512kB 58.1MB/s 
Installing collected packages: six, pytz, tempora, portend, backports.functools-lru-cache, more-itertools, cheroot, cherrypy
  Found existing installation: six 1.9.0
    Uninstalling six-1.9.0:
      Successfully uninstalled six-1.9.0
  Found existing installation: CherryPy 3.6.0
    Uninstalling CherryPy-3.6.0:
      Successfully uninstalled CherryPy-3.6.0
Successfully installed backports.functools-lru-cache-1.5 cheroot-6.3.2.post0 cherrypy-16.0.2 more-itertools-4.2.0 portend-2.3 pytz-2018.5 six-1.11.0 tempora-1.12

3）生成证书新增配置

使用 create_self_signed_cert（）执行函数生成自签名证书。

[root@V1 salt]# salt-call tls.create_self_signed_cert
local:
    Created Private Key: "/etc/pki/tls/certs/localhost.key." Created Certificate: "/etc/pki/tls/certs/localhost.crt."

新增配置

[root@V1 ~]# cat /etc/salt/master.d/api.conf 
rest_cherrypy:
  port: 8000
  ssl_crt: /etc/pki/tls/certs/localhost.crt
  ssl_key: /etc/pki/tls/certs/localhost.key

4）重启服务

[root@V1 salt]# systemctl restart salt-master
[root@V1 salt]# systemctl restart salt-api

5）使用 https 登录

[root@V1 ~]# curl -X POST -k https://127.0.0.1:8000/login -d username='saltapi' -d password='saltapi' -d eauth='pam' |python -mjson.tool
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   240  100   197  100    43   1632    356 --:--:-- --:--:-- --:--:--  1628
{
    "return": [
        {
            "eauth": "pam",
            "expire": 1530887446.957553,
            "perms": [
                ".*",
                "@wheel",
                "@runner"
            ],
            "start": 1530844246.957552,
            "token": "64fe59768432d62e5a5cd1601f70815ace1b72d3",
            "user": "saltapi"
        }
    ]
}

3.3 获取执行 module

在成功登录并且获取到 token 之后，我们就可以通过 token 对 minion 端执行一些操作。

首先，我们将 token 值放到 headers

5c1c3aaed87a8505f08b7b6b04ea86c324a.jpg

然后在 body 中填写需要传入的参数

32b2739d357fddce081d709af3582de41bc.jpg

client：对应 local 本地

tgt：表示具体 minion 或分组

fun：模块或自定义函数

arg：需要操作的命令

 

 

 

 

参考资料

1. Saltstack系列3：Saltstack常用模块及API

2. salt的api学习记录--salt命令的执行过程

3. saltstack-api使用详解

4. Salt-API入门指北

5. Salt-API安装配置及使用

6. saltstack的教程、例子、资料

7. saltstack自动化运维

8. 运维工具SaltStack简介

9.  centos7.2 saltstack配置web界面saltshaker

10. Salt-API won't listen on https?

11. REST_CHERRYPY

12. SSL not working

转载于:https://my.oschina.net/u/3314358/blog/1841992

weixin_33858249
关注
saltstack使用api接口实现推送
weixin_42446031的博客
06-19 966
我们前面讲过了saltstack的c/s，ssh等推送方式，其实我们还可以使用api推送的方式来馆及节点，下面我们就来部署一下api接口的saltstack推送 1.之前因为使用ssh关掉了minion，我们重新先开启 [root@server2 minion]# systemctl start salt-minion [root@server3 minion]# systemctl start ...
SaltStack api使用
运维相关技术闲聊，专业背锅内容媒体
01-12 163
SaltStack官方提供有REST API格式的api项目，使得salt与第三方系统集成变得更加简单。 以下操作前提是您已经安装好salt-master和salt-api服务 1、配置salt-master,开启rest_cherrypy服务 这里偷懒，没有使用ssl，所以直接禁用ssl了，线上环境建议使用ssl rest_cherrypy: port: 8181 host: 0.0.0.0 disable_ssl: True 2、配置pam验证， external_auth: pam:
Saltstack的api
weixin_30488313的博客
07-03 140
Salt-api有两种方式： 第一种是函数的形式，有人家定义好的函数，我们可以直接调用，直接写python代码调用函数或者类就可以了 第二种形式是salt-api有封装好的http协议的，我们需要启动一个服务端 安装：yum install –y salt-api 1、函数形式的api ①、加载master的配置文件 >>> import salt....
saltstack--api接口
一颗红小豆
08-14 245
[root@server1 ~]# yum install -y salt-syndic [root@server1 ~]# vim /etc/salt/master syndic_master: 172.25.25.4 [root@server1 ~]# systemctl restart master [root@server1 ~]# systemctl start salt-syndic ...
saltstack的API接口
qq_42311209的博客
06-18 336
标题
saltstack API接口实现
07-27
saltstack API接口实现 saltstack API接口实现 saltstack API接口实现
saltstack api调用实例
最新发布
02-08
SaltStack API可以通过编写代码来调用SaltStack功能，以实现自动化管理。 下面是一个SaltStack API调用的示例： import salt.client local = salt.client.LocalClient() ret = local.cmd('*', 'test.ping') ...
SaltStack中的API接口和常用模块
jay_youth的博客
08-18 2902
一.API接口 利用api接口来实现SaltStack推送，管理集群是非常方便的手段，下面我们尝试利用API来实现Salt的功能…. 1.在server1上安装salt api yum insatll -y salt-api 2.配置自签名证书 cd /etc/pki/tls/cd private/ openssl genrsa 1024 openssl genrsa 102...
Go-基于GO语言和Saltstack开发的WEB运维平台
08-13
- **Saltstack集成**：通过Go语言调用Saltstack的API或编写插件，将运维功能集成到Web平台上，实现图形化的运维操作。 综上所述，这个“Go-基于GO语言和Saltstack开发的WEB运维平台”项目，充分利用了Go语言的高...
【自动化运维】saltstack的api配置
Daly的博客
07-18 304
SaltStack$api ()
saltstack中的api接口
qwqq233的博客
06-18 454
利用api接口来实现SaltStack推送，管理集群是非常方便的手段，下面我们尝试利用API来实现Salt的功能 如果server2和server3没有开启salt-minion服务，请先开启 1.在server1安装salt-api服务 [root@server1 _modules]# yum install -y salt-api 2.配置签名证书 [root@server1 private...
saltstack API的使用
lyzkks的博客
07-26 787
saltstack自定义模块 saltstack模块是指被salt调用的python函数。默认路径在/srv/salt/_modules。调用方法是： salt &quot;*&quot; 文件名.函数名 支持python和Cython，python以.py结尾，Cython以.pyx结尾。 同步到minion的方法： 1、salt &quot;*&quot; state.apply 2、salt &quot;...
云计算自动化运维——SaltStack接口salt-api
CapejasmineY的博客
12-18 815
文章目录一、salt-api简介二、salt-api安装配置三、总结 一、salt-api简介 官方文档 SaltStack官方提供有REST API格式的salt-api项目，将使salt与第三方系统集成变得更加简单。 直接启动salt-api就可以通过http协议进行调用。 二、salt-api安装配置 实验： 在salt-master端： 1、安装salt-api yum install ...
saltstack之salt-api接口
qq_39255259的博客
05-19 942
一：salt-mater端需要下载的组件：salt-api,salt-minion(能够执行salt-call) yum install salt-api salt-minion -y pip需要下载PyOpenssL pip install PyOpenssL 二：生成证书 salt-call --local tls.create_self_signed_cert 进入存放证书的目录中查看（后面需要用到lcoalhost.crt和localhost.key） 三：创建salta
SaltSack自动化运维（11）——SaltStack中的API接口
weixin_21583810的博客
06-10 224
文章目录1.API接口(salt-api介绍)2.具体的实现过程如下 1.API接口(salt-api介绍) 利用api接口来实现SaltStack推送，管理集群是非常方便的手段 下面我们尝试利用API来实现Salt的功能 saltsatck本身就提供了一套算完整的api，使用 CherryPy 来实现 restful 的 api，供外部的程序调用 2.具体的实现过程如下 （1）在master节点salt-api安装 salt-api需要安装，然后进行一些配置才可以正常使用 yum安装，需要的依赖包cher
SaltSack自动化运维（13）——SaltStack中的API接口
qq_42024433的博客
06-09 252
1.API接口(salt-api介绍) 利用api接口来实现SaltStack推送，管理集群是非常方便的手段 下面我们尝试利用API来实现Salt的功能 saltsatck本身就提供了一套算完整的api，使用 CherryPy 来实现 restful 的 api，供外部的程序调用 2.具体的实现过程如下 （1）在master节点salt-api安装 salt-api需要安装，然后进行一些配置才可以正常使用 yum安装，需要的依赖包cherry也会被补全装上。 （2）生成一个密钥文件 （3）利用密钥成自签
saltstack之api的使用
windowsworld的博客
08-14 199
api的使用 1.安装salt-api [root@server1 ~]# yum install -y salt-api##安装api 2.生成证书和秘钥 [root@server1 ~]# cd /etc/pki/tls/private/##生成证书和私钥 [root@server1 private]# openssl genrsa 2048 > localhost.key [root...
SaltStack自动化运维
dsd的博客
06-15 615
Table of Contents 1. SaltStack基础知识和架构解析 1.1 SaltStack简介 1.2 SaltStack通讯机制 1.3 ZeroMQ 1.4 传统运维与自动化运维区别 1.4.1 传统运维 1.4.2 自动化运维 1.5 SaltStack组件 1.6 Salt具体步骤 1.7 SaltStack工具的软件依赖 2. 环境安装及部署 2.1实验环境 2.2 SaltStack的安装与部署 3. yaml语法 3.1 yaml简介 3.2 .
企业实战--saltstack自动化运维（salt-api 简介及配置）
chitung_hsu的博客
06-12 217
一、salt-api简介 SaltStack 官方提供有REST API格式的 salt-api 项目，将使Salt与第三方系统集成变得尤为简单。 官方提供了三种api模块: rest_cherrypy rest_tornado rest_wsgi 二、salt-api配置及使用 安装salt-api： [root@server1 ~]# yum install salt-api -y 生成证书： [root@server1 ~]# cd /etc/pki/tls/private [root@serve
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值