Fork me on GitHub

saltstack进阶学习2

字数统计: 3k字   |   阅读时长≈ 13分

salt执行模块

运行shell命令

1
2
3
4
5
6
7
saltstack 支持在master上向client 远程执行命令，并显示命令执行的结果

命令格式：
        salt '<操作目标>'  <方法>  [参数]

#cmd.run可以执行所有shell命令
salt \* cmd.run 'w'     在所有主机上执行w命令(注*号需要转义)

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
[root@CentOS-20 ~]# salt  \*  cmd.run  "df -h"
CentOS-22:
    Filesystem      Size  Used Avail Use% Mounted on
    /dev/sda3        16G  1.6G   14G  11% /
    tmpfs           931M   12K  931M   1% /dev/shm
    /dev/sda1       190M   51M  129M  29% /boot
CentOS6-21:
    Filesystem      Size  Used Avail Use% Mounted on
    /dev/sda3        16G  1.6G   14G  11% /
    tmpfs           931M   12K  931M   1% /dev/shm
    /dev/sda1       190M   51M  129M  29% /boot
CentOS-20:
    Filesystem      Size  Used Avail Use% Mounted on
    /dev/sda3        16G  1.5G   14G  11% /
    tmpfs           931M   16K  931M   1% /dev/shm
    /dev/sda1       190M   51M  129M  29% /boot

状态模块

1
SaltStack使用现有的序列化系统来渲染sls数据。而这个现有的序列化系统就是YAML，而严格的YAML格式往往使现在正在学习SaltStack的同学屡屡掉坑。

YAML语法-参考

YAML语法规范

YAML文件格式-注意点

1
2
3
1.务必使用空格缩进，第二个层级比第一个层级多2个空格,2、4、6、8以此类推。
2. 每个层级使用冒号(:)表示结束
3. 横杠(-)表示同层级列表

环境

1
2
3
4
系统:CentOS6
192.168.56.20      角色：salt-master/salt-minion
192.168.56.21      角色：salt-minion
192.168.56.22      角色：salt-minion

salt-master主配置文件-修改

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
搜索“file_roots”快速定位到对应位置，添加如下：

file_roots:
  base:                #默认环境
    - /var/salt/base
  dev:
    - /var/salt/dev    #开发环境
  test:
    - /var/salt/test   #测试环境
  prod:
    - /var/salt/prod   #生产环境
     
作用：告诉salt-master去哪里查找状态模块文件,这里规划使用4个目录

创建目录：mkdir -p /var/salt/{base,dev,test,prod}
重启：/etc/init.d/salt-master restart
查看salt-master日志：tailf /var/log/salt/master

软件安装—通过salt安装apache

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
cd /var/salt/base     #进入salt状态模块目录
cat  apache.sls          #这里以安装apache为例，创建状态模块文件，后缀为.sls

apache-install:       #声明一个ID（整个salt架构里唯一）
  pkg.installed:      #pkg为状态模块；installed是方法
    - name: httpd     #该行表示installed的参数

apache-service:       #声明一个ID（整个salt架构里唯一）
  service.running:    #service为状态模块；running是方法 
    - name: httpd     #该行表示running的参数
    - enable: True    #该行表示running的参数
    
如上所示：所谓状态模块，首先检测apache是否已经安装，如果已经安装则跳过，否则将安装；后者为检测服务状态是否已经运行，运行则跳过否则将服务启动并添加为开机启动。   


启动运行模块：
salt \* state.sls apache          #在所有minion节点安装apache
注：执行状态文件的时候，状态文件一定不能添加.sls后缀,否则会出现错误


此时手动在192.168.56.22上面停止apache服务，再次在master上使用salt推送，观察输出结果
[root@CentOS-22 ~]# /etc/init.d/httpd stop
salt \* state.sls apache 

192.168.56.22的节点的执行结果是：
首先判断是否已经安装apache,发现有则跳过；再次判断httpd服务是否启动，发现没有启动，则只进行启动服务。
1
2
3
4
5
6
7
8
知识点-扩展：
如上面我们执行salt命令：salt \* state.sls apache  

如果apache.sls状态模块文件不在当前目录，而在其他目录，如何在当前目录执行salt命令呢？
cd  /var/salt/base  #确保在当前目录
mkdir  web -p       #在当前目录创建web子目录
mv apache.sls web/  #剪切到web子目录下
salt \* state.sls web.apache   #执行salt命令(注：最后是"目录.状态文件")
1
2
3
上面使用了state.sls 远程执行命令, state是模块，sls是state模块的一个方法

[root@stack-master ~]# salt \* state.sls web.apache

推送文件—编写批量更改dns的sls状态文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
(1)首先定义好resolv.conf配置文件并放到/var/salt/base/files/目录下

