Saltstack命令使用

salt命令组成结构

在命令行输入的命令都是执行模块，等到命令写入到文件中就叫做状态模块

#即可查看salt帮助

[root@master ~]# salt --help

Usage: salt [options] '<target>' <function> [arguments]

salt命令 参数 目标 salt模块的函数 远程执行的参数

#--summary参数显示salt命令的概要

[root@master ~]# salt --summary '*' cmd.run 'hostname'

slave:

    slave

-------------------------------------------

Summary

-------------------------------------------

# of Minions Targeted: 1

# of Minions Returned: 1

# of Minions Did Not Return: 0

-------------------------------------------

列出所有salt的sys模块

#与系统交互的sys模块

[root@master ~]# salt 'slave' sys.list_modules

slave:

    - acl

    - aliases

    - alternatives

    - archive

    - artifactory

    - blockdev

    - btrfs

    - buildout

    - cloud

    - cmd

    - composer

    - config

    - container_resource

    - cp

    - cron

    - data

    - defaults

    - devmap

    - disk

    - django

    - dnsmasq

    - dnsutil

    - drbd

    - elasticsearch

    - environ

    - etcd

远程执行命令模块

cmd是超级模块，所有shell命令都能执行

[root@master ~]# salt 'slave' cmd.run 'ps -ef|grep python'

slave:

    root        873      1  0 22:23 ?        00:00:01 /usr/bin/python -Es /usr/sbin/tuned -l -P

    root       1229      1  0 22:31 ?        00:00:00 /usr/bin/python /usr/bin/salt-minion

    root       1232   1229  0 22:31 ?        00:00:02 /usr/bin/python /usr/bin/salt-minion

    root       1345      1  0 23:17 ?        00:00:00 /usr/bin/python /usr/bin/salt-minion

    root       1346   1345  0 23:17 ?        00:00:00 /bin/sh -c ps -ef|grep python

    root       1348   1346  0 23:17 ?        00:00:00 grep python

远程安装nginx

#在minion上安装nginx

[root@master ~]# salt 'slave' pkg.install "nginx"

#检查pkg包的版本

[root@master ~]# salt 'slave' pkg.version "nginx"

#卸载minion上的nginx

[root@master ~]# salt 'slave' pkg.remove "nginx"

远程管理服务模块

管理服务是系统管理员的重要任务，通过salt管理minion服务会很简单，使用service模块

[root@master ~]# salt 'slave' service.start "nginx"

slave:

    True

[root@master ~]# salt 'slave' service.status "nginx"

slave:

True

[root@master ~]# salt 'slave' service.stop "nginx"

slave:

    True

与标准的Linux命令一样，salt的命令一样用法

--out控制salt命令结果输出的格式

JSON

[root@master ~]# salt --out=json '*' cmd.run_all 'hostname'
{
"slave": {
"pid": 11780,
"retcode": 0,
"stderr": "",
"stdout": "slave"
}
}

YAML

[root@master ~]# salt --out=yaml '*' cmd.run_all 'hostname'
slave:
pid: 11774
retcode: 0
stderr: ''
stdout: slave

YAML讲解

在学习saltstack过程中，第一要点就是States编写技巧，简称SLS文件。这个文件遵循YAML语法。

json   xml    yaml    数据序列化格式

yaml容易被解析，应用于配置文件

Salt的配置文件是yaml配置文件，不能用tab

Saltstack、Kubernetes、Ansible都用的yaml格式配置文件

语法规则

    大小写敏感

    使用缩进表示层级关系   

    缩进时禁止tab键，只能空格

    缩进的空格数不重要，相同层级的元素左侧对其即可

    # 表示注释行

yaml支持的数据结构

    对象： 键值对，也称作映射 mapping 哈希hashes 字典 dict    冒号表示 key：value   key冒号后必须有

    数组： 一组按次序排列的值，又称为序列sequence 列表list     短横线  - list1

    纯量： 单个不可再分的值

对象：键值对

yaml

    first_key:

      second_key:second_value

python

    {

        'first_key':{

            'second_key':'second_value',

        }

    }

