笔记内容:简单使用saltstack
笔记日期:2018-01-24

  • 24.5 saltstack远程执行命令
  • 24.6 grains
  • 24.7 pillar
  • 24.8 使用saltstack去安装httpd
  • 24.9 配置管理文件(分发文件)

24.5 saltstack远程执行命令

saltstack的salt命令可以用于远程在minion端上执行命令,本节介绍一下salt的常用语法。

1.test.ping用于测试能否ping通minion端,测试已认证的minion端是否存活:

[root@server ~]# salt '*' test.ping     # 这里的*表示测试所有已经认证的minion端
server:
    True
client:
    True
[root@server ~]# salt 'client' test.ping   # 指定测试某一个minion端
client:
    True
[root@server ~]#

2.cmd.run可以执行系统的命令,例如我要让所有机器都执行hostname命令:

[root@server ~]# salt '*' cmd.run "hostname"  # 但是如果是普通用户的话,只能执行普通用户能够执行的命令
server:
    server
client:
    client
[root@server ~]# 

说明: 这里的必须是在master上已经被接受过认证的客户端,可以通过salt-key查到,通常是我们已经设定的id值。关于这部分内容,它支持通配、列表以及正则。 比如两台客户端test-01,test-02, 那我们可以写成salt 'test-\', salt 'test-0[12]' salt -L 'test-01,test-02' salt -E 'test-(01|02)'等形式,使用列表,即多个机器用逗号分隔,而且需要加-L,使用正则必须要带-E选项。 它还支持grains,加-G选项,pillar 加-I选项。

支持正则表达式:

[root@server ~]# salt 'cli*' test.ping
client:
    True
[root@server ~]# salt 'cli[a-z]*' test.ping
client:
    True
[root@server ~]# 

-L选项指定使用的是列表,需要用逗号进行分割:

[root@server ~]# salt -L 'server,client' cmd.run "hostname"
client:
    client
server:
    server
[root@server ~]# 

有些正则表达式的使用需要加上-E来指定,不然不支持:

[root@server ~]# salt -E 'cl(i|e|n|t)*' cmd.run "hostname"
client:
    client
[root@server ~]# 

24.6 grains

grains是在minion启动时收集到的一些信息,比如操作系统类型、网卡IP、内核版本、cpu架构等等。

[root@server ~]# salt "client" grains.ls   # 列出所有的grains项目名字
[root@server ~]# salt "client" grains.items   # 列出所有grains项目以及值

注:grains的信息并不是动态的,并不会实时变更,它是在minion启动时收集到的。我们可以根据grains收集到的一些信息,做配置管理、资产管理等工作。

grains支持自定义信息,示例:
1.在minion端上编辑配置文件:

[root@client ~]# vim /etc/salt/grains  # 增加自定义信息,格式是 键 : 值 形式的
role: nginx
env: test

2.配置完之后需要重启minion服务:

systemctl restart salt-minion

3.配置完成后,就可以回到master上,获取grains:

[root@server ~]# salt '*' grains.item role env
client:
    ----------
    env:
        test
    role:
        nginx
server:  
    ----------
    env:
    role:
[root@server ~]# salt '*' grains.item abc efg  # 如果我们获取不存在的grains信息,就只会返回空信息
server:
    ----------
    abc:
    efg:
client:
    ----------
    abc:
    efg:
[root@server ~]# 

可以根据grains获取到的一些属性信息来执行系统命令,可以起到一个匹配的作用:

[root@server ~]# salt -G role:nginx cmd.run 'hostname'
client:
    client
[root@server ~]# 

24.7 pillar

pillar和grains不一样,pillar是在master上定义的,并且是针对minion定义的一些信息。像一些比较重要的数据(密码)可以存在pillar里,还可以定义变量等。

pillar也支持自定义信息,配置自定义pillar示例:

[root@server ~]# vim  /etc/salt/master   # 在文件中搜索pillar_roots,然后去掉这几行的注释,注意保留空格
pillar_roots:
  base:  # 键
    - /srv/pillar  # 值,这值配置的是一个目录

重启salt-master服务:

systemctl restart salt-master.service

接着创建/srv/pillar目录,并且编辑一个子配置文件用于一会的测试:

[root@server ~]# mkdir /srv/pillar
[root@server ~]# ls /srv/pillar
[root@server ~]# vim /srv/pillar/test.sls   # 内容如下,同样的是键值形式
conf: /etc/test.conf

编写主配置文件:

[root@server ~]# vim /srv/pillar/top.sls  # 内容如下
base:  # 表示根
  'client':  # 主机名,缩进两个空格
    - test   # 加载哪个前缀的配置文件,缩进四个空格

然后重启master:

systemctl restart salt-master

