SaltStack--配置管理

朴灿烈づ我的快乐病毒、 2021-09-08 18:06 337阅读 0赞

# [SaltStack--配置管理][SaltStack--] #

# saltstack配置管理[\#][Link 1] #

## Saltstack状态模块[\#][Link 2] ##

远程执行模块的执行是过程式，而状态是对`minion`的一种描述和定义，管理人员不需要关系部署任务如何完成的，只需要描述`minion`的状态描述。  
它的和兴是写`sls(Salt State file)`文件，`sls`文件默认格式为`YAML`格式，并默认使用`jinja`模板，`jinja`是根据`django`的模板语言发展而来的语言，简单并强大，支持`for if`等循环语句。`salt state`主要用来描述系统，服务，配置文件的状态，常常被称为配置管理。

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

mysql-install:   #ID声明，必须唯一
      pkg.installed:   #state状态声明
        - pkgs:   #选项声明
          - mariadb:   #选项列表
          - mariadb-server
    
    说明：
    一个ID只能出现一次
    一个ID下相同模块只能使用一次
    一个ID下不可以使用多个不同模块

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

**模块帮助手册**

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

#列出所有状态模块
    [root@salt-master ~]# salt '*' sys.list_modules
    #查看指定模块的所有方法
    [root@salt-master ~]# salt '*' sys.list_state_functions pkg
    #查看指定模块的使用方法
    [root@salt-master ~]# salt '*' sys.state_doc pkg
    #查看指定模块的指定方法的用法
    [root@salt-master ~]# salt '*' sys.state_doc pkg.installed

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

### pkg软件模块[\#][Link 3] ###

[pkg模块官档][pkg]

`pkg.installed` 软件安装

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

php-install:
      pkg.installed:
        - pkgs:
          - php
          - php-mysql: ">=5.4.16"    #指定安装版本
          - php-pdo
          - php-cli

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

指定安装最新版本的软件

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

php-install:
      pkg.latest:
        - pkgs:
          - php
          - php-mysql
          - php-pdo
          - php-cli

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

### file文件模块[\#][Link 4] ###

[file模块官档][file]

`file.managed` 下发文件，确保文件存在

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# mkdir /srv/salt/base/files
    [root@salt-master ~]# cp /etc/httpd/conf/httpd.conf /srv/salt/base/files/
    [root@salt-master ~]# cat /srv/salt/base/apache_conf.sls
    apache-config:
      file.managed:
        - name: /etc/httpd/conf/httpd.conf
        - source: salt://files/httpd.conf
        - user: root
        - group: root
        - mode: 644
    
    说明：
    - name: 表示存放目的地址
    - source: 表示这个文件来自哪里（说明这个文件得提前准备）
    
    或者这样写，直接已目的地址命令ID，这样ID也表示目的地址
    [root@salt-master ~]# cat /srv/salt/base/apache_conf.sls
    /etc/httpd/conf/httpd.conf:
      file.managed:
        - source: salt://files/httpd.conf
        - user: root
        - group: root
        - mode: 644

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

小示例：
    [root@salt-master ~]# cat /srv/salt/base/test.sls
    /tmp/passwd_back:
      file.managed:
        - source: salt://files/passwd
        - user: root
        - group: root
        - mode: 644
    [root@salt-master ~]# cp /etc/passwd /srv/salt/base/files/
    [root@salt-master ~]# salt '*' state.sls test
    [root@salt-master ~]# salt '*' cmd.run "ls -l /tmp/passwd_back"
    salt-minion03:
        -rw-r--r-- 1 root root 2098 May 15 16:21 /tmp/passwd_back
    salt-minion02:
        -rw-r--r-- 1 root root 2098 May 15 16:21 /tmp/passwd_back
    salt-minion01:
        -rw-r--r-- 1 root root 2098 May 15 16:21 /tmp/passwd_back

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

`file.directory` 建立目录

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cat /srv/salt/base/directory.sls
    /tmp/saltdir:
      file.directory:
        - user: root
        - group: root
        - mode: 755
        - makedirs: True   #如果上一级目录不存在自动创建；类似（mkdir -p）
    
    [root@salt-master ~]# salt '*' state.sls directory
    [root@salt-master ~]# salt '*' cmd.run "ls -d /tmp/saltdir"
    salt-minion03:
        /tmp/saltdir
    salt-minion02:
        /tmp/saltdir
    salt-minion01:
        /tmp/saltdir

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

`file.recurse` 下发整个目录

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cat /srv/salt/base/httpd_conf_dir.sls
    httpd_conf_dir:
      file.recurse:
        - name: /etc/httpd/conf.d
        - source: salt://files/conf.d
        - file_mode: 600    #文件权限
        - dir_mode: 755    #目录权限
        - include_empty: True   #同步空目录
        - clean: True    #使用后minion与master保持一致
    
    [root@salt-master ~]# rsync -avh /etc/httpd/conf.d /srv/salt/base/files/

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

