运维自动化之：Saltstack配置管理工具安装配置使用攻略

系统环境：

Centos 6.x 

服务端（salt-master）：10.1.2.11

客户端（salt-minion）：10.1.2.10、10.1.2.11、10.1.2.12

安装：

rpm -Uvh http://ftp.linux.ncsu.edu/pub/epel/6/i386/epel-release-6-8.noarch.rpm
服务端：yum install salt-master 
客户端：yum install salt-minion

服务端配置：

vim /etc/salt/master 
interface: 0.0.0.0
pidfile: /var/run/salt-master.pid
log_file: /var/log/salt/master
key_logfile: /var/log/salt/key

客户端配置：

vim  /etc/salt/minion 
master: 10.1.2.11
pidfile: /var/run/salt-minion.pid
id: centos12
log_file: /var/log/salt/minion
key_logfile: /var/log/salt/key

如果一切顺利，请继续！

saltstack 主控端是依靠openssl证书来与受控端主机认证通讯的，受控端启动后会发送给主控端一个公钥证书文件，在主控端用 salt-key 命令来管理证书。

salt minion和master的认证过程：

minion在第一次启动时，会在/etc/salt/pki/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发送指令了。

证书管理：

[root@localhost ~]# salt-key -L
Accepted Keys:
Unaccepted Keys:
centos10
centos11
centos12
Rejected Keys:

[root@localhost ~]# salt-key -A
The following keys are going to be accepted:
Unaccepted Keys:
centos10
centos11
centos12
Proceed? [n/Y] y
Key for minion centos10 accepted.
Key for minion centos11 accepted.
Key for minion centos12 accepted.

通信测试：

[root@localhost salt]# salt '*' test.ping
centos10:
    True
centos12:
    True
centos11:
    True

注意，通配符 *代表所有minion，假如你收到“True”，证明你已经成功安装和配置完成salt stack。

Salt远程执行及语法结构：

命令格式：salt '<target>' <function> [arguments]

1. target:

target部分允许你指定那些minion应该运行执行. 默认的规则是使用glob匹配minion id. 例如:

salt '*' test.ping
salt '*.example.org' test.ping

Targets可以使用Grains系统来通过minion的系统信息进行过滤:

salt -G 'os:Ubuntu' test.ping

更多参见Grains系统：http://docs.saltstack.cn/zh_CN/latest/topics/targeting/grains.html 

Targets也可以使用正则表达式:

salt -E 'virtmach[0-9]' test.ping

Targets也可以指定列表:

salt -L 'foo,bar,baz,quo' test.ping

或者在一个命令中混合使用多target类型:

salt -C 'G@os:Ubuntu and webser* or E@database.*' test.ping

2. function

funcation是module提供的功能. Salt内置了大量有效的functions. 列出minions上的所有有效functions：

salt '*' sys.doc

显示当前所有有效的minions:

salt '*' test.ping

运行一个任意的shell命令:

salt '*' cmd.run 'uname -a'

所有模块列表：http://docs.saltstack.cn/zh_CN/latest/ref/modules/all/index.html

3. arguments：

function通过空格来界定参数:

salt '*' cmd.exec_code python 'import sys; print sys.version'

可选的, 也支持keyword参数:

salt '*' pip.install salt timeout=5 upgrade=True

Salt配置管理：

很多最强大、最有用的工程解决方案都是基于简单原则建立起来的。Salt States 也竭尽全力做到那样：K.I.S.S.(Keep It Stupidly Simple 简单到愚蠢)

默认，Salt使用PyAMl语法(http://pyyaml.org) 作为它的模板文件的格式，但是其他很多模板语言在Salt中是可以使用的。一定要按照正确的格式书写YAML,比如它使用到两个空格代替tab。

一个典型的SLS 文件常常看起来像这样的YAML：

httpd:            #第一行是这一组数据的ID，被叫做ID 声明
  pkg:            #第二行和第四行是状态声明的开始，所以分别使用了包和服务状态。
    - installed   #第三行和第五行是要运行的函数。
  service:
    - running
    - require:    #第六行，是关键词require.它叫做需求声明，它保证httpd服务仅在httpd包被成功安装后才会启动。
      - pkg: httpd

SLS文件命名：

使用子目录来做组织是个很好的选择：

a.每个子目录描述一个资源；

b.webserver.dev 用来表示子目录 webserver/dev.sls

init.sls 在一个子目录里面表示引导文件，也就表示子目录本身， 所以webserver/init.sls就是表示webserver；

如果同时存在webserver.sls和 webserver/init.sls，则 webserver/init.sls 被过滤，webserver.sls将被用来表示 webserver.

启动配置管理：

打开master配置文件，找到file_roots行,取消如***释！

# vim /etc/salt/master
file_roots:
  base:
    - /srv/salt

创建基础配置文件：

# vim /srv/salt/top.sls
base:  '*':
    - servers

创建server.sls文件

# vim /srv/salt/server.sls   #或者vim /srv/salt/server/init.sls
httpd:       
  pkg:  
    - installed 
  service:
    - running
    - watch:
      - pkg: httpd
      - file: /etc/httpd/conf/httpd.conf
      - user: apache
  user.present:
    - uid: 87
    - gid: 87
    - home: /var/www/html
    - shell: /sbin/nologin
    - require:
      - group: apache
  group.present:
    - gid: 87
    - require: 
      - pkg: apache
/etc/httpd/conf/httpd.conf:
  file.managed:
    - source: salt://apache/httpd.conf
    - user: root
    - group: root
    - mode: 644

触发配置minion：

#所有的sls文件准备好以后，最后一步是告诉Salt配置远程机器。state.highstate 是触发这些同步的命令。使用先前的语法格式，目标位所有机器，键入以下格式的命令：
 salt '*' state.highstate

注：

文件被Salt管理2种方式：1.用`file.managed`状态声明；2.使用,`file`状态声明，然后加一个`managed`属性给那个状态声明。

/mnt/test.txt
  file.managed:
    - source: salt://src/test.txt
    - user: root
    - group:root
    ........
#OR
/mnt/test.txt
  file:
    - managed
    - source: salt://src/test.txt
    .........

待续.....

案例：为每一个minion客户端部署zabbix-agent，并确保该进程正常启动。

zabbix_epel:
  file.managed:
    - name: /root/zabbix-release-2.2-1.el6.noarch.rpm
    - source: salt://src/zabbix-release-2.2-1.el6.noarch.rpm
    - user: root
    - group: root
  cmd.run:
    - name: rpm -ivh /root/zabbix-release-2.2-1.el6.noarch.rpm
    - unless: test -f /etc/yum.repos.d/zabbix.repo
    - require:
      - file: zabbix_epel

zabbix-agent:
  pkg:
    - installed
    - require:
      - file: zabbix_epel
  service:
    - running
    - watch:
      - file: /etc/zabbix/zabbix_agentd.conf
    - require:
      - pkg: zabbix-agent
/etc/zabbix/zabbix_agentd.conf:
  file.managed:
    - source: salt://src/zabbix_agentd.conf
    - user: root
    - group: root
    - mode: 644

更多请参阅：

Saltstack知识库：http://www.saltstack.cn/projects/cssug-kb/wiki 

Saltstack Doc目录：http://docs.saltstack.cn/contents.html