Saltstack-Salt常用模块及API

简介:

Salt提供了非常丰富的功能模块,涉及操作系统的基础功能、常用工具支持等,可以通过sys模块列出当前版本支持的模块。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
salt  '*'  sys.list_modules
781915e2:
  - acl
  - aliases
  - alternatives
  - apache
  - archive
  - artifactory
  - at
  - blockdev
  - btrfs
  - buildout
  - cloud
  - cmd
......

 

API的原理是通过调用master client模块,实例化一个LocalClient对象,再调用cmd()方法来实现的。

API实现test.ping示例:

1
2
3
4
5
>>>  import  salt.client
>>> client  =  salt.client.LocalClient()
>>> ret  =  client.cmd( '*' , 'test.ping' )
>>>  print  ret
{ '781915e2' True }       #结果以一个标准的Python字典形式的字符串返回,可以通过eval()函数转换成Python的字典类型,方便后续的业务逻辑处理


(1)Archive模块

功能:实现系统层面的压缩包调用,支持gunzip、gzip、rar、tar、unrar、unzip等。

示例:

1
2
3
4
5
6
7
8
9
10
salt  '781915e2'  cmd.run  'mkdir /opt/test'    #为被控端minion创建/opt/test目录
781915e2:
     
scp  test .txt.gz root@kurol: /opt/test     #将测试的gzip文件拷贝给被控端minion
 
salt  '781915e2'  archive.gunzip  /opt/test/test .txt.gz     #解压被控端/opt/test/test.txt.gz文件
781915e2:
     
salt  '781915e2'  archive. gzip  /opt/test/test .txt      #压缩
781915e2:

API调用:

1
2
3
4
>>>  import  salt.client
>>> client  =  salt.client.LocalClient()
>>> client.cmd( '*' , 'archive.gunzip' ,[ '/opt/test/test.txt.gz' ])
{ '781915e2' : []}

 

 (2)cmd模块

功能:实现远程的命令行调用执行(默认具备root操作权限,使用时需评估风险)

示例:

1
2
3
4
5
6
[root@server ~] # salt '*' cmd.run "free -m"
781915e2:
                  total       used        free      shared    buffers     cached
     Mem:           996        834        162          0        121        252
     -/+ buffers /cache :        460        536
     Swap:            0          0          0

 API调用:

1
client.cmd( '*' , 'cmd.run' ,['free  - m])

 

(3)cp模块

功能:实现远程文件、目录的复制,以及下载URL文件等操作。

示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
salt  '*'  cp .cache_local_file  /etc/hosts      #将指定被控主机的/etc/hosts文件复制到被控主机本地的salt cache目录(/var/cache/salt/minion/localfiles)
781915e2:
  /var/cache/salt/minion/localfiles/etc/hosts
  
salt  '*'  cp .get_dir salt: //path/to/dir/  /minion/dest     #将主服务器file_roots指定位置下的目录复制到被控主机,salt:// 第一个‘/’为 配置文件base指定的根,第二个为路径分割符
781915e2:
     
salt  '*'  cp .get_file salt: //path/to/file  /minion/dest    #将主服务器file_roots指定位置下的文件复制到被控主机
781915e2:
     
salt  '*'  cp .get_url http: //www .baidu.com  /tmp/index .html      #下载URL内容到被控主机指定位置
781915e2:
     /tmp/index .html

API调用:

1
client.cmd( '*' , 'cp.get_file' ,[ 'salt://path/to/file ' , ' /minion/dest' ])

 

(4)cron模块

功能:实现被控主机的crontab操作

示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
salt  '*'  cron.raw_cron root      #查看指定被控主机、root用户的crontab清单
781915e2:
     #secu-tcs-agent monitor, install at Sat Mar 18 15:55:40 CST 2017
     * * * * * /usr/local/sa/agent/secu-tcs-agent-mon-safe.sh /usr/local/sa/agent > /dev/null 2>&1
     */1 * * * * /usr/local/qcloud/stargate/admin/start.sh > /dev/null 2>&1 &
     */20 * * * * /usr/sbin/ntpdate ntpupdate.tencentyun.com >/dev/null &
     30 2 * * * /www/server/panel/certbot-auto renew >> /www/server/panel/logs/certbot.log
     
salt  '*'  cron.set_job root  '*'  '*'  '*'  '*'  1 /usr/local/weekly   #为指定的被控主机、root用户添加/usr/local/weekly任务作业
781915e2:
     new
 
salt  '789880e2'  cron.rm_job root /usr/local/weekly      #删除指定的被控主机、root用户crontab的/usr/local/weekly任务作业
781915e2:
     removed

API调用:

1
client.cmd( '*' , 'cron.set_job,[' root ',' * ',' * ',' * ',' * ',' * ',' / usr / echo'])

 

 

 

 

       本文转自谢育政 51CTO博客,原文链接:http://blog.51cto.com/kurolz/1934033,如需转载请自行联系原作者

 

 

 

 

 


相关文章
|
7天前
|
存储 API
使用Webpack的module.hot API来定义模块的热替换
使用Webpack的`module.hot` API实现模块热替换,简单示例展示如何在`myModule`变化时执行回调。`module.hot.accept`接收模块路径和回调函数,当模块或其依赖变更时触发回调,用于执行更新逻辑。可通过`module.hot.data`保存和恢复状态以实现热替换时保持应用程序的状态。
|
7月前
|
Java API Spring
【异常】Feign 调用api模块直接进入fallback的问题解决办法
【异常】Feign 调用api模块直接进入fallback的问题解决办法
111 0
|
7天前
|
前端开发 JavaScript API
AngularJS 的 API:模块 API、指令 API、服务 API、过滤器 API、路由 API
AngularJS 的 API:模块 API、指令 API、服务 API、过滤器 API、路由 API
49 0
红外热成像仪测温模块 API 移植-I2C 和关键接口函数
API 说明文件里面有官方的移植指导,但我觉得可以把重点放在与 MLX90640 具体操作有关的几个函数上,而与标准 I2C 相关的函数和文件结构还是按照自己习惯的套路实现。这样更符合我们开发人员的可控性的习惯。
红外热成像仪测温模块 API 移植-I2C 和关键接口函数
|
存储 JSON 应用服务中间件
手把手教你Nginx常用模块详解之ngx_http_api_module(三)(下)
手把手教你Nginx常用模块详解之ngx_http_api_module(三)
343 0
|
缓存 自然语言处理 应用服务中间件
手把手教你Nginx常用模块详解之ngx_http_api_module(三)(上)
手把手教你Nginx常用模块详解之ngx_http_api_module(三)
701 0
|
监控 JavaScript 安全
jdk17文档中的JDK API模块介绍
jdk17文档中的JDK API模块介绍
jdk17文档中的JDK API模块介绍
|
XML 存储 安全
jdk17文档中的JAVA SE API模块介绍
jdk17文档中的JAVA SE API模块介绍,Java SE 是jdkAPI文档中的一部分
jdk17文档中的JAVA SE  API模块介绍
|
数据采集 搜索推荐 API
我做的python 中文api调用模块
可以自动调用api接口
240 1
|
API
LyScriptTools 模块类API接口手册
LyScriptTools工具包是在LyScript模块基础上封装的工具包,其主要是二次封装LyScript插件实现的一些新功能,或者将特定功能组件拆分开形成的独立模块,此类模块可实现更加精细化的功能控制,在实际开发中推荐使用此种方式调用。
163 0
LyScriptTools 模块类API接口手册

热门文章

最新文章