`file.symlink` 建立软链接

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cat /srv/salt/base/target_link.sls
    /etc/grub.cfg:
      file.symlink:
        - target: /etc/grub2.cfg
    
    [root@salt-master ~]# salt '*' state.sls target_link
    [root@salt-master ~]# salt '*' cmd.run "ls -l /etc/grub.cfg"
    salt-minion03:
        lrwxrwxrwx 1 root root 14 May 15 16:42 /etc/grub.cfg -> /etc/grub2.cfg
    salt-minion01:
        lrwxrwxrwx 1 root root 14 May 15 16:42 /etc/grub.cfg -> /etc/grub2.cfg
    salt-minion02:
        lrwxrwxrwx 1 root root 14 May 15 16:42 /etc/grub.cfg -> /etc/grub2.cfg

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

### service服务模块[\#][Link 5] ###

[service模块官档][service]

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cat /srv/salt/base/service_httpd.sls
    httpd:
      service.running:
        - name: httpd   #服务名称
        - enable: True    #开机自启动
        - reload: True    #允许重载配置文件，不写则是restart
    
    或者这样写
    [root@salt-master ~]# cat /srv/salt/base/service_httpd.sls
    httpd:   #即表示ID，又表示服务名
      service.running:
        - enable: True
        - reload: True

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

## 高级状态模块[\#][Link 6] ##

当我们想要不同的主机应用不同的配置，那么可以使用高级状态管理 `top file`  
来进行管理。可以通过正则，`grain`模块，或分组名，来进行匹配，再下一级是要执行的`state`文件

可以将我们的配置需求转换为`YAML`并在`Top file`文件中表示：

[![e981c333bf4524b85e14506d91824fc9.png][]][e981c333bf4524b85e14506d91824fc9.png 1]

`Top file`示例

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

base:
      '*': #通过正则去匹配所有minion
        - app.nginx
    
      webserver: #定义的分组名称
        - match: nodegroup
        - app.cron
    
      'os:centos':  #通过grains模块匹配
        - match: grains
        - nginx

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

`Top file` 高级状态的执行

[root@salt-master ~]# salt '*' state.highstate

## LAMP架构案例[\#][Link 7] ##

**说明**：该案例在`prod`环境配置

1）环境准备，定义`file_roots`环境

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# vim /etc/salt/master
    file_roots:
      base:
        - /srv/salt/base
      dev:
        - /srv/salt/dev
      prod:
        - /srv/salt/prod

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

2）创建对应环境目录

[root@salt-master ~]# mkdir -p /srv/salt/{base,dev,prod}
    [root@salt-master ~]# mkdir /srv/salt/prod/{httpd,php,mysql,files}

3）配置文件准备及测试文件准备

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cp /etc/my.cnf /srv/salt/prod/files/
    [root@salt-master ~]# cp /etc/httpd/conf/httpd.conf /srv/salt/prod/files/
    [root@salt-master ~]# cp /etc/php.ini  /srv/salt/prod/files/
    [root@salt-master ~]# echo "<h1>LAMP html</h1>" >>/srv/salt/prod/files/index.html
    [root@salt-master ~]# echo "<?php phpinfo(); ?>" >> /srv/salt/prod/files/index.php

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

4）编写`state sls`状态文件

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

#httpd
    [root@salt-master ~]# cat /srv/salt/prod/httpd/init.sls
    apache-install:
      pkg.installed:
        - pkgs:
          - httpd
          - httpd-tools
    
    apache-config:
      file.managed:
        - name: /etc/httpd/conf/httpd.conf
        - source: salt://files/httpd.conf
        - user: root
        - group: root
        - mode: 644
    
    apache-service:
      service.running:
        - name: httpd
        - enable: True
    
    #php
    [root@salt-master ~]# cat /srv/salt/prod/php/init.sls
    php-install:
      pkg.installed:
        - pkgs:
          - php
          - php-mysql
          - php-pdo
          - php-cli
    
    php-config:
      file.managed:
        - name: /etc/php.ini
        - source: salt://files/php.ini
        - user: root
        - group: root
        - mode: 644
    
    #mysql
    [root@salt-master ~]# cat /srv/salt/prod/mysql/init.sls
    mariadb-install:
      pkg.installed:
        - pkgs:
          - mariadb-server
          - mariadb
    
    mariadb-config:
      file.managed:
        - name: /etc/my.cnf
        - source: salt://files/my.cnf
        - user: root
        - group: root
        - mode: 644
    
    mariadb-service:
      service.running:
        - name: mariadb
        - enable: True
    
    #测试文件
    [root@salt-master ~]# cat /srv/salt/prod/testfile.sls
    /var/www/html/index.html:
      file.managed:
        - source: salt://files/index.html
    
    /var/www/html/index.php:
      file.managed:
        - source: salt://files/index.php

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

