运维工具SaltStack之二常见模块及API
1.Archive模块:实现系统层面的压缩包调用,支持gzip、gunzip、rar、tar、unrar、unzip等
例子:
#salt 'minion01' archive.g zip test.txt #采用gzip压缩test.txt文件
2.cmd模块:实现远程的命令行调用执行(默认具备root操作权限)
例子:
#salt 'minion01' cmd.run 'fdisk -l' #获取被控主机硬盘信息 #salt 'minion01' cmd.script salt://script/test.py #该命令首先同步test.py到minion客户端的cache目录并运行该脚本。其中script/test.py存放在file_roots指定的目录(默认在/srv/salt(需要新建),在/etc/salt/master文件中定义)
3.cp模块:远程文件、目录的复制
例子:
#salt 'minion01' cp.get_dir salt://script/ /opt/minion/ #将Master端file_roots指定位置下(默认在/srv/salt)的目录复制到minion01主机/opt/minion/目录下
4.cron模块:minion端主机的crontab操作
例子:
# salt 'minion01' cron.set_job root '*' '*' '*' '*' 1 /home/timesyc.sh #minion01端主机root用户添加任务作业
5.dnsutil模块:Minion主机通用DNS操作
例子:
#salt 'minion01' dnsutil.hosts_append /etc/hosts 192.168.2.71 www.test.com #添加192.168.2.71 www.test.com到minion01端/etc/hosts下
6.file模块:常见的文件操作,包括文件读写、权限、查找等
例子:
#salt 'minion01' file.chown /mydata/data root root #修改minion01主机/mydata/data文件的属组、用户权限,等价于chown root:root /mydata/data #salt 'minion01' file.copy /mydata/data /home/data #minion01主机复制/mydata/data文件到本地的/home/data目录 #salt 'minion01' file.get_mode /mydata/data #获取minion01主机/mydata/data的权限mode,如:755,644 #salt '*' file.mkdir /home/test #所有Minion端主机创建/home/test #salt '*' file.set_mode /home/test 0755 #所有Minion端主机/home/test的权限mode为0755 #salt 'minion01' file.remove /home/test #删除minion01主机的/home/test文件
7.iptables模块:主机的iptables支持
例子:
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'
说明:在所有Minion主机端追加(append)、插入(insert)iptables规则,其中INPUT为输入链
salt '*' iptalbes.delete filter INPUT position=3 salt '*' iptables.delete filter INPUT rule='-m state --state RELATEC,ESTABLISHED -j ACCEPT'
说明:在所有Minion主机删除指定链编号为3(position=3)或指定存在的规则
8.network模块:返回Minion主机的网络信息
例子:
#salt 'minion01' network.ping www.baidu.com #minion01主机ping域名信息
9.pkg包管理模块:程序包管理,如:yum安装
例子:
#salt '*' pkg.install httpd #所有Minion主机安装等价于yum -y install httpd,pkg.remove为移除
10.service服务模块:程序包服务管理(如:开机自动启动,服务重启等)
例子:
#salt '*' service.enable httpd #所有Minion主机httpd服务开机自启动脚本,service.disable为禁用 #salt '*' service.restart httpd #所有Minion主机httpd服务重启,service.reload(加载)、service.start(启动)、service.stop(停止)、service.status(状态)
注:saltstack还提供了user(系统用户模块)、group(系统组模块)、partition(系统分区模块)、puppet(puppet管理模块)、system(系统重启、关机模块)、timezone(时区管理模块)、nginx(nginx管理模块)、mount(文件系统挂载模块)等等。
11.可以通过Python扩展模块,使用API。通过调用master client模块,实例化一个LocalClient对象,再调用cmd()方法来实现
如:API实现archive.gzip
#vim /root/archive_gzip.py import salt.client client = salt.client.LocalClient() ret = client.cmd('*','archive.gzip','/root/test.txt') print ret
执行结果返回一个字典
{'minion01': '/root/test.txt.gz'}
12.远程执行目标(target)
常见命令参数:
globbing #默认指定id进行匹配
L #以主机ID列表形式匹配,不同主机id名称使用逗号隔开
E #基于id的正则表达式进行匹配
G #基于grains信息进行匹配过滤
I #基于master赋给minion的pillar信息进行匹配
N #基于master配置文件中的分组名称匹配
S #基于minion的IP地址或者IP子网匹配
C #复合匹配,以上参数可以组合使用
#salt 'minion01' test.ping #salt -L 'minion01,minion02' test.ping #salt -E '.*01' test.ping #salt 'minion01' grains.items #salt 'minion01' grains.get os #salt -S '192.168.2.71' test.ping #salt -C 'E@m.*01 or G@id:minion02' test.ping #salt '*' pillar.get mysql
13.State内置模块
state是Saltstack最核心的功能。通过预先定制好的SLS描述了(支持YAML语法)系统的目标状态(程序包(pkg)、文件(file)、网络配置(network)、系统服务(service)、系统用户(user)等),由格式简单的数据构成。这经常被称作配置管理。
state的入口文件与pillar一样,文件名都是top.sls,但state要求sls文件必须存放在Saltstack base定义的目录下(默认为/srv/salt)。
state描述配置*.sls支持jinjia模板、grains及pillar引用等,在state的逻辑层次定义完成后,再通过salt ‘*’ state.highstate执行生效。
可用执行命令
#salt '*' state.highstate #所有Minion到Master上取SLS定义,然后在本地调用对应的state module(user,pkg,service等)来达到SLS描述的状态。 #salt-call state.highstate -l debug #输出debug信息,便于调试。
如:
apache: #ID声明,state名称:apache pkg: #管理对象类型states:pkg,进行软件安装(yum、apt) - installed #pkg要执行的方法:install,如未安装就进行安装 service: #管理对象类型states:service,管理系统守护进程 - running #service要执行的方法:running,如未运行就进行启动 - require: #关键字require,确保apache服务只有在成功安装软件包后才会启动 - pkg: apache
原创文章,作者:ItWorker,如若转载,请注明出处:https://blog.ytso.com/190888.html