saltstack的深入-highstate概念
一、初识 1、HIGHSTATE 数据结构的定义 1）salt状态树（THE SALT STATE TREE） 状态树（state tree） 指的是在file_roots中定义的目录下分类保存，供模块（module）调用的那些sls文件。 2）入口文件（TOP FILE） 一个入口状态（state）文件 可以在state执行时指示 minions 在什么环境（env）和模块（module）下使用 3）包含申明（INCLUDE DECLARATION） 定义一个列表，包括要引用的模块名称。 生效：位于highstate的顶层（top level） 举例： include: - edit.vim - http.server 4）模块引用（MODULE REFERENCE） sls模块名称。例如模块名“edit.vim”代表 salt://edit/vim.sls 这个sls文件，位于Salt Master上file_roots下定义的路径（默认是/srv/salt/）/srv/salt/edit/vim.sls 5）ID申明（ID DECLARATION） 定义一个独立的 highstate 组件（component），包括State declaration 和 Requisite declaration中的key-value，可以被Name declaration 或 Names declaration覆盖。 生效：位于顶层或在Extend declaration下面一层 要求：在整个state tree中是唯一的，如果有多个同样的的id，则第一个被匹配的生效。 6）扩展申明（EXTEND DECLARATION） 扩展某个要include的sls模块中的 Name declaration，这个扩展模块中的key和要include的那个sls模块中的ID declaration关联一致。 生效：位于顶层，定义了一个字典 注意：在一个单独的state运行时只能被扩展一次。 7）状态申明（STATE DECLARATION） 一个列表，包括一个字符串代表了函数申明（Function declaration），和多个函数的参数申明（Function arg declaration）的字典（dict） 可以包括许多附加组件（component），例如名称覆盖组件（name和names），必要条件申明（requisite declarations） 生效：位于ID declaration下面一层 8）必要条件申明（REQUISITE DECLARATION） 包括一系列的必要条件，用来建立行为依赖树（the action dependency tree）。 Salt的状态同步执行时是有一个明确的顺序，这个顺序的确定，需要依赖和观察（ requiring and watching ）其他的状态（Salt states） 生效：位于ID declaration下面一层，作为一个组件列表或者一个key Occurs as a list component under a State declaration or as a key under an ID declaration. 9）必要条件引用（REQUISITE REFERENCE） 一个单独的字典，key和State declaration一致，value和ID declaration一致 生效：位于Requisite declaration下面一层 10）函数申明（FUNCTION DECLARATION） 要调用的函数名称。 生效： 注意：一个状态申明（state declaration）只能包括一个函数申明 举例：在状态模块（state module）pkg中调用函数“installed”： httpd: pkg.installed: [] 函数和状态在一行（inline）被简短的申明。实际上，数据结构被编译成这样： httpd: pkg: - installed 函数是状态申明（state declaration）中的一个字符串。 从技术上而言，当函数以圆点记法“.”的方式申明时，编译器会转换成状态申明列表（state declaration list）中的一个字符串。 如下是错误的申明： httpd: pkg.installed service.running 当没有传参给函数， 且后续还有其他的状态申明，则要使用标准格式，否则将不是一个有效的数据结构。 这才是正确的： httpd: pkg.installed: [] service.running: [] 生效：位于State declaration下面一层 11）函数参数申明（FUNCTION ARG DECLARATION） 一个字典传递给函数 生效：位于Function declaration下面一层 举例：在下面的状态申明中， user, group, and mode 作为参数传递给函数“managed”： /etc/http/conf/http.conf: file.managed: - user: root - group: root - mode: 644 12）name申明（NAME DECLARATION） 重写一个状态申明中的name参数，如果未指定name，则“ID declaration”将作为name参数 举例：重写name的用法很多，如避免ID申明冲突，例如下面的例子中，2个状态申明不能同时将/etc/motd作为ID申明： motd_perms: file.managed: - name: /etc/motd - mode: 644 motd_quote: file.append: - name: /etc/motd - text: "Of all smells, bread; of all tastes, salt." 另一个通常的原因是，如果ID申明很长，又需要在多个地方引用。例如下面的例子，用mywebsite 来替代 /etc/apache2/sites-available/mywebsite.com即可： mywebsite: file.managed: - name: /etc/apache2/sites-available/mywebsite.com - source: salt://mywebsite.com a2ensite mywebsite.com: cmd.wait: - unless: test -L /etc/apache2/sites-enabled/mywebsite.com - watch: - file: mywebsite apache2: service.running: - watch: - file: mywebsite 13）names申明（NAMES DECLARATION） 将状态申明的内容展开为多个状态申明，每个都有自己的name 举例：有这样一个申明： python-pkgs: pkg.installed: - names: - python-django - python-crypto - python-yaml 转换成lowstate data structure 则变成： python-django: pkg.installed python-crypto: pkg.installed python-yaml: pkg.installed 通过一个附加的字典，可以在展开时改写一些值，例如： New in version 2014.7.0. ius: pkgrepo.managed: - humanname: IUS Community Packages for Enterprise Linux 6 - $basearch - gpgcheck: 1 - baseurl: http://mirror.rackspace.com/ius/stable/CentOS/6/$basearch - gpgkey: http://dl.iuscommunity.org/pub/ius/IUS-COMMUNITY-GPG-KEY - names: - ius - ius-devel: - baseurl: http://mirror.rackspace.com/ius/development/CentOS/6/$basearch 2、LARGE EXAMPLE 这是一个yaml的布局： <Include Declaration>: - <Module Reference> - <Module Reference> <Extend Declaration>: <ID Declaration>: [<overrides>] # 标准申明（standard declaration） <ID Declaration>: <State Module>: - <Function> - <Function Arg> - <Function Arg> - <Function Arg> - <Name>: <name> - <Requisite Declaration>: - <Requisite Reference> - <Requisite Reference> # 函数内嵌（inline function and names） <ID Declaration>: <State Module>.<Function>: - <Function Arg> - <Function Arg> - <Function Arg> - <Names>: - <name> - <name> - <name> - <Requisite Declaration>: - <Requisite Reference> - <Requisite Reference> # multiple states for single id <ID Declaration>: <State Module>: - <Function> - <Function Arg> - <Name>: <name> - <Requisite Declaration>: - <Requisite Reference> <State Module>: - <Function> - <Function Arg> - <Names>: - <name> - <name> - <Requisite Declaration>: - <Requisite Reference> ZYXW、参考 1、doc http://docs.saltstack.com/en/latest/ref/states/highstate.html
原文地址：http://nosmoking.blog.51cto.com/3263888/1677199
