saltstack 的日常使用（一）

更多关注：http://www.mknight.cn/

安装

yum install salt-master
or
yum install salt-minion

启动

systemctl start salt-master
or
/etc/init.d/salt-master start

基本命令

salt-key

salt-key命令用来管理master上所有的密钥的；列出master上的密钥：

salt-key -L

salt-key -a 接受一个minion的认证

salt-key -a minion.saltstack.com

接受所有未验证的钥匙

salt-key -A

test.ping确认一个minion是否连接正常

salt '*' test.ping

是指向所有minions的目标。
test.ping告诉minion运行test.ping函数。
运行这条命令的结果将会是master指示所有的minions并行执行test.ping并返回结果。
这不是真正的ICMP ping，而是一个简单的函数返回True。使用test.ping是确认一个minion是否连接正常

disk.usage

salt '*' disk.usage

network.interfaces

salt '*' network.interfaces

cmd.run

使用cmd.run远程执行命令,cmd是模块，run是cmd模块的一个方法

salt '*' cmd.run 'df -h'

查看hosts

salt '*' cmd.run "grep salt /etc/hosts"
mq:
    192.168.1.31 salt
owncloud:
    192.168.1.31    salt
docker:
    192.168.1.31 salt
dev.db:
    192.168.1.31 salt

批量修改hosts

salt '*' cmd.run "sed -i 's/192.168.1.30/192.168.1.31/' /etc/hosts"

pkg

pkg 函数会自动将本地系统包管理器映射到相同的salt函数。这意味着 pkg.install 在基于Red Hat系统上将使用 yum 而在Debian系统上则使用 apt 来安装包，等等。

 salt 'salt-minion' pkg.install vim

匹配主机

  • 普通匹配
匹配所有 '*'
匹配单个  'minion_id'
  • 正则匹配
    使用-E ，--pcre 进行正则匹配
salt -E '^stack-node\w+'  cmd.run "free -m"

返回结果：

stack-node01:

                 total       used       free     shared    buffers     cached

    Mem:          1877        377       1499          0         27        223

    -/+ buffers/cache:        126       1751

    Swap:         4095          0       4095

stack-node02:

                 total       used       free     shared    buffers     cached

    Mem:          1877        377       1499          0         28        223

    -/+ buffers/cache:        125       1751

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

stack-node02:

                 total       used       free     shared    buffers     cached

    Mem:          1877        376       1501          0         28        223

    -/+ buffers/cache:        123       1753

    Swap:         4095          0       4095

stack-node01:

                 total       used       free     shared    buffers     cached

    Mem:          1877        378       1499          0         28        223

    -/+ buffers/cache:        126       1751

    Swap:         4095          0       4095
  • IP匹配
    -S，--ipcidr,根据被控主机的IP地址或IP子网进行匹配
[root@stack-master ~]# salt -S 172.16.202.0/24  cmd.run "free -m"

stack-master:

                 total       used       free     shared    buffers     cached

    Mem:          1877        676       1201          0         30        225

    -/+ buffers/cache:        420       1457

    Swap:         4095          0       4095

stack-node01:

                 total       used       free     shared    buffers     cached

    Mem:          1877        378       1498          0         28        223

    -/+ buffers/cache:        126       1751

    Swap:         4095          0       4095

stack-node02:

                 total       used       free     shared    buffers     cached

    Mem:          1877        376       1500          0         28        223

    -/+ buffers/cache:        123       1753

    Swap:         4095          0       4095

配置管理

SLS（代表SaLt State文件）是Salt State系统的核心。SLS描述了系统的目标状态，由格式简单的数据构成。这经常被称作配置管理。

top.sls

top.sls 是配置管理的入口文件，一切都是从这里开始，在master 主机上，默认存放在/srv/salt/目录.
top.sls 默认从 base 标签开始解析执行,下一级是操作的目标，可以通过正则，grain模块,或分组名,来进行匹配,再下一级是要执行的state文件，不包换扩展名。
创建 /srv/salt/top.sls

#正则匹配
base:
  '*':
    - webserver
#组匹配
base:
  group1:
    - match: nodegroup
    - webserver
#grain匹配，必须要有- match: grain
base:
  'os:Fedora':
    - match: grain
    - webserver