6）`topfile`文件编写

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cat /srv/salt/base/top.sls
    prod:
      'salt-minion*':
        - httpd.init
        - php.init
        - mysql.init
        - testfile

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

7）部署`LAMP`整体`state`文件查看

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

8）执行`topfile`

[root@salt-master ~]# salt '*' state.highstate

## States状态依赖[\#][Link 8] ##

通过上面的`lamp`可以看出已经可以使用`state`模块来定义`minion`的状态了，但是如果一个主机涉及多个状态，并且状态之间相互关联，在执行顺序上有先后之分，那么必须引用`requisites`来进行控制

**关系说明：**  
1、`require` 我依赖某个状态，我依赖谁  
2、`require_in` 我被某个状态依赖，谁依赖我  
3、`watch` 我关注某个状态，当状态发生改变，进行`restart`或者`reload`操作  
4、`watch_in` 我被某个状态关注  
5、`include` 我引用谁

1）修改上面`lamp`状态间依赖关系

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

#httpd
    [root@salt-master ~]# cat /srv/salt/prod/httpd/init.sls
    apache-install:
      pkg.installed:
        - pkgs:
          - httpd
          - httpd-tools
    
    apache-config:
      file.managed:
        - name: /etc/httpd/conf/httpd.conf
        - source: salt://files/httpd.conf
        - user: root
        - group: root
        - mode: 644
        - require:
          - pkg: apache-install   #表示上面apache-install执行成功，才能执行apache-config
    
    apache-service:
      service.running:
        - name: httpd
        - enable: True
        - require:
          - file: apache-config
        - watch:
          - file: apache-config
    
    #php
    [root@salt-master ~]# cat /srv/salt/prod/php/init.sls
    php-install:
      pkg.installed:
        - pkgs:
          - php
          - php-mysql
          - php-pdo
          - php-cli
        - reqiure_in:
          - file: php-config
    
    php-config:
      file.managed:
        - name: /etc/php.ini
        - source: salt://files/php.ini
        - user: root
        - group: root
        - mode: 644
    
    #mysql
    [root@salt-master ~]# cat /srv/salt/prod/mysql/init.sls
    mariadb-install:
      pkg.installed:
        - pkgs:
          - mariadb-server
          - mariadb
    
    mariadb-config:
      file.managed:
        - name: /etc/my.cnf
        - source: salt://files/my.cnf
        - user: root
        - group: root
        - mode: 644
        - require:
          - pkg: mariadb-install
    
    mariadb-service:
      service.running:
        - name: mariadb
        - enable: True
        - reload: True
        - require:
          - file: mariadb-config
        - watch:
          - file: mariadb-config

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

2）修改引用关系后`include`

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# tree /srv/salt/
    /srv/salt/
    ├── base
    │   └── top.sls
    ├── dev
    └── prod
        ├── files
        │   ├── httpd.conf
        │   ├── index.html
        │   ├── index.php
        │   ├── my.cnf
        │   └── php.ini
        ├── httpd
        │   └── init.sls
        ├── lamp.sls
        ├── mysql
        │   └── init.sls
        ├── php
        │   └── init.sls
        └── testfile.sls
    
    [root@salt-master ~]# cat /srv/salt/prod/lamp.sls
    include:
      - httpd.init
      - php.init
      - mysql.init
      - testfile
    
    [root@salt-master ~]# cat /srv/salt/base/top.sls
    prod:
      'salt-minion*':
        - lamp

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

3）编写`SLS`技巧

1、按照状态分类，如果单独使用，清晰明了
    2、按照服务分类，可以被其它SLS引用

## Jinja模板使用[\#][Link 9] ##

配置文件一般灵活多变，比如配置`apache`的`IP`地址或者端口`PORT`等，则可以动态传值。

[Jinja官档][Jinja]  
[salt jinja官档][salt jinja]

`Jinja2` 模板包含变量和表达式，变量用 \{ \{ … \}\} 包围，表达式用 \{% … %\} 包围。变量使用示例：

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cat /srv/salt/base/var.sls 
    {% set var= 'hello world!' %}
    test_var:
      cmd.run:
        - name: echo "测试变量 {
      { var }}"
    
    [root@salt-master ~]# salt 'salt-minion01' state.sls var
    salt-minion01:
    ----------
              ID: test_var
        Function: cmd.run
            Name: echo "测试变量 hello world!"
          Result: True
         Comment: Command "echo "测试变量 hello world!"" run
         Started: 14:50:58.302424
        Duration: 12.358 ms
         Changes:   
                  ----------
                  pid:
                      22510
                  retcode:
                      0
                  stderr:
                  stdout:
                      测试变量 hello world!
    
    Summary for salt-minion01
    ------------
    Succeeded: 1 (changed=1)
    Failed:    0
    ------------
    Total states run:     1
    Total run time:  12.358 ms

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