(2)创建dns.sls配置文件
[root@CentOS-20 base]# cd  /var/salt/base
[root@CentOS-20 base]# cat dns.sls 
dns-config:
  file.managed:
    - name: /etc/resolv.conf       #文件目标存放目录
    - source: salt://files/resolv.conf  
    - user: root                   #修改属主
    - group: root                  #修改属组
    - mode: 644                    #修改权限
    
注：
其中“salt://files/resolv.conf”指文件本地存放目录,而"salt://"表示master配置文件中指定的开发环境根路径

(3)执行
   [root@CentOS-20 base]# cd  /var/salt/base 
   salt \* state.sls dns                      #执行dns状态模块文件
   [root@CentOS-22 ~]# cat /etc/resolv.conf   #检查
   # Generated by NetworkManager
   nameserver 114.114.114.114
   nameserver 223.5.5.5
   nameserver 8.8.8.8

state模块-介绍

1
state模块是saltstack配置管理的核心内容，需要熟练掌握如下几个组件以及常用的方法，以后会常用。
  • file - 管理文件状态
1
2
3
4
5
6
7
常用方法：
file.managed：保证"文件"存在并且为对应的状态，不一样就根据source指定文件进行修改。
file.recurse: 保证"目录"存在并且为对应状态，否则change。
file.absent：确保"文件不存在"，如果存在就删除。

具体参考：https://docs.saltstack.com/en/latest/ref/states/all/salt.states.file.html#module-salt.states.file

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
递归管理整个目录--举例：

[root@linux-node1 web]# pwd
/var/salt/base/


[root@linux-node1 web]# cat lamp.sls 
apache-conf:
  file.recurse:
    - name: /etc/httpd/conf.d
    - source: salt://files/apache-conf.d
    
mkdir /var/salt/files/apache-conf.d
[root@linux-node1 ~]# cd /var/salt/files/apache-conf.d/
[root@linux-node1 apache-conf.d]# cp -a /etc/httpd/conf.d/* .

执行：salt \* state.sls lamp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
举例：

apache-conf:
  file.managed:
    - name: /etc/http/conf/http.conf
    - source: salt://apache/http.conf
    - user: root
    - group: root
    - mode: 644
    - template: jinja
    - defaults:
        custom_var: "default value"
        other_var: 123
{% if grains['os'] == 'Ubuntu' %}
    - context:
        custom_var: "override"
{% endif %}
1
2
3
4
5
6
7
8
9
/etc/foo.conf:
  file.managed:
    - source:
      - salt://foo.conf.{{ grains['fqdn'] }}
      - salt://foo.conf.fallback
    - user: foo
    - group: users
    - mode: 644
    - backup: minion
  • pkg - 管理软件包状态
1
2
3
4
5
6
7
常用方法：
pkg.installed： 确保软件包已经安装，如果没有安装就安装。
pkg.remove： 确保软件包已卸载，如果还是安装的，就卸载。
pkg.purge： 除remove外，还会删除其配置文件。
pkg.latest：  确保软件包是最近版本，如果不是就升级。

更多参考：https://docs.saltstack.com/en/latest/ref/states/all/salt.states.pkg.html#module-salt.states.pkg
1
2
3
4
5
6
7
8
9
10
举例：

apache-install:
  pkg.installed:
    - name: httpd

apache-service:
  service.running:
    - name: httpd
    - enable: True
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
举例：

[root@linux-node1 web]# pwd
/srv/salt/base/web
[root@linux-node1 web]# 
[root@linux-node1 web]# cat lamp.sls 
apache-conf:
  file.recurse:
    - name: /etc/httpd/conf.d
    - source: salt://web/files/apache-conf.d
    
mkdir /srv/salt/base/web/files/apache-conf.d
[root@linux-node1 ~]# cd /srv/salt/base/web/files/apache-conf.d/
[root@linux-node1 apache-conf.d]# cp -a /etc/httpd/conf.d/* .

执行：salt \* state.highstate
  • service - 管理服务状态
1
2
3
4
5
常用方法：
service.running: 确保服务处理运行状态，如果没有运行就启动。
service.dead： 确保服务没有在运行，如果运行就停止。
service.enabled： 设置服务保持开机启动。False或True
service.disabled： 设置服务不开机启动。
1
2
3
4
5
6
7
8
举例：

redis:
  service.running:
    - enable: True
    - reload: True
    - watch:
      - pkg: redis
  • cmd 远程执行命令
1
2
3
saltstack 支持在master上向client 远程执行命令，并显示命令执行的结果

命令格式：salt '<操作目标>'  <方法>  [参数]
1
2
3
示例：使用cmd.run远程执行命令, cmd是模块，run是cmd模块的一个方法

[root@stack-master ~]# salt '*'  cmd.run  "free -m"
  • 针对“操作目标” 进行进行过滤
1
有时候需要针对远程minion主机进行过滤，如何进行精确匹配呢？
1
2
3
4
普通匹配：