YAML是YAML Ain't Markup Language的首字母缩写，YAML的语法简单，
结构体通过空格展示
项目使用 '-' 代表
键值对通过 ':' 分割

YAML语法遵循固定的缩进风格，表示数据层级结构关系，saltstack需要每个缩进级别由2个空格组成，禁止用tabs！！！

Python中的字典是简单的键值对，go语言中称作哈希表map
字典的key通过冒号分割

key在YAML中表现形式是一个冒号结果的字符串
my_key: my_value
转化到python语法中，上述命令为
{'my_key':'my_value'}

value还可以通过缩进和key关联，四个空格！！
my_key:
    my_value
转化为python语法同样的
{'my_key':'my_value'}

YAML语法中字典是可以嵌套的
one_dict_key:
    two_dict_key:value_dict
转化为python语法

{
　　'one_dict_key':{
　　　　'two_dict_key':'value_dict'
　　}
}

短横杠

YAML语法表示列表，使用一个横杠加一个空格

多个项使用同样的缩进级别作为同一个列表的部分

- list_value_one

- list_value_two

- list_value_three
列表可以作为一个键值对的value，例如一次性要安装多个软件
my_dict:
  - l1
  - l2
  - l3
转化为python代码理解就是

{
　　'my_dict':['l1','l2',;l3]
}

目标定位字符串

　之前的salt命令我们都是使用 salt '*'控制所有minion，并且我们只有一个“slave”，但是生产环境的服务器很可能是成千上百的minion，因此需要灵活地定位所需的服务器并且执行远程命令。

1、全局匹配

[root@master ~]# salt '*' test.ping

slave:

    True

Linux通配符

*               代表任意字符，或空字符串

?               代表一个字符，不可以为空

[a-z] [0-9]     代表任何一个小写字母

[root@master ~]# salt 'slav?' test.ping

slave:

    True

[root@master ~]# salt '[a-z]lave' test.ping

slave:

True          

salt还支持python的re正则表达式

state模块定义主机状态

之前执行的远程命令，都是一个过程式的，类似一段shell或者python脚本执行，执行一次触发一次相同的功能。

那么大量的minion上运行远程命令就必须使用salt提供的“状态管理”了，状态是对minion的一种描述和定义，运维不需要关心部署是如何完成的，只需要描述minion需要达到什么状态。

接下来通过state模块部署nginx

master端

[root@master ~]# vim /etc/salt/master

#写入以下内容，必须严格遵循语法，空格

file_roots:
  base:
   - /srv/salt/base
  dev:
   - /srv/salt/dev
  test:
   - /srv/salt/test
  prod:
   - /srv/salt/prod

#此步骤在master和minion都需要执行，都需要创建文件夹

[root@master ~]# mkdir -p /srv/salt/{base,dev,test,prod}

[root@slave ~]# mkdir -p /srv/salt/{base,dev,test,prod}

#在master创建nginx.sls状态文件

[root@master ~]# cd /srv/salt/base

[root@master base]# vim nginx.sls

nginx-install:
  pkg.installed:
    - name: nginx
nginx-service:
  service.running:
    - name: nginx
    - enable: True

解释下nginx.sls描述文件

sls配置文件都遵循YAML语言描述

第一条命令使用了pkg.install安装命令，相对于运行了yum install，而此时state模块会判断nginx是否安装了，如果没有安装就进行安装，安装了就什么都不做。

状态描述都会遵循这个原则，只有检测到真实状态和所需状态不一就会执行此功能，这种性质叫做幂等性。

此时用state模块部署nginx软件，通过我们编写的nginx.sls描述性配置文件，命令行调用state模块的sls函数。

#启动命令，此时slave已经安装且存活了nginx，进行状态管理

[root@master base]# salt 'slave' state.sls nginx

slave:

----------

          ID: nginx-install

    Function: pkg.installed

        Name: nginx

      Result: True

     Comment: The following packages were installed/updated: nginx

     Started: 23:44:06.160157

    Duration: 13504.719 ms

     Changes:

通过master检查slave的nginx状态

[root@master base]# salt 'slave' cmd.run 'ps -ef |grep nginx'

