• 欢迎访问蜷缩的蜗牛博客 蜷缩的蜗牛
  • 微信搜索: 蜷缩的蜗牛 | 联系站长 kbsonlong@qq.com
  • 如果您觉得本站非常有看点,那么赶紧使用Ctrl+D 收藏吧

Saltstack常用模块及API

Saltstack 蜷缩的蜗牛 2年前 (2017-02-22) 17次浏览 已收录 0个评论
salt '*' sys.list_modules   #列出当前版本支持的模块

API 原理是通过调用 master client 模块,实例化一个 LocalClient 对象,再调用 cmd()方法来实现的。
以下 API 实现 test.ping 的示例:(其他 API 调用只需要改变 cmd 即可)

 

import salt.client

client = salt.client.LocalClient()

ret = client.cmd('*','test.ping)    
#cmd 内格式:'<操作目标>','<模块>','[参数]'。例:'*','cmd.run',['df -h']

print ret

 

常用模块

Archive 模块

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

示例:

#采用 gunzip 解压 sourcefile.txt.gz 包
salt '*' archive.gunzip sourcefile.txt.gz

#采用 gzip 压缩 sourcefile.txt 文件 salt '*' archive.gzip sourcefile.txt

API 调用:

client.cmd('*','archive.gunzip',['sourcefile.txt.gz'])
cmd 模块

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

示例:

 

#获取所欲被控主机的内存使用情况
salt '*' cmd.run 'free -m'

#在 wx 主机上运行 test.py 脚本,其中 script/test.py 存放在 file_roots 指定的目录(默认是在/srv/salt,自定义在/etc/salt/master 文件中定义), #该命令会做 2 个动作:首先同步 test.py 到 minion 的 cache 目录;起床运行该脚本 salt 'wx' cmd.script salt://script/test.py

 

API 调用:

client.cmd('*','cmd.run',['free -m'])
cp 模块

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

示例:

 

#将被控主机的/etc/hosts 文件复制到被控主机本地的 salt cache 目录(/var/cache/salt/minion/localfiles/)
salt '*' cp.cache_local_file /etc/hosts

#将主控端 file_roots 指定位置下的目录复制到被控主机/minion/目录下 salt '*' cp.get_dir salt://script/ /minion/
#将主控端 file_roots 指定位置下的文件复制到被控主机/minion/test.py 文件(file 为文件名) salt '*' cp.get_dir salt://script/test.py /minion/test.py
#下载 URL 内容到被控主机指定位置(/tmp/index.html) salt '*' cp.get_url http://www.slashdot.ort /tmp/index.html

 

API 调用:

client.cmd('*','cp.get_file',['salt://script/test.py','/minion/test.py'])
cron 模块

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

示例:

 

#查看指定被控主机、root 用户的 crontab 操作
salt 'wx' cron.raw_cron root
#为指定被控主机、root 用户添加/usr/local/weekly 任务 zuoye salt 'wx' cron.set_job root '*' '*' '*' '*' 1 /usr/local/weekly
#删除指定被控主机、root 用户 crontab 的/usr/local/weekly 任务 zuoye salt 'wx' cron.rm_job root /usr/local/weekly

 

API 调用:

client.cmd('wx','cron.set_job',['root','*','*','*','*',1,'/usr/local/weekly'])
dnsutil 模块

功能:实现被控主机通用 DNS 操作

示例:

#添加指定被控主机 hosts 的主机配置项
salt 'wx' dnsutil.hosts_append /etc/hosts 127.0.0.1 adl.yuk.com,ad2.yuk.com
#删除指定被控主机的 hosts 的主机配置项 salt 'wx' dnsutil.hosts_remove /etc/hosts ad1.yuk.com

API 调用:

clietn.cmd('wx','dnsutil.hosts_append',['/etc/hosts','127.0.0.1','ad1.yuk.com','ad2.yuk.com'])
file 模块

功能:被控主机常见的文件操作,包括文件读写、权限、查找、校验

示例:

 

#校验所有被控主机/etc/fstab 文件的 md5 值是否为 xxxxxxxxxxxxx,一致则返回 True 值
salt '*' file.check_hash /etc/fstab md5=xxxxxxxxxxxxxxxxxxxxx

#校验所有被控主机文件的加密信息,支持 md5、sha1、sha224、shs256、sha384、sha512 加密算法
salt '*' file.get_sum /etc/passwd md5

#修改所有被控主机/etc/passwd 文件的属组、用户权限、等价于 chown root:root /etc/passwd
salt '*' file.chown /etc/passwd root root

#复制所有被控主机/path/to/src 文件到本地的/path/to/dst 文件
salt '*' file.copy /path/to/src /path/to/dst

#检查所有被控主机/etc 目录是否存在,存在则返回 True,检查文件是否存在使用 file.file_exists 方法
salt '*' file.directory_exists /etc

#获取所有被控主机/etc/passwd 的 stats 信息
salt '*' file.stats /etc/passwd

#获取所有被控主机/etc/passwd 的权限 mode,如 755,644
salt '*' file.get_mode /etc/passwd

#修改所有被控主机/etc/passwd 的权限 mode 为 0644
salt '*' file.set_mode /etc/passwd 0644

#在所有被控主机创建/opt/test 目录
salt '*' file.mkdir /opt/test

#将所有被控主机/etc/httpd/httpd.conf 文件的 LogLevel 参数的 warn 值修改为 info
salt '*' file.sed /etc/httpd/httpd.conf 'LogLevel warn' 'LogLevel info'

#给所有被控主机的/tmp/test/test.conf 文件追加内容‘maxclient 100’
salt '*' file.append /tmp/test/test.conf 'maxclient 100'

#删除所有被控主机的/tmp/foo 文件
salt '*' file.remove /tmp/foo

 

API 调用:

client.cmd('*','file.remove',['/tmp/foo'])
iptables 模块

功能:被控主机的 iptables 支持

示例:

 

#在所有被控主机端追加(append)、插入(insert)iptables 规则,其中 INPUT 为输入链
salt '*' iptables.append filter INPUT rule='-m state --state RELATED,ESTABLISHED -j ACCEPT'
salt '*' iptables.insert filter INPUT position=3 rule='-m state --state RELATED,ESTABLISHED -j ACCEPT'

#在所有被控主机删除指定链编号为 3(position=3)或指定存在的规则
salt '*' iptalbes.delete filter INPUT position=3
salt '*' iptables.delete filter INPUT rule='-m state --state RELATEC,ESTABLISHED -j ACCEPT'

#保存所有被控主机端主机规则到本地硬盘(/etc/sysconfig/iptables)
salt '*' iptables.save /etc/sysconfig/iptables

 

API 调用:

client.cmd('*','iptables.append',['filter','INPUT','rule=\'-p tcp --sport 80 -j ACCEPT\''])
network 模块

功能:返回被控主机的网络信息

示例:

 

#在指定被控主机获取 dig、ping、traceroute 目录域名信息
salt 'wx' network.dig www.qq.com
salt 'wx' network.ping www.qq.com
salt 'wx' network.traceroute www.qq.com

#获取指定被控主机的 mac 地址
salt 'wx' network.hwaddr eth0

#检测指定被控主机是否属于 10.0.0.0/16 子网范围,属于则返回 True
salt 'wx' network.in_subnet 10.0.0.0/16

#获取指定被控主机的网卡配置信息
salt 'wx' network.interfaces

#获取指定被控主机的 IP 地址配置信息
salt 'wx' network.ip_addrs

#获取指定被控主机的子网信息
salt 'wx' network.subnets

 

API 调用:

client.cmd('wx','network.ip_addrs')
pkg 包管理模块

功能:被控主机程序包管理,如:yum、apt-getdegn

示例:

 

#为所有被控主机安装 PHP 环境,根据不同系统发行版调用不同安装工具进行部署,如 redhat 平台的 yum,等价于 yum -y install php
salt '*' pkg.install php

#卸载所有被控主机的 PHP 环境
salt '*' pkg.remove php

#升级所有被控主机的软件包
salt '*' pkg.upgrade

 

API 调用:

client.cmd('*','pkg.remove',['php'])
service 服务模块

功能:被控主机程序包服务管理

示例:

 

#开启(enable)、禁用(disable)nginx 开机自启动脚本
salt '*' service.enable nginx
salt '*' service.disable nginx

#针对 nginx 服务的 reload、restart、start、stop、status 操作
salt '*' service.reload nginx
salt '*' service.restart nginx
salt '*' service.start nginx
salt '*' service.stop nginx
salt '*' service.status nginx

 

API 调用:

client.cmd('*','service.stop',['nginx'])

蜷缩的蜗牛 , 版权所有丨如未注明 , 均为原创丨 转载请注明Saltstack 常用模块及 API
喜欢 (0)
[]
分享 (0)

您必须 登录 才能发表评论!