saltstack二次开发（一）

Saltstack简介

Salt是一个配置管理系统，能够维护预定义状态的远程节点(比如，确保指定的包被安装，指定的服务在运行)，一个分布式远程执行系统，用来在远程节点（可以是单个节点，也可以是任意规则挑选出来的节点）上执行命令和查询数据，开发其的目的是为远程执行提供最好的解决方案，并使远程执行变得更好，更快，更简单。Saltstack（中国用户组 www.saltstack.cn ）基于python开发，c/s架构，支持多平台，比puppet轻量，在远程执行命令时非常快捷，配置和使用比puppet容易，能实现puppet几乎所有的功能。

Saltstack的优势

有master端和minion端，执行的信息比较稳定，不容易丢失信息，或者出现失联主机的情况。
有封装好的http-api，我们可以直接启动salt-api就可以通过http协议进行调用。不需要自己进行第二次的封装。

安装

基于centos6和centos7的差异，在两个不同的操作系统中安装saltstack也是不一样的。参考网址：https://docs.saltstack.com/en/latest/topics/installation/rhel.html
Centos6需要先安装扩展源，然后在进行安装。

Master端（192.168.127.165）

安装
yum install –y salt-master
yum install –y salt-api

vi /etc/salt/master
interface: 192.168.127.165

启动
systemctl start salt-master

Minion端（192.168.127.166）

安装
yum install  -y salt-minion

vi /etc/salt/minion
master:  192.168.127.165
其中有一个id选项，这个id虽然不定义也没有关系，如果不定义，那么master会以客户端的hostname来显示，一旦定义了就按id定义的名字来显示了，这个id可以不和hostname一致，但定义了id后，也应该在/etc/hosts里面定义记录。
启动
systemctl start salt-minion

源码安装：http://note.youdao.com/noteshare?id=881bbdbb6fd7bca9f74360aa052b79a4&sub=EEDE33154E13432FA9198021015C5C25

saltstack的密钥安装

Master与Minion认证

minion在第一次启动时，会在/etc/salt/pki/minion/（该路径在/etc/salt/minion里面设置）下自动生成minion.pem（private key）和 minion.pub（public key），然后将 minion.pub发送给master。master在接收到minion的public key后，通过salt-key命令accept minion public key，这样在master的/etc/salt/pki/master/minions下的将会存放以minion id命名的 public key，然后master就能对minion发送指令了。

salt-key -L  或者salt-key 显示所有的key
salt-key -D  删除所有认证主机id证书
salt-key -d  keys_values -y
salt-key -A  接收所有id证书请求
salt-key -a id 接受单个id证书请求

在Master上执行：

[root@k8s-master /]# salt-key
Accepted Keys:
k8s-node1  # 因为我在Minion上没有定义id，所以这里显示的是客户端的hostname
Denied Keys:
Unaccepted Keys:
Rejected Keys:

Saltstack远程执行命令

1.-E， --pcre，通过正则表达式进行匹配

salt -E 'web(9|10)*' test.ping -t 1

2. -L, --list, 主机id进行过滤

salt -L "*app*" cmd.run "df -h" 

3. -G, --grain, 根据被控主机的grains信息进行过滤

salt -G 'role:nginx' cmd.run "ls /export"

4. -I, --pillar， 根据被控主机的pillar信息进行过滤

salt -I 'myname:xiang' test.ping -t 5

5. -S, --ipcidr, 根据minion的ip地址进行匹配

salt -S 192.168.1.1 test.ping
salt -S 192.168.1.0/24 test.ping
salt -S 192.168.0.0/16 test.ping
salt -S 192.0.0.0/8 test.ping

6.检查客户端是否挂掉

salt-run manage.status |head
salt-run manage.down

例子：
[root@k8s-master ~]# salt-run manage.status
down:
up:
    - k8s-node1

测试一：salt "*" test.ping  # 检测通讯是否正常

[root@k8s-master ~]# salt "*" test.ping
k8s-node1:
    True

测试二：salt-run "*" cmd.run "df -h"   # 远程执行命令

[root@k8s-master ~]# salt "*" cmd.run "df -h"
k8s-node1:
    Filesystem               Size  Used Avail Use% Mounted on
    /dev/mapper/centos-root   17G  1.2G   16G   7% /
    devtmpfs                 478M     0  478M   0% /dev
    tmpfs                    489M   12K  489M   1% /dev/shm
    tmpfs                    489M   13M  476M   3% /run
    tmpfs                    489M     0  489M   0% /sys/fs/cgroup
    /dev/sda1               1014M  125M  890M  13% /boot
    tmpfs                     98M     0   98M   0% /run/user/0

