saltstack 常用模块

Posted 2020-10-20 FRESHMANS

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\'])