当更改完pillar配置文件后,我们可以通过刷新pillar配置来获取新的pillar状态:

[root@server ~]# salt '*' saltutil.refresh_pillar
server:
    True
client:
    True
[root@server ~]# 

验证一下是能否识别到自定义的的pillar信息:

[root@server ~]# salt  '*' pillar.item conf
server:
    ----------
    conf:
client:
    ----------
    conf:
        /etc/test.conf
[root@server ~]# 

pillar同样可以用来作为salt的匹配对象。例如:

[root@server ~]# salt  -I 'conf:/etc/test.conf' cmd.run "hostname"
client:
    client
[root@server ~]#

24.8 使用saltstack去安装httpd

通过saltstack工具,我们可以在指定的或所有的minion端上,安装某个服务或工具,本节演示如何使用saltstack在minion端安装httpd服务。

1.在master上编辑配置文件:

[root@server ~]# vim /etc/salt/master    # 搜索file_roots,去掉以下几行的注释,注意保留空格
file_roots:
  base:
    - /srv/salt

2.重启服务:

systemctl restart salt-master.service

3.创建目录以及配置文件:

[root@server ~]# mkdir /srv/salt
[root@server ~]# vim /srv/salt/top.sls  # 主配置文件
base:
  '*':  # *表示所有,前面有两个空格
    - httpd   # 前面有4个空格,表示在所有的客户端上执行httpd模块

4.增加一个子配置文件:

[root@server ~]# vim /srv/salt/httpd.sls   # 增加以下内容
httpd-service:  # 服务的名称
  pkg.installed:   # saltstack内置模块,用于执行安装命令
    - names:  # names的值是需要安装的包的名称
      - httpd  # 安装httpd 包
      - httpd-devel    # 安装httpd-devel 包
  service.running:   # saltstack内置模块,用于启动服务
    - name: httpd  # 启动httpd服务
    - enable: True  # True表示开机启动

说明: httpd-service是id的名字,自定义的。pkg.installed 为包的安装函数或者说模块,下面是要安装的包的名字。service.running也是一个函数,来保证指定的服务启动,enable表示开机启动。

5.在minion端上进行安装:

[root@server ~]# salt 'client' state.highstate    # 执行过程会比较慢,因为minion端上在执行yum安装命令

在minion端上可以看到,的确是在执行yum命令:

[root@client ~]# ps aux |grep yum
root       4582 38.5  2.2 459440 87500 ?        D    18:28   0:01 /usr/bin/python /usr/bin/yum -y install httpd-devel
root       4599  0.0  0.0 112660   964 pts/0    S+   18:28   0:00 grep --color=auto yum
[root@client ~]# 

等master上的命令执行完成之后,到minion端上可以看到已经安装成功:

[root@client ~]# ps aux |grep httpd
root       4704  0.1  0.3 384816 15432 ?        Ss   18:28   0:00 /usr/sbin/httpd -DFOREGROUND
apache     4714  0.0  0.2 387036  8084 ?        S    18:28   0:00 /usr/sbin/httpd -DFOREGROUND
apache     4715  0.0  0.2 387036  8084 ?        S    18:28   0:00 /usr/sbin/httpd -DFOREGROUND
apache     4716  0.0  0.2 387036  8084 ?        S    18:28   0:00 /usr/sbin/httpd -DFOREGROUND
apache     4717  0.0  0.2 387036  8084 ?        S    18:28   0:00 /usr/sbin/httpd -DFOREGROUND
apache     4718  0.0  0.2 387036  8084 ?        S    18:28   0:00 /usr/sbin/httpd -DFOREGROUND
root       4752  0.0  0.0 112660   964 pts/0    S+   18:30   0:00 grep --color=auto httpd
[root@client ~]# netstat -lntp |grep httpd
tcp6       0      0 :::80                   :::*                    LISTEN      4704/httpd          
[root@client ~]# 

24.9 配置管理文件(分发文件)

saltstack有一个分发文件的功能,可以使用这个功能来批量分发一些文件到minion端上。我们需要在master端准备一个模板文件,并且进行相应的配置后,才能够进行分发。分发功能的好处在于,我们不需要自己一个个的将文件发送到master端上,只需要在master端执行一条命令就完成将文件发送到master端上的任务,减少了很多重复且无谓的工作。

1.在master上编辑配置文件:

[root@server ~]# vim /srv/salt/test.sls
file_test:
  file.managed: 
    - name: /tmp/example.com
    - source: salt://test/example/example.txt
    - user: root
    - group: root
    - mode: 600

说明:

  • 第一行的file_test为自定的名字,表示该配置段的名字,可以在别的配置段中引用它,
  • name指定分发到minion端上的哪个路径以及文件名称
  • source指定文件从哪里拷贝,这里的salt://test/example/example.txt相当于是/srv/salt/test/example/example.txt,
  • user和group指定文件的属主以及属组
  • mode则是指定文件的的权限。