说明： 这里的 * 必须是在 master 上已经被接受过的客户端，可以通过 salt-key 查到，通常是我们已经设定的 id 值。关于这部分内容，它支持通配、列表以及正则。 比如两台客户端 web10、web11， 那我们可以写成  salt 'web*'    salt 'web1[02]'  salt -L 'web10,web11'   salt -E 'web(10|11)' 等形式，使用列表，即多个机器用逗号分隔，而且需要加-L，使用正则必须要带-E选项。 它还支持 grains 和 pillar，分别加 -G 和 -I 选项，下面会介绍到。

Saltstack的几种模块介绍

runner模块

在master端执行，用于执行在master端执行的一些module
[root@k8s-master ~]# salt-run manage.status
down:
up:
    - k8s-node1

module 模块

通过master同步到minion端， 在minion执行。
salt-call saltutil.sync_modules  # 同步到minion端
salt-call saltutil.sync_all

grains模块

记录minion的属性key：value
[root@k8s-master ~]# salt "*" grains.ls
k8s-node1:
    - SSDs
    - biosreleasedate
    - biosversion
    - cpu_flags
    - cpu_model
    - cpuarch
    - domain
    ......

自定义grians（在minion上定义的）
grains是在minion启动时搜集一些信息，如操作系统类型，网卡，内核版本，cpu架构等
salt "*" grains.ls 列出所有grains项目名字
salt "*app.*" grains.items 列出所有grains项目以及值
grains的信息并不是动态的，并不会实时变化，它只是在minion启动时收集到的
我们可以根据grains收集到的一些信息，做一些配置管理工作
在minion上：vim /etc/salt/grains
role: nginx
env: test
重启service salt-minion restart
获取grians：
salt "*" grains.item role env
或者：
salt -G "*" role:nginx cmd.run "hostname“
salt "*" grains.items

pillar模块

记录所有minion通用的属性，如cpu、内存、磁盘等信息，然后同步到master端
salt-call saltutil.refresh_pillar # minion端
salt '*' saltutil.refresh_pillar  # master端

pillar（在master上定义）（yaml语法）
在配置文件中找pillar的文件路径：

找到以后，mkdir /export/salt/pillar
vim top.sls
base:
"*":
- test
vim test.sls
conf: xiang
然后刷新pillar： salt '*' saltutil.refresh_pillar
验证：salt '*' pillar.items conf
或者： salt -I 'conf:xiang' test.ping

cmd模块

[root@k8s-master ~]# salt  '*' cmd.run "df -h"
k8s-node1:
    Filesystem               Size  Used Avail Use% Mounted on
    /dev/mapper/centos-root   17G  1.2G   16G   7% /
    devtmpfs                 478M     0  478M   0% /dev
    tmpfs                    489M   12K  489M   1% /dev/shm
    tmpfs                    489M   13M  476M   3% /run
    tmpfs                    489M     0  489M   0% /sys/fs/cgroup
    /dev/sda1               1014M  125M  890M  13% /boot
    tmpfs                     98M     0   98M   0% /run/user/0

ping模块

[root@k8s-master ~]# salt '*' test.ping
k8s-node1:
    True

cp模块

file_roots:
base:
- /export/salt/root
salt根目录：在master中file_roots定义的路径，salt://test.txt相当于/export/salt/root/test.txt
salt '192.168.127.166' cp.get_file salt://nscd.conf /tmp/xiang.txt

cron模块

salt '*' cron.raw_cron root     # 查看定时任务
salt '*' cron.set_job root '*' '*' '*' '*' 1 /export/scripts/rm_log.sh
salt '*' cron.rm_job root /export/scripts/rm_log.sh  

dnsutil模块

salt '*' dnsutil.hosts_append /etc/hosts 127.0.0.1 jack.com
salt '*' dnsutil.hosts_remove /etc/hosts jack.com

file模块

salt '*' file.chown /etc/passwd root root
salt '*' file.copy /path/to/src /path/to/dst
salt '*' file.file_exists /etc/hosts
salt '*' file.directory_exists /etc/
salt '*' file.get_mod /etc/passwd
salt '*' file.set_mod /etc/passwd 0644
salt '*' file.mkdir /tmp/test
salt '*' file.sed /export/servers/nginx/conf/nginx.conf 'debug' 'warn'
salt '*' file.append /tmp/test.txt "welcome jack"
salt '*' file.remove /tmp/1.txt

network模块

salt '*' network.dig www.qq.com
salt '*' network.ping www.qq.com
salt '*' network.ip_addrs

pkg包管理模块

管理yum， apt-get等
salt '*' pkg.install php   # 安装php
salt '*' pkg.remove php    # 移除php
salt '*' pkg.upgrade       # 升级所有的软件包

service模块

salt '*' service.enable nginx    # 使nginx可用
salt '*' service.disable nginx   # 使nginx不可用
salt '*' service.restart nginx   # 重启nginx