准备好top.sls文件后，编写一个state文件

#/srv/salt/webserver.sls
apache:                 # 标签定义
  pkg:                  # state declaration
    - installed         # function declaration
  • 第一行被称为（ID declaration） 标签定义，在这里被定义为安装包的名。注意：在不同发行版软件包命名不同,比如 fedora 中叫httpd的包 Debian/Ubuntu中叫apache2
  • 第二行被称为（state declaration）状态定义， 在这里定义使用（pkg state module）
  • 第三行被称为（function declaration）函数定义， 在这里定义使用（pkg state module）调用 installed 函数

最后可以在终端中执行命令来查看结果：

salt '*' state.highstate

或附件 test=True参数 测试执行

salt '*' state.highstate -v test=True

主控端对目标主机（targeted minions）发出指令运行state.highstatem模块，目标主机首先会对top.sls下载，解析，然后按照top.sls内匹配规则内的定义的模块将被下载,解析,执行，然后结果反馈给 master.

SLS文件

注意在以上的例子中,SLS文件 webserver.sls 被简称为webserver. SLS文件命名空间有如下几条基本的规则：

1、SLS文件的扩展名 .sls 被省略。 (例如. webserver.sls 变成 webserver)
2、子目录可以更好的组织,每个子目录都由一个点来表示.(例如 webserver/dev.sls 可以简称为 webserver.dev）
3、如果子目录创建一个init.sls的文件，引用的时候仅指定该目录即可. (例如 webserver/init.sls 可以简称为 webserver）
4、如果一个目录下同时存在webserver.sls 和 webserver/init.sls，那么 webserver/init.sls 将被忽略，SLS文件引用的webserver将只引用webserver.sls
示例：

apache/init.sls
apache/httpd.conf
ssh/init.sls
ssh/server.sls
ssh/banner
ssh/ssh_config
ssh/sshd_config

创建一个引用这些目录的 server.sls

server:
  - apache
  - ssh
  - ...

state的层级关系

include

include 包含某个state文件
/srv/salt/apache.sls

apache:
  pkg:
    - installed
  service:
    - running
    - require:
      - pkg: apache

使用 include 可以包换有state文件而不必重新写
/srv/salt/apache-custom.sls

include:
  apache

extend

extend 与include配合使用，作用是 修改，或扩展引用的state文件的某个字段
/srv/salt/apache.sls

apache:
  pkg:
    - installed
  service:
    - running
    - require:
      - pkg: apache

extend默认是替换引用文件的某个字段的属性，简单说就是先加载，再修改部分字段。如例
/srv/salt/apache-change.sls

include:
  - apache
extend：
  apache
    pkg:
      - name: vim
      - installed

当extend与watch，或require结合使用的时候，则是扩展某个字段的属性。如例：
/srv/salt/apache-custom.sls

include:
  - apache
extend：
  apache
    service:
      - watch:
        - file: /etc/redis.conf

state的逻辑关系列表

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

state的逻辑关系实例

require：依赖某个state，在运行此state前，先运行依赖的state，依赖可以有多个.
先检查依赖，再运行其他。

httpd:                                  # maps to "name"
  pkg:
    - installed
  file：                                # maps to State module  filename
    - managed:                          # maps to the managed function in the file State module
    - name: /etc/httpd/conf/httpd.conf  # one of many options passed to the manage function
    - source: salt://httpd/httpd.conf
    - require:
      - pkg: httpd

watch：在某个state变化时运行此模块，watch除具备require功能外，还增了关注状态的功能。检查是否有变化为前提条件。

redis:
  pkg:
    - latest
  file.managed:
    - source: salt://redis/redis.conf
    - name: /etc/redis.conf
    - require:
      - pkg: redis
  service.running:
    - enable: True
    - watch:
      - file: /etc/redis.conf
      - pkg: redis

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

vim:
  pkg.installed:
    - order: 1

想让某个state最后一个运行，可以用last.

环境变量

示例：

file_roots:
  base:
    - /srv/salt/
  dev:
    - /srv/salt/dev/services
    - /srv/salt/dev/states
   prod:
     - /srv/salt/prod/services
     - /srv/salt/prod/states

state.sls默认的运行环境是base环境，但是它并不读取top.sls（top.sls定义了运行环境以及需要运行的sls）。关于state.sls的官方文档说明如下：

salt.modules.state.sls(mods, saltenv='base', test=None, exclude=None, queue=False, env=None,**kwargs)

这里saltenv指的是运行环境，默认是base环境。

state.highstate: 这个是全局的所有环境，以及所有状态都生效。它会读取每一个环境的top.sls，并且对所有sls都生效。

state.sls也可以指定读取哪个环境：

state.sls  salt_env='prod' xxxx.sls

这个xxxx.sls可以不在top.sls中记录。

模板

使用模板可以精简sls，使sls文件可以使用Python的循环，判断等逻辑。
示例：

{% for item in ['tmp','test'] %}
/opt/{{ item }}:
  file.directory:
    - user: root
    - group: root
    - mode: 755
    - makedirs: True
{% endfor %}

httpd:
  pkg.managed:
{% if grains['os'] == 'Ubuntu' %}
    - name: apache2
{% elif grains['os'] == 'CentOS' %}
    - name: httpd
{% endif %}
    - installed

使用的步骤比较简单：
1.File状态使用template参数 - template: jiaja
2.模板文件里面使用{{名称}}
3.File状态模块要指定变量列表

- defaults:
  PORT:8080

示例：

[root@linux-node1 base]# cd /srv/salt/base/
[root@linux-node1 base]# vim dns.sls
/etc/resolv.conf:
  file.managed:
    - source: salt://files/resolv.conf
    - user: root
    - group: root
    - mode: 644
    - template: jinja
    - defaults:
      DNS_SERVER: 10.0.0.2
[root@linux-node1 base]# vim files/resolv.conf
###hehe
nameserver {{ DNS_SERVER }}
[root@linux-node1 base]# salt '*' state.highstate

语法

YAML语法

规则一：缩进

YAML使用一个固定的缩进风格表示数据层结构关系，Saltstack需要每个缩进级别由两个空格组成。一定不能使用tab键

规则二：冒号

YAML：
mykey: my_value
每个冒号后面一定要有一个空格（以冒号结尾不需要空格，表示文件路径的模版可以不需要空格）

规则三：短横线

想要表示列表项，使用一个短横杠加一个空格。多个项使用同样的缩进级别作为同一个列表的一部分。

my_dictionary:
  - list_value_one
  - list_value_two
  - list_value_three

更多关注：http://www.mknight.cn/

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 157,198评论 4赞 359
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 66,663评论 1赞 290
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 106,985评论 0赞 237
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 43,673评论 0赞 202
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 51,994评论 3赞 285
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 40,399评论 1赞 211
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 31,717评论 2赞 310
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 30,407评论 0赞 194
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 34,112评论 1赞 239
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,371评论 2赞 241
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,891评论 1赞 256
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 28,255评论 2赞 250
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 32,881评论 3赞 233
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,010评论 0赞 8
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,764评论 0赞 192
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 35,412评论 2赞 269
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 35,299评论 2赞 260

推荐阅读更多精彩内容

  • SaltStack学习
    学习地址[http://tech.mainwise.cn/?p=438] 更新于 3.25 23:16 salt简...
    J书越来越垃圾了阅读 30,757评论 9赞 36
  • salt实战系列-state语法学习
    本文参考：Saltstack SLS文件解读 前言：state是salt最核心的功能，通过预先制定好的sls文件对...
    撸大师阅读 2,164评论 0赞 2
  • 西藏游记—第一站：成都杜甫草堂
    西藏是我一直以来的梦想。趁着假期终于可以去西藏完成梦想了！喜欢西藏的朋友可以关注我。随我一起去感受西藏的无限风光！...
    孙家二小姐阅读 504评论 0赞 1
  • 悲伤临近
    有时候人会突然伤悲，不是因为倒了一霉，而且悲伤就这么来了。 那颗柔软的心啊，就像激流中的一颗小石头，被流水无情的拨...
    你当时咋想的阅读 741评论 0赞 0
  • 甜蜜的印记
    小汤姆望着月亮，问：为什么月亮缺了一角？满是蛀牙的汤姆叔叔说，月亮也许糖吃多了，她甜蜜过了头，蛀牙把她咬了一口，那...
    拂晓的星阅读 149评论 0赞 0