saltstack 常用模块
cp模块
功能：实现远程文件、目录的复制，以及下载URL文件等操作
使用cp模块配置管理之前，要首先指定saltstack所有状态文件的根目录，在master上做如下操作：
指定根目录（确定指定的目录是否存在，如果不存在，需要手动来创建目录）
修改之后重启master服务
Api调用
client.cmd('k8s_master','cp.get_file',['salt://srcpath/to/file','minion-path/dest'])
[root@k8s_master ~]# cat /etc/salt/master |grep -v "^#\|^$" auto_accept: True file_roots: base: - /root
##cp.get_dir 拷贝本地目录到客户端目录 （salt://test_salt根目录为 /root/）
[root@k8s_master ~]# salt 'k8s_master' cp.get_dir salt://test_salt /tmp/ k8s_master: - /tmp//test_salt/test_salt [root@k8s_master ~]# ls /tmp/ go-build378977455 test_salt [root@k8s_master ~]# ls /tmp/test_salt/ test_salt
#拷贝本地文件到客户端（客户端目录下需要指定文件名称） [root@k8s_master ~]# salt 'k8s_master' cp.get_file salt://test_salt/aa /tmp/bb gzip=9 makedirs=True ##启用压缩（使用gzip的方式进行压缩） ，目录不存在时则创建 k8s_master: /tmp/bb [root@k8s_master ~]# cat /tmp/ bb test_salt/ [root@k8s_master ~]# cat /tmp/bb dfa
#单个或批量拷贝文件（salt-cp命令）
[root@k8s_master ~]# salt-cp 'k8s_master' /root/busybox.yaml /root/test_salt/
{'k8s_master': {'/root/test_salt/busybox.yaml': True}}
[root@k8s_master ~]# salt-cp 'k8s_master' /root/*.yaml /root/test_salt/
{'k8s_master': {'/root/test_salt/busybox.yaml': True,
'/root/test_salt/mysql-rc.yaml': True,
'/root/test_salt/nginx-rc.yaml': True,
'/root/test_salt/ui.yaml': True}}
#下载URL内容到客户端指定位置(/tmp/index.html) salt '*' cp.get_url http://www.baidu.com /tmp/index.html
#cp.push 将客户端的文件拷贝到服务端 #使用cp.push功能前，首先在master端开启push功能，并设置文件接收目录 [root@k8s_master ~]# vi /etc/salt/master file_recv: True cachedir: /var/cache/salt/master #设置接收目录
file_recv_max_size: 100 #接收文件大小
#重启master服务
[root@k8s_master ~]# systemctl restart salt-master
[root@k8s_master ~]# salt 'k8s_node1' cp.push /root/test.text
k8s_node1:
True
[root@k8s_master ~]# ls /var/cache/salt/master/minions/k8s_node1/
data.p files/ mine.p
[root@k8s_master ~]# ls /var/cache/salt/master/minions/k8s_node1/files/root/test.text #缓存文件路径
/var/cache/salt/master/minions/k8s_node1/files/root/test.text
Archive模块
功能：实现系统层面的压缩包调用，支持gzip、gunzip、rar、tar、unrar、unzip等
#采用gunzip解压ui.yaml.gz包 salt '*' archive.gunzip /root/ui.yaml.gz #采用gzip压缩ui.yaml文件 salt '*' archive.gzip /root/ui.yaml
#Api调用
client.cmd('*','archive.gunzip',['/xxx/xxx.tar.gz'])
cmd模块
功能：实现远程的命令行调用执行（默认具备root操作权限）
#获取所欲被控主机的内存使用情况 salt 'k8s_master' cmd.run 'free -m' #在k8s_master主机上运行test.py脚本，其中script/test.py存放在file_roots指定的目录（默认是在/srv/salt,自定义在/etc/salt/master文件中定义）， salt 'k8s_master' cmd.script salt://script/test.py
#Api调用
client.cmd('k8s_master','cmd.run',['command'])
cron模块
功能：实现被控主机的crontab操作
#查看指定被控主机、root用户的crontab操作 salt 'k8s_master' cron.raw_cron root #为指定被控主机、root用户添加/usr/local/weekl定时任务 salt 'k8s_master' cron.set_job root '*' '*' '*' '*' 1 /usr/local/weekly #删除指定被控主机、root用户crontab的/usr/local/weekly定时任务 salt 'k8s_master' cron.rm_job root /usr/local/weekly
#Api调用
client.cmd('k8s_master','cron.set_job',['root','*','*','*','*','*','/*.sh'])
dnsutil模块
#添加 salt '*' dnsutil.hosts_append /etc/hosts ip domain #删除 salt '*' dnsutil.hosts_remove /etc/hosts domain
#Api
client.cmd('*','dnsutil.hosts_append',['/etc/hosts','ip','domain'])
file模块
功能：被控主机常见的文件操作，包括文件读写、权限、查找、校验
#校验所有被控主机/etc/fstab文件的md5值是否为xxxxxxxxxxxxx,一致则返回True值 salt 'k8s_master' file.check_hash /etc/fstab md5=xxxxxxxxxxxxxxxxxxxxx #校验所有被控主机文件的加密信息，支持md5、sha1、sha224、shs256、sha384、sha512加密算法 salt 'k8s_master' file.get_sum /etc/passwd md5 #修改所有被控主机/etc/passwd文件的属组、用户权限、等价于chown root:root /etc/passwd salt 'k8s_master' file.chown /etc/passwd root root #复制所有被控主机/path/to/src文件到本地的/path/to/dst文件 salt 'k8s_master' file.copy /path/to/src /path/to/dst #检查所有被控主机/etc目录是否存在，存在则返回True,检查文件是否存在使用file.file_exists方法 salt 'k8s_master' file.directory_exists /etc #获取所有被控主机/etc/passwd的stats信息 salt 'k8s_master' file.stats /etc/passwd #获取所有被控主机/etc/passwd的权限mode，如755，644 salt 'k8s_master' file.get_mode /etc/passwd #修改所有被控主机/etc/passwd的权限mode为0644 salt 'k8s_master' file.set_mode /etc/passwd 0644 #在所有被控主机创建/opt/test目录 salt 'k8s_master' file.mkdir /opt/test #将所有被控主机/etc/httpd/httpd.conf文件的LogLevel参数的warn值修改为info salt 'k8s_master' file.sed /etc/httpd/httpd.conf 'LogLevel warn' 'LogLevel info' #给所有被控主机的/tmp/test/test.conf文件追加内容‘maxclient 100’ salt 'k8s_master' file.append /tmp/test/test.conf 'maxclient 100' #删除所有被控主机的/tmp/foo文件 salt 'k8s_master' file.remove /tmp/foo
#Api
clent.cmd('*','file.remove',['/file_path/filename'])
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 'k8s_master' network.dig www.qq.com salt 'k8s_master' network.ping www.qq.com salt 'k8s_master' network.traceroute www.qq.com #获取指定被控主机的mac地址 salt 'k8s_master' network.hwaddr eth0 #检测指定被控主机是否属于10.0.0.0/16子网范围，属于则返回True salt 'k8s_master' network.in_subnet 10.0.0.0/16 #获取指定被控主机的网卡配置信息 salt 'k8s_master' network.interfaces #获取指定被控主机的IP地址配置信息 salt 'k8s_master' network.ip_addrs #获取指定被控主机的子网信息 salt 'k8s_master' network.subnets
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','http'])
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'])