**`jinja2` 常用变量**

1、字符串类型

{% set var = 'test' %}  #定义变量
    {
      { var }}  #调用变量

2、列表类型

{% set list = ['one', 'two', 'three'] %}
    {
      { list[1] }}  #获取变量的第一个值

3、字典类型

{% set dict = {'key1':'value1', 'key2':'value2'} %}
    {
      { dict['key1'] }}  #获取'key1'的值

**示例1：**`Saltstack`使用`jinja`模块配置`apache`监听端口

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

#1.告诉file状态模块，需要使用jinja
        - template: jinja
    #2.列出参数列表
        - defaults:
          PORT: 8000
    #3.配置文件引用jinja模板
    {
      { PORT }}
    
    # 配置示例
    apache-config:
      file.managed:
        - name: /etc/httpd/conf/httpd.conf
        - source: salt://files/httpd.conf
        - user: root
        - group: root
        - mode: 644
        - template: jinja
        - defaults:
          PORT: 8000
    
    # 修改httpd.conf配置文件引用变量
    Listen {
      { PORT }}

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

**示例2：**使用`grinas` 方式进行赋值

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

#配置示例
    apache-config:
      file.managed:
        - name: /etc/httpd/conf/httpd.conf
        - source: salt://files/httpd.conf
        - user: root
        - group: root
        - mode: 644
        - template: jinja
        - defaults:
          PORT: 8000
          IPADDR: {
      { grains['fqdn_ip4'][0] }}
    
    # 修改httpd.conf配置文件引用变量
    Listen {
      { IPADDR }}:{
      { PORT }}

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

**示例3**：通过`jinja+grains`根据系统不同安装`apache`

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[root@salt-master ~]# cat /srv/salt/base/httpd.sls
    #根据grains获取的值判别系统后安装软件
    httpd-install:
      pkg.installed:
    {% if grains['os'] == 'CentOS' %}
        - name: httpd
    {% elif grains['OS'] == 'Debin' %}
        - name: apache2
    {% endif %}

![复制代码][48304ba5e6f9fe08f3fa1abda7d326ab.png]

[SaltStack--]: https://www.cnblogs.com/yanjieli/p/10877258.html
[Link 1]: https://www.cnblogs.com/yanjieli/p/10877258.html#saltstack%E9%85%8D%E7%BD%AE%E7%AE%A1%E7%90%86
[Link 2]: https://www.cnblogs.com/yanjieli/p/10877258.html#Saltstack%E7%8A%B6%E6%80%81%E6%A8%A1%E5%9D%97
[48304ba5e6f9fe08f3fa1abda7d326ab.png]: /images/20210908/2dab3b3ffe4344cd99f0983395e3b224.png
[Link 3]: https://www.cnblogs.com/yanjieli/p/10877258.html#pkg%E8%BD%AF%E4%BB%B6%E6%A8%A1%E5%9D%97
[pkg]: https://docs.saltstack.com/en/latest/ref/states/all/salt.states.pkg.html
[Link 4]: https://www.cnblogs.com/yanjieli/p/10877258.html#file%E6%96%87%E4%BB%B6%E6%A8%A1%E5%9D%97
[file]: https://docs.saltstack.com/en/latest/ref/states/all/salt.states.file.html
[Link 5]: https://www.cnblogs.com/yanjieli/p/10877258.html#service%E6%9C%8D%E5%8A%A1%E6%A8%A1%E5%9D%97
[service]: https://docs.saltstack.com/en/latest/ref/states/all/salt.states.service.html
[Link 6]: https://www.cnblogs.com/yanjieli/p/10877258.html#%E9%AB%98%E7%BA%A7%E7%8A%B6%E6%80%81%E6%A8%A1%E5%9D%97
[e981c333bf4524b85e14506d91824fc9.png]: /images/20210908/865aa72c4b9844e980f96d95991c054f.png
[e981c333bf4524b85e14506d91824fc9.png 1]: https://img2018.cnblogs.com/blog/1210730/201905/1210730-20190516180648149-974830225.png
[Link 7]: https://www.cnblogs.com/yanjieli/p/10877258.html#LAMP%E6%9E%B6%E6%9E%84%E6%A1%88%E4%BE%8B
[Link 8]: https://www.cnblogs.com/yanjieli/p/10877258.html#States%E7%8A%B6%E6%80%81%E4%BE%9D%E8%B5%96
[Link 9]: https://www.cnblogs.com/yanjieli/p/10877258.html#Jinja%E6%A8%A1%E6%9D%BF%E4%BD%BF%E7%94%A8
[Jinja]: http://docs.jinkan.org/docs/jinja2/
[salt jinja]: https://docs.saltstack.com/en/latest/topics/jinja/index.html