2.创建目录以及模板文件:

[root@server ~]# mkdir -p /srv/salt/test/example
[root@server ~]# vim /srv/salt/test/example/example.txt  # 编辑模板文件,内容如下
This is a template file

3.编辑主配置文件:

[root@server ~]# vim /srv/salt/top.sls  # 修改为如下内容
base:
  '*':
    - test

4.执行以下命令,将模板文件分发到minion端上:

[root@server ~]# salt 'client' state.highstate
client:
----------
          ID: file_test
    Function: file.managed
        Name: /tmp/example.com
      Result: True
     Comment: File /tmp/example.com updated
     Started: 18:48:48.652179
    Duration: 61.133 ms
     Changes:   
              ----------
              diff:
                  New file

Summary for client
------------
Succeeded: 1 (changed=1)
Failed:    0
------------
Total states run:     1
Total run time:  61.133 ms
[root@server ~]# 

到minion端上,查看分发过去的文件:

[root@client ~]# ls -l /tmp/example.com 
-rw------- 1 root root 511 1月  24 18:48 /tmp/example.com
[root@client ~]# cat /tmp/example.com 
This is a template file
[root@client ~]# 

如上,代表分发成功,当我们需要改动或者分发某个文件到一组机器时,使用这种分发模板文件的方式将省去很多重复的操作。

24.10 配置管理目录(分发目录)

除了分发文件外,很多情况下我们还需要分发目录,所以 saltstack 也支持配置目录的分发。

1.在master上编辑子配置文件:

[root@server ~]# vim /srv/salt/test_dir.sls  # 加入以下内容
file_dir:
  file.recurse:
    - name: /tmp/testdir
    - source: salt://test/example
    - user: root
    - file_mode: 640  # 文件权限
    - dir_mode: 750  # 目录权限
    - mkdir: True  # 如果没有目录就创建
    - clean: True   # 加上它之后,源删除文件或目录,目标也会跟着删除,否则不会删除

2.修改主配置文件:

[root@server ~]# vim /srv/salt/top.sls 
base:
  '*':
    - test_dir

3.执行以下命令测试能否正常分发目录:

[root@server ~]# salt 'client' state.highstate

4.到minion端上查看目录是否已分发成功:

[root@client ~]# ls /tmp/testdir/
example.txt
[root@client ~]# cat /tmp/testdir/example.txt 
This is a template file
[root@client ~]# ll !$
ll /tmp/testdir/example.txt
-rw-r----- 1 root root 24 1月  25 14:35 /tmp/testdir/example.txt
[root@client ~]# 

saltstack 有一个特性,如果你要分发的目录下的子目录为空的话,是不会进行分发的:

[root@server ~]# mkdir /srv/salt/test/example/123  # 创建一个空目录
[root@server ~]# salt 'client' state.highstate

client上依旧只有一个文件:

[root@client ~]# ls /tmp/testdir/
example.txt
[root@client ~]#

所以空目录是不会被同步的,这一点需要注意一下。


24.11 配置管理远程命令

虽然我们可以使用cmd.run去远程执行命令,但是这样的效率太低,每次只能执行一条命令。所以我们需要批量远程执行命令来提高效率,实现批量远程执行命令我们需要使用到脚本,将这个脚本分发到各个minion端上执行,要执行这个脚本我们还得进行一些相应的配置。

1.在master上编辑一个子配置文件:

[root@server ~]# vim /srv/salt/shell_test.sls  # 增加以下内容
shell_test:
  cmd.script:
    - source: salt://test/example.sh  # 脚本文件的路径
    - user: root

2.创建模板脚本文件:

[root@server ~]# vim /srv/salt/test/example.sh
#!/bin/bash
touch /tmp/test.txt 
if [ ! -d /tmp/test ]
then
    mkdir /tmp/test
fi

3.更改top.sls内容:

[root@server ~]# vim /srv/salt/top.sls 
base:
  '*':
    - shell_test

3.执行以下命令测试一下能否在client上执行该脚本:

[root@server ~]# salt 'client' state.highstate

4.到client上检查是否有test.txt文件和test目录,有则代表测试成功:

[root@client ~]# ls -l /tmp/test.txt 
-rw-r--r-- 1 root root 0 1月  25 15:15 /tmp/test.txt
[root@client ~]# ll /tmp/test
总用量 0
[root@client ~]# 

24.12 配置管理计划任务

既然能够远程执行命令了,当然还得配置一下任务计划,毕竟很多场景下,都需要定时地重复去执行脚本或命令。

1.在master上编辑一个子配置文件:

[root@server ~]# vim /srv/salt/cron_test.sls
cron_test:
  cron.present:
    - name: /bin/touch /tmp/test_cron.txt  # 需要执行的命令,也可以执行一个脚本
    - user: root
    - minute: '*'   # 分
    - hour: 20   # 时
    - daymonth: '*'  # 日
    - month: '*'  # 月
    - dayweek: '*'  # 周

用法和crontab是一样的。

**注意:*** 需要用单引号引起来。当然我们还可以使用file.managed模块来管理cron,因为系统的cron都是以配置文件的形式存在的。想要删除该cron,需要增加:

cron.absent:
  - name: /bin/touch /tmp/test_cron.txt

两者不能共存,要想删除一个cron,那之前的present就得去掉,末尾会演示一下如何删除cron。

2.更改top.sls文件的内容:

[root@server ~]# vim /srv/salt/top.sls 
base:
  '*':
    - cron_test

3.执行以下命令测试一下能否在client上增加相应的任务计划:

[root@server ~]# salt 'client' state.highstate

4.到client上检查一下有没有增加相应的任务计划,如下,则是测试成功:

[root@client ~]# crontab -l
# Lines below here are managed by Salt, do not edit
# SALT_CRON_IDENTIFIER:/bin/touch /tmp/test_cron.txt
* 20 * * * /bin/touch /tmp/test_cron.txt
[root@client ~]# 

注:生成的那两行注释不能删除或改动,如果删除或改动了就无法被master端管理了,注释上也写明了do not edit。

删除cron,修改/srv/salt/cron_test.sls文件内容如下:

[root@server ~]# vim /srv/salt/cron_test.sls
cron_test:
  cron.absent:
    - name: /bin/touch /tmp/test_cron.txt

执行以下命令:

[root@server ~]# salt 'client' state.highstate

到client上检查一下是否已删除:

[root@client ~]# crontab -l
# Lines below here are managed by Salt, do not edit
[root@client ~]# 

可以看到,client上的cron已经删除。


24.13 其他命令

1.cp.get_file,拷贝master上的文件到客户端:

[root@server ~]# echo "This is test copy file" > /srv/salt/test/cp.txt
[root@server ~]# salt 'client' cp.get_file salt://test/cp.txt  /tmp/cp.txt
client:
    /tmp/cp.txt
[root@server ~]# 

到client上检查一下是否拷贝成功:

[root@client ~]# ls /tmp/cp.txt 
/tmp/cp.txt
[root@client ~]# cat !$
cat /tmp/cp.txt
This is test copy file
[root@client ~]# 

2.cp.get_dir 拷贝目录:

[root@server ~]# salt 'client' cp.get_dir salt://test/  /tmp/   # 会自动在客户端创建test目录,所以后面不要加test,如果写成 /tmp/test/  则会在/tmp/test/目录下又创建test
client:
    - /tmp//test/cp.txt
    - /tmp//test/example.sh
    - /tmp//test/example/example.txt
[root@server ~]# 

到client上检查一下是否拷贝成功:

[root@client ~]# ls /tmp/test
cp.txt  example  example.sh
[root@client ~]# 

3.显示存活的minion:

[root@server ~]# salt-run manage.up
- client
- server
[root@server ~]# 

4.命令行下执行master上的shell脚本:

[root@server ~]# salt 'client' cmd.script salt://test/example.sh
client:
    ----------
    pid:
        10600
    retcode:
        0
    stderr:
    stdout:
[root@server ~]# 

24.14 salt-ssh使用

salt-ssh不需要对客户端做认证,客户端也不用安装salt-minion或者启动什么服务,它类似ssh/expect。

1.安装salt-ssh:

[root@server ~]# yum install -y https://repo.saltstack.com/yum/redhat/salt-repo-latest-2.el7.noarch.rpm
[root@server ~]# yum install -y salt-ssh

2.编辑配置文件:

[root@server ~]# vim /etc/salt/roster  # 文件末尾加上以下内容
client:  # 主机名
  host: 192.168.77.128  # 需要登录的ip
  user: root  # 需要登录的用户
  passwd: 123456.   # 该用户的密码

3.执行以下命令测试一下能否远程执行命令:

[root@server ~]# salt-ssh --key-deploy '*' -r 'w'
client:
    ----------
    retcode:
        0
    stderr:
    stdout:
        [email protected]'s password: 
         16:05:59 up  4:31,  1 user,  load average: 0.00, 0.01, 0.05
        USER     TTY      FROM             LOGIN@   IDLE   JCPU   PCPU WHAT
        root     pts/0    192.168.77.1     11:35    9:35   0.30s  0.30s -bash
[root@server ~]# 

注:第一次执行的时候会自动把本机的公钥放到对方机器上,在这之后就可以把roster文件里面的密码给去掉了。