首页 > 代码库 > Saltstack 常用的模块及API

Saltstack 常用的模块及API

   Saltstack提供了非常丰富的功能模块,设计操作系统的基础功能,常用工具支持等,

官网模块介绍

http://docs.saltstack.com/ref/modules/all/index.html

 

一 列出当前版本支持的模块

[root@hzbj-salt-020 ~]# salt * sys.list_modules
hzbj-tomcat-021:
    - acl
    - aliases
    - alternatives
    - apache
    - archive
    - artifactory
    - blockdev
    - btrfs
    - buildout
    - cloud
    - cmd
    - composer
    - config
    - container_resource
    - cp
    - cron
    - data
    - defaults
    - devmap
    - disk
    - django
    - dnsmasq
    - dnsutil
    - drbd
    - elasticsearch
    - environ
    - etcd
    - event
    - extfs
    - file
    - gem
    - genesis
    - git
    - grains
    - group
    - grub
    - hashutil
    - hg
    - hipchat
    - hosts
    - http
    - img
    - incron
    - ini
    - introspect
    - ip
    - iptables
    - jboss7
    - jboss7_cli
    - key
    - kmod
    - locale
    - locate
    - logrotate
    - lowpkg
    - lvm
    - match
    - mine
    - modjk
    - mount
    - network
    - openstack_config
    - pagerduty
    - pillar
    - pip
    - pkg
    - pkg_resource
    - postfix
    - publish
    - pyenv
    - raid
    - random
    - random_org
    - rbenv
    - ret
    - rsync
    - runit
    - rvm
    - s3
    - saltutil
    - schedule
    - scsi
    - sdb
    - seed
    - serverdensity_device
    - service
    - shadow
    - slack
    - smtp
    - sqlite3
    - ssh
    - state
    - status
    - supervisord
    - sys
    - sysctl
    - syslog_ng
    - system
    - test
    - timezone
    - user
    - vbox_guest
    - virtualenv
    - webutil
    - xfs

所有主机saltstack支持的模块清单(打印部分)

二 模块及api

import salt.client
client = salt.client.LocalClient()
ret = client.cmd(*,test.ping)
print ret

 

(1) Archive模块

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

 

2)示例:

 

 

 

(2)cmd模块

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

2)示例:

#获取所有被控主机的内存使用情况
[root@hzbj-salt-020 ~]# salt * cmd.run "free -m"
hzbj-tomcat-022:
                 total       used       free     shared    buffers     cached
    Mem:           980        715        264          0         55        476
    -/+ buffers/cache:        184        796
    Swap:         1983          0       1983
hzbj-tomcat-021:
                 total       used       free     shared    buffers     cached
    Mem:           980        884         95          0         25        206
    -/+ buffers/cache:        652        327
    Swap:         1983         11       1972

#在hzbj-tomcat-022主机运行test.sh脚本,其中scripts/test.sh存放在file_roots指定的目录,
#改命令会做两个动作:首选同步test.sh到minion的cache目录(如同步到/var/cache/salt/ #minion/files/base/script/test.sh):其次运行改脚本
[root@hzbj-salt-020 ~]# salt hzbj-tomcat-01 cmd.script salt://script/test.sh

 

3)API调用

client.cmd(hzbj-tomcat-021,cmd.run,[free -m])

 

(3)cp模块

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

 

2)示例:

 将注服务器file_roots指定位置下的目录复制到被控主机
 salt * cp.get_dir salt://path/to/dir /minion/dest
 
 将主服务器file_roots指定文职下的文件复制到被控主机
 salt * cp.get_file salt://path/to/file /minion/dest
 
下载URL内容到被控主机指定位置
salt * cp.get_url http://www.salshdot.org /tmp/index.html

 

3)API调用

client.cmd(hzbj-tomcat-021,cp.get_file,[salt://path/to/file,/minion/dest])

 

(4)cron模块

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

2)示例

 查看指定被控主机,root用户的crontab清单
 [root@hzbj-salt-020 salt]# salt hzbj-tomcat-021 cron.raw_cron root
hzbj-tomcat-021:
    */2 * * * * ntpdate pool.ntp.org &>/dev/null
    */1 * * * * cd /usr/local/gse/; ./cron_gse.sh 1>/dev/null 2>&1

#指定的被控主机,root用户添加/usr/local/weekly任务作业
[root@hzbj-salt-020 salt]# salt hzbj-tomcat-021 cron.raw_cron root
hzbj-tomcat-021:
    */2 * * * * ntpdate pool.ntp.org &>/dev/null
    */1 * * * * cd /usr/local/gse/; ./cron_gse.sh 1>/dev/null 2>&1
    # Lines below here are managed by Salt, do not edit
    * * * * 1 /usr/local/weekly

#删除指定的被控主机,root用户添加/usr/local/weekly任务作业
[root@hzbj-salt-020 salt]# salt hzbj-tomcat-021 cron.rm_job root /usr/local/weekly
hzbj-tomcat-021:
    removed

注解: 如果需要写入sls文件里面

/usr/sbin/ntpdate pool.ntp.org >>/dev/null 2>&1:
  cron.present:
    - user: root
    - minute: 10
minute      #分钟
hour        #小时
daymonth    #日
month       #月
dayweek     #0~6是周一到周六,周日是7

   默认执行用户“root”,时间不填写默认是“*,周期执行“*/2,随机执行“random”,identifier    是任务标识符,类似于任务ID,更改任务时指定“标识符”可方便修改

 

3)API调用

client.cmd(hzbj-tomcat-021,cron.set_job,[root,*,*,*,*,*,/usr/echo])

 

(5)dnsutil模块

1)功能:实现被控主机通用DNS相关操作。

 

2)示例:

[root@hzbj-salt-020 ~]# salt * dnsutil.hosts_append /etc/hosts 127.0.0.1 ad1.yuk.com

删除指定被控主机hosts的主机批准
[root@hzbj-salt-020 ~]# salt * dnsutil.hosts_remove /etc/hosts ad1.yuk.com

 

3)API调用

client.cmd(hzbj-tomcat-021,dnsutil.hosts_append,[/etc/hosts,127.0.01,ad1.yuk.co])

 

(6)file模块

1)功能:被控主机文件操作,包括文件读写,权限,查找,校验等。

 

 

 

 

(9)pkg包管理模块

1)功能:被控主机程序包管理,如yum,apt-get

 

2)示例:

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

 

3)API调用

client.cmd(hzbj-tomcat-021,pkg.remove,[php])

 

(10)Service服务模块

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

 

2)示例:

#开启(enable),禁用(disable)nginx开机自启动服务

salt * service.enable nginx
salt * service.disable nginx

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

3)API调用

client.cmd(hzbj-tomcat-021,service.stop,[nginx])

 

Saltstack 常用的模块及API