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，如需转载请自行联系原作者