slave:

    root      11190      1       0 23:44 ?        00:00:00 nginx: master process /usr/sbin/nginx

    nginx    11191  11190  0 23:44 ?        00:00:00 nginx: worker process

    root      11232  11231  0 23:50 ?        00:00:00 /bin/sh -c ps -ef |grep nginx

    root      11234  11232  0 23:50 ?        00:00:00 grep nginx

Salt采集静态信息之Grains

如果你入职了，你的老板让你收集公司300台服务器的相关硬件信息，你是一台台登录呢？还是选择用salt收集呢？又或者用python的salt-api写脚本呢

Grains 是saltstack组件中非常重要之一，在配置部署时候回经常使用，Grains记录minion的静态信息，比如常用属性，CPU、内存、磁盘、网络信息等。Minions的Grains信息是Minion启动时采集汇报给Master的
Grains是以 key  value形式存储的数据库，可以看做Host的元数据（metadata）
Grains保存着收集到的客户端的详细信息
如果slave机器数据变化，grains就过期了

在生产环境中需要自定义Grains，可以通过

Minion配置文件

Grains相关模块定义

Python脚本定义

#查看grains的命令用法

[root@master ~]# salt 'slave' sys.doc grains

Grains人为是描述minion本身固有的静态属性数据，列出主机所有Grains数据

[root@master ~]# salt 'slave' grains.items

slave:

    ----------

    SSDs:

    biosreleasedate:

        05/19/2017

    biosversion:

        6.00

cpu_flags:

.........

#信息过长，已经省略

#列出所有grains方法

[root@master ~]# salt 'slave' grains.ls 

检索某些数据

[root@master ~]# salt 'slave' grains.item os id host

slave:

    ----------

    host:

        slave

    id:

        slave

    os:

        CentOS

利用Grains静态信息定位主机

两种写法：
salt '*' grains.item key1 key2 key3

salt '*' -G

#定位CentOS的机器

[root@master ~]# salt -G 'os:CentOS' test.ping

slave:

True

#定位操作系统系统是7系列的机器

[root@master ~]# salt -G 'osrelease:7*' test.ping

slave:

    True

#找出IP地址

[root@master ~]# salt '*' grains.item fqdn_ip4

slave:

    ----------

    fqdn_ip4:

        - 192.168.1.78

因此用grains.items列出所有的数据匹配主机，以及根据单一信息定位数据，Grains还可以自定义来满足不同的需求。

自定义设置Grains数据

#设置数据

[root@master ~]# salt 'slave' grains.setval cpu_num 8

slave:

    ----------

    cpu_num:

        8

#查询数据

[root@master ~]# salt 'slave' grains.item cpu_num

slave:

    ----------

    cpu_num:

        8

在master端设置Grains静态数据，原理会将此数据添加到minion服务器的配置文件的/etc/salt/grains

[root@slave ~]# cat /etc/salt/grains

cpu_num: 8

对于复杂的数据结构，可以添加灵活的JSON语法

[root@master ~]# salt 'slave' grains.setval cpu_info '["Intel","Xeon","10"]'

slave:

    ----------

    cpu_info:

        - Intel

        - Xeon

        - 10

[root@master ~]# salt 'slave' grains.item cpu_info

slave:

    ----------

    cpu_info:

        - Intel

        - Xeon

        - 10

此时可以检查minion服务器上的grains文件

[root@slave ~]# cat /etc/salt/grains

cpu_info:

- Intel

- Xeon

- '10'

cpu_num: 8

因此Grains数据写入配置文件后，重启salt-minion服务，数据也不会丢失

想要删除可以通过grains.delval命令删除，或者去minion的配置文件删除配置一样完成操作（或者删除文件）

1、方法一（清空值）

[root@master ~]# salt 'slave' grains.delval cpu_info

slave:

    None

[root@master ~]# salt 'slave' grains.delval cpu_num

slave:

    None

2、方法二（删除minion的grains配置文件，重启服务）

[root@slave ~]# rm -rf /etc/salt/grains

[root@slave ~]# systemctl restart salt-minion

#检查结果删除成功

数据管理中心之Pillar组件