匹配所有 '*'
匹配单个  'minion_id'       #minion_id即为Python通过IP地址获取到的主机名称
1
2
3
4
5
6
7
8
9
10
11
(1)正则匹配：
   使用-E ，--pcre 进行正则匹配
   例如：[root@stack-master ~]# salt -E '^CentOS*' cmd.run "uptime"

(2)IP匹配：
   -S，--ipcidr,根据被控主机的IP地址或IP子网进行匹配
   [root@stack-master ~]# salt -S 192.168.56.0/24  cmd.run "free -m"

(3)列表匹配
   -L，--list,以主机id名列表的形式进行过滤，格式与Python的列表相似，即不同主机id 名称使用逗号分隔
   [root@stack-master ~]# salt -L 'stack-node01,stack-node02'  cmd.run "free -m"

实例：

1
要求：给网站web添加认证
1
2
3
4
5
6
7
8
9
10
11
(1)准备并配置httpd.conf文件, 并放在/var/salt/base/files目录下

<Directory "/var/www/html/admin"> 
    AllowOverride All
    Order allow,deny
    Allow from All  
    AuthUserFile  /etc/httpd/conf/htpasswd_file
    AuthName "hehe"                                
    AuthType Basic
    Require user admin
</Directory>
1
2
3
4
5
6
7
8
9
10
11
12
13
(2)编辑配置状态文件

vim  apache_auth_config.sls

apache-auth:
  pkg.installed:
    - name: httpd-tools

  cmd.run:
    - name: htpasswd -bc /etc/httpd/conf/htpasswd_file admin admin
    - unless: test -f /etc/httpd/conf/htpasswd_file
    - require:               
      - pkg: apache-auth      #使用require来声明执行顺序：如果apache-auth执行失败，则不执行cmd.run
1
2
(3) 执行
salt \* state.sls apache_auth_config

top.sls

也许你已经发现了，上面我们去执行状态模块文件的方式都是逐一去执行的。那么能否将所有状态模块文件一块执行呢？答案是肯定的

1
top.sls 是配置管理的入口文件，一切都是从这里开始，在master 主机上，默认存放在/srv/salt/目录,而我已将其定义在了/var/salt目录。

top.sls 文件格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#可以通过正则进行匹配
base:
  '*':
    - webserver
    
#可以通过分组名进行匹配，必须要有 - match: nodegroup
base:
  group1:
    - match: nodegroup
    - webserver
    
#也可以通过grain模块匹配，必须要有- match: grain
base:
  'os:Fedora':
    - match: grain
    - webserver
  • 编辑top.sls
1
2
3
4
5
6
7
8
cd  /var/salt/base
[root@CentOS-20 base]# cat top.sls      #编辑top.sls
base:
  '*':
    - apache
    - dns
    
注：我上面的top.sls内容配置需要与apache.sls和dns.sls在同一目录    
1
2
3
4
5
6
7
测试
salt '*' state.highstate
salt '*' state.highstate top
salt '*' state.highstate -v test=True      #测试执行

使用命令调用top.sls文件执行即可
注：这里必须使用highstate（高水平的state）

向文件追加内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
cd /var/salt/base

[root@CentOS-20 base]# cat  append.sls   #创建追加文件
/etc/profile:
  file.append:
    - text:          #注意:这里是text，不是test不是test不是test！
      - "#aaa"

#执行命令
salt \* state.sls append   

#minion检查结果
[root@CentOS6-21 ~]# tail /etc/profile    
alias grep='grep --color=auto'
alias ll='ls -l --color=auto --time-style=long-iso'
#aaa

state的逻辑关系列表及示例

1
2
3
4
5
match:   配模某个模块，比如 match: grain match: nodegroup

require：依赖某个state，在运行此state前，先运行依赖的state，依赖可以有多个
watch：  在某个state变化时运行此模块
order：  优先级比require和watch低，有order指定的state比没有order指定的优先级高

state的逻辑关系

  • require:

    依赖某个state，在运行此state前，先运行依赖的state，依赖可以有多个

1
2
3
4
5
6
7
8
9
10
httpd: # maps to "name"
  pkg:
    - installed
    
  file: 
    - managed: 
    - name: /etc/httpd/conf/httpd.conf
    - source: salt://httpd/httpd.conf
    - require:       #若pkg执行失败则不执行file
      - pkg: httpd

  • watch:

    在某个state变化时运行此模块，watch除具备require功能外，还增了关注状态的功能

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
redis:
  pkg:
    - latest
    
  file.managed:
    - name: /etc/redis.conf
    - source: salt://redis/redis.conf
    - require:
      - pkg: redis
      
  service.running:
    - enable: True
    - watch:
      - file: /etc/redis.conf
      - pkg: redis

  • order

    优先级比require和watch低，有order指定的state比没有order指定的优先级高

1
2
3
vim:
  pkg.installed:
    - order: 1

扫一扫，分享到微信

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia-plus根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true


不论我写了什么...
其实都是错的......