1、安装说明
操作系统版本：CentOS Linux release 7.5.1804 (Core)
saltstack版本：2018.3.2
已经关闭selinux、firewalld服务。
2、配置yum源
编辑/etc/yum.repos.d/salt.repo，内容如下：
[salt-latest] name=SaltStack Latest Release Channel for RHEL/Centos $releasever baseurl=https://mirrors.aliyun.com/saltstack/yum/redhat/7/$basearch/latest failovermethod=priority enabled=1 gpgcheck=0 gpgkey=file:///etc/pki/rpm-gpg/saltstack-signing-key
3、安装salt-master、salt-minion、salt-api
yum install salt-master salt-minion salt-api pyOpenSSL
4、配置salt-master配置文件
master节点配置文件为/etc/salt/master，内容如下：
interface: 0.0.0.0 publish_port: 4505 user: root max_open_files: 100000 worker_threads: 5 ret_port: 4506 root_dir: / default_include: master.d/*.conf #设置salt master的配置文件，包含master.d目录下的文件 pki_dir: /etc/salt/pki/master keep_jobs: 24 timeout: 5 auto_accept: True state_top: top.sls file_roots: base: - /srv/salt log_file: /var/log/salt/master log_level: debug file_recv: True #启用从客户端传送文件到master节点
5、部署配置salt-api认证，添加认证用户，生成证书等
#创建一个saltapi用户，同时为该用户添加密码 useradd -M -s /sbin/nologin saltapiuser echo '123456' | passwd saltapi --stdin #开启visudo，使该用户能拥有root权限 usermod -g wheel saltapi #进行自签名证书配置 cd /etc/pki/tls/certs/ make saltapicert salt-call --local tls.create_self_signed_cert
提示已经存在时，可以删除/etc/pki/tls/certs/localhost.crt /etc/pki/tls/certs/localhost.key重新生成
6、添加salt-api配置文件，设置远程调用端口等内容
vim /etc/salt/master.d/api.conf
内容如下：
rest_cherrypy: port: 8010 #设置远程rest api调用端口 ssl_crt: /etc/pki/tls/certs/localhost.crt #自定义tls证书，使其支持https ssl_key: /etc/pki/tls/certs/localhost.key #自定义key external_auth: #设置认证方式 pam: saltapi: - .* - '@wheel' - '@runner'
若不想使用https调用，则将ssl_cert、ssl_key配置去掉即可。
7、配置完成之后，需要重启相关服务
systemctl restart salt-master systemctl restart salt-api systemctl restart salt-minion
8、获取认证token值
curl -sSk https://18.18.1.6:8010/login -H 'Accept: application/x-yaml' -d username='saltapiuser' -d password='123456' -d eauth='pam'
显示内容如下：
return:
- eauth: pam
expire: 1535514571.611626
perms:
- .*
- '@wheel'
- '@runner'
start: 1535471371.611626
token: f9546b1a123bd1edcefefbcff37a54ff3358cda3 #此处即为远程调用的token值
user: saltapiuser
备注：如果在配置文件中，并未配置ssl_cert、ssl_key配置，请使用http进行调用。同时若重启salt-api服务，token值会变化。若再次生成，也会发生变化。
9、执行models，使用test.ping查看是否调用成功。
[root@192-168-40-71 ~]# curl -k https://18.18.1.6:8010/ -H "Accept: application/x-yaml" -H "X-Auth-Token: f9546b1a123bd1edcefefbcff37a54ff3358cda3" -d client='local' -d tgt='192.168.40.71' -d fun='test.ping' return: - 192.168.40.71: true
输出结果如上，即可说明salt-api已经配置完成，同时可使用rest api进行调用。
10、远程调用命令解析
-d client='local'：使用local进行远程命令执行 -d tgt='192.168.40.71'：指定远程minion节点地址 -d fun='cmd.run' ：调用的模块名称 -d arg='ip addr list'：调用模块所需要的参数 备注：如果调用的模块需要多个参数，需要指定多个-d arg='参数内容'进行使用。请参考模块使用示例中的add_host添加解析作为参考。
11、常用模块使用示例
使用cmd.run模块，远程执行命令
curl -k https://18.18.1.6:8010/ -H "Accept: application/x-yaml" -H "X-Auth-Token: f9546b1a123bd1edcefefbcff37a54ff3358cda3" -d client='local' -d tgt='192.168.40.71' -d fun='cmd.run' -d arg='ip addr list'
使用add_host添加hosts解析
curl -k https://18.18.1.6:8010/ -H "Accept: application/x-yaml" -H "X-Auth-Token: f9546b1a123bd1edcefefbcff37a54ff3358cda3" -d client='local' -d tgt='192.168.40.71' -d fun='hosts.add_host' -d arg='2.2.2.2' -d arg='test.lcs'
其中2.2.2.2为ip地址，test.lcs为域名。
使用cp.push方法从minion上将文件复制到master节点上
curl -k https://18.18.1.6:8010/ -H "Accept: application/x-yaml" -H "X-Auth-Token: f9546b1a123bd1edcefefbcff37a54ff3358cda3" -d client='local' -d tgt='192.168.40.71' -d fun='cp.push' -d arg='/tmp/1.txt'
复制过来的文件位置为：/var/cache/salt/master/minions/192.168.40.71/files/tmp，其中192.168.40.71为minion节点ip地址。
调用cp.get_file方法，将master节点上文件复制到minion节点上。
curl -k https://18.18.1.6:8010/ -H "Accept: application/x-yaml" -H "X-Auth-Token: f9546b1a123bd1edcefefbcff37a54ff3358cda3" -d client='local' -d tgt='192.168.40.71' -d fun='cp.get_file' -d arg='salt://tmp/1.txt' -d arg='/data/1.txt'
由于需要在复制文件的时候，需要传入多个参数，因此，使用run模块，将多个参数放在列表中传入。
curl -k https://18.18.1.6:8010/run -H "Accept: application/json" -H "Content-type: application/json" -d '[{"client":"local","tgt":"192.168.40.71","fun":"cp.get_file","arg":["salt://tmp/1.txt","/data/111.txt"],"username":"xxx","password":"xxx","eauth":"pam"}]'