Pillar也是saltstack组件中非常重要的组件之一，称作数据管理中心，经常配合states在大规模的配置管理中使用。

Pillar是动态的，存储在master端，提供和给minion端

Pillar在SaltStack中主要的作用是存储和定义配置管理中需要的一些数据，比如软件版本号，用户账号密码等，保证敏感数据不被其他minion看到

存储格式与Grains类似，都是YAML格式

在master配置文件中有一段Pillar settings选项专门定义Pillar的参数

[root@master ~]# vim /etc/salt/master  

#此配置代表pillar的工作根目录，在/srv/pillar下，然后可以新建sls文件

#pillar_roots:

#  base:

#    - /srv/pillar

默认pillar的工作目录在/srv/pillar目录下，执行如下代码

[root@master ~]# mkdir -p /srv/pillar

#指定环境，标记，引用packages.sls和services.sls

[root@master ~]# vim /srv/pillar/top.sls

base:

  '*':

      - packages

      - services

[root@master ~]# vim /srv/pillar/packages.sls

nginx:

    packages-name: nginx

    version: 1.12.2

[root@master ~]# vim /srv/pillar/services.sls

nginx:

    port: 80

    user: root

检查我们设置的pillar值

[root@master ~]# salt '*' pillar.item nginx

slave:

    ----------

    nginx:

        ----------

        packages-name:

            nginx

        port:

            80

        user:

            root

        version:

            1.12.2

Pillar与Grains对比

Pillar与Grains对比

类型	数据采集方式	应用场景	定义位置
Grains	静态	minion启动时收集	数据查询、目标选择、配置管理、minion
Pillar	动态	master进行自定义	目标选择、配置管理、敏感数据、master

Python API调用SaltStack

SaltStack本身提供salt(usr/bin/salt)来交互管理，但是去服务器上敲命令肯定不是一个长远之计，这时候python就体现了nb的功能。

Python API就是给Python提供的API使用，需要在SaltStack master上运行

实例代码

[root@master ~]# python

Python 2.7.5 (default, Aug  4 2017, 00:39:18)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-16)] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import salt.client

>>> local = salt.client.LocalClient()

>>> local.cmd('*','cmd.run',['hostname']) #向所有minion发送命令

{'slave': 'slave'}

因此python API就是提供了向saltstack发送命令的入口。

通过API获取saltstack的配置文件

获取master配置文件

>>> import salt.config #导入salt配置模块

>>> salt.config.client_config('/etc/salt/master') #读取salt配置文件，得到一个字典数据

获取minion配置文件

>>> import salt.client

>>> salt.config.minion_config('/etc/salt/minion') #读取minion配置文件，得到字典数据，通过字典方法可以查看信息

Python API介绍

/usr/bin/salt默认使用的接口是LocalClient，该接口只能在salt master上使用

[root@master ~]# python

Python 2.7.5 (default, Aug  4 2017, 00:39:18)

[GCC 4.8.5 20150623 (Red Hat 4.8.5-16)] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import salt.client

>>> local = salt.client.LocalClient()

>>> local.cmd('*','cmd.run',['hostname']) #向所有minion发送命令

{'slave': 'slave'}

逐条返回结果，local.cmd_iter()

>>> ret=local.cmd_iter('*','test.ping')

>>> ret

<generator object cmd_iter at 0x2b084b0>

>>> for i in ret:

...     print i

...

{'slave': {'retcode': 0, 'ret': True}}

菲波那切数列

>>> local.cmd('*','test.fib',[10])

{'slave': [[0, 1, 1, 2, 3, 5, 8], 2.1457672119140625e-06]}

检查minion服务器信息

>>> local.cmd('*','cmd.run',['hostname'])

{'slave': 'slave'}

>>> local.cmd('*','cmd.run',['ifconfig'])

>>> local.cmd('*','cmd.run',['crontab -l'])

>>> local.cmd('*','cmd.run',['df -h'])

启停minion的服务，如nginx

>>> local.cmd('*','service.stop',['nginx'])

{'slave': True}

>>> local.cmd('*','service.status',['nginx'])

{'slave': False}

>>> local.cmd('*','service.start',['nginx'])

{'slave': True}