saltstack官方文档——Highstate data structure definitions
2013-04-18 14:12
741 查看
转自:http://docs.saltstack.com/ref/states/highstate.html#term-state-tree
The main state file that instructs minions what environment and modules to use during state execution.
Configurable via state_top.
See also
A detailed description of the top file
State treeA collection of SLS files that live under the directory specified in file_roots.
A state tree can be organized into SLS modules.
Defines a list of module reference strings to include in this SLS.
Occurs only in the top level of the highstate structure.
Example:
Defines an individual highstate component. Always references a value of a dictionary containing keys referencing state
declarations and requisite declarations. Can be overridden by a name
declaration or anames declaration.
Occurs on the top level or under the extend declaration.
Must be unique across entire state tree. If the same ID declaration is used twice, only the first one matched will be used. All subsequent ID declarations with the same name will be ignored.
Note
Naming gotchas
Until 0.9.6, IDs could not contain a dot, otherwise highstate summary output was unpredictable. (It was fixed in versions 0.9.7 and above)
Extends a name declaration from an included SLS module.
The keys of the extend declaration always define existing ID declarations which have been
defined in included SLS modules.
Occurs only in the top level and defines a dictionary.
Extend declarations are useful for adding-to or overriding parts of a state declaration that
is defined in anotherSLS file. In the following contrived example, the shown mywebsite.sls file is include -ing
and extend -ing theapache.sls module in order to add a watch declaration
that will restart Apache whenever the Apache configuration file, mywebsite changes.
A list which contains one string defining the function declaration and
any number of function arg declarationdictionaries.
Can, optionally, contain a number of additional components like the name override components — name andnames.
Can also contain requisite declarations.
Occurs under an ID declaration.
A list containing requisite references.
Used to build the action dependency tree. While Salt states are made to execute in a deterministic order, this order is managed by requiring and watching other Salt states.
Occurs as a list component under a state declaration or as
a key under an ID declaration.
A single key dictionary. The key is the name of the referenced state
declaration and the value is the ID of the referenced ID declaration.
Occurs as a single index in a requisite declaration list.
The name of the function to call within the state. A state declaration can contain only a single function declaration.
For example, the following state declaration calls the installed function
in the pkg state module:
The function can be declared inline with the state as a shortcut, but the actual data structure is better referenced in this form:
Where the function is a string in the body of the state declaration. Technically when the function is declared in dot notation the compiler converts it to be a string in the state declaration list. Note that the use of the first example more than
once in an ID declaration is invalid yaml.
INVALID:
When passing a function without arguments and another state declaration within a single ID declaration, then the long or "standard" format needs to be used since otherwise it does not represent a valid data structure.
VALID:
Occurs as the only index in the state declaration list.
A single key dictionary referencing a Python type which is to be passed to the named function
declaration as a parameter. The type must be the data type expected by the function.
Occurs under a function declaration.
For example in the following state declaration user, group, and mode are
passed as arguments to the managedfunction
in the file state module:
Overrides the name argument of a state
declaration. If name is not specified the ID
declaration satisfies thename argument.
The name is always a single key dictionary referencing a string.
Overriding name is useful for a variety of scenarios.
For example, avoiding clashing ID declarations. The following two state declarations cannot both have/etc/motd as the ID declaration:
Another common reason to override name is if the ID declaration is long and needs to be referenced in multiple places. In the example below it is much easier to specify mywebsite than
to specify /etc/apache2/sites-available/mywebsite.com multiple times:
state declarations, each with its own name.
For example, given the following state declaration:
Once converted into the lowstate data structure the above state declaration will be expanded into the following three state declarations:
Highstate data structure definitions
THE SALT STATE TREE
Top fileThe main state file that instructs minions what environment and modules to use during state execution.
Configurable via state_top.
See also
A detailed description of the top file
State treeA collection of SLS files that live under the directory specified in file_roots.
A state tree can be organized into SLS modules.
Include declaration
Include declarationDefines a list of module reference strings to include in this SLS.
Occurs only in the top level of the highstate structure.
Example:
include: - edit.vim - http.server
Module reference
Module referenceThe name of a SLS module defined by a separate SLS file and residing on the Salt Master. A module namededit.vim is a reference to the SLS file salt://edit/vim.sls.ID declaration
ID declarationDefines an individual highstate component. Always references a value of a dictionary containing keys referencing state
declarations and requisite declarations. Can be overridden by a name
declaration or anames declaration.
Occurs on the top level or under the extend declaration.
Must be unique across entire state tree. If the same ID declaration is used twice, only the first one matched will be used. All subsequent ID declarations with the same name will be ignored.
Note
Naming gotchas
Until 0.9.6, IDs could not contain a dot, otherwise highstate summary output was unpredictable. (It was fixed in versions 0.9.7 and above)
Extend declaration
Extend declarationExtends a name declaration from an included SLS module.
The keys of the extend declaration always define existing ID declarations which have been
defined in included SLS modules.
Occurs only in the top level and defines a dictionary.
Extend declarations are useful for adding-to or overriding parts of a state declaration that
is defined in anotherSLS file. In the following contrived example, the shown mywebsite.sls file is include -ing
and extend -ing theapache.sls module in order to add a watch declaration
that will restart Apache whenever the Apache configuration file, mywebsite changes.
include: - apache extend: apache: service: - watch: - file: mywebsite mywebsite: file: - managed .. seealso:: watch_in and require_in Sometimes it is more convenient to use the :term:`watch_in` or :term:`require_in` syntax instead of extending another ``SLS`` file. :doc:`State Requisites </ref/states/requisites>`
State declaration
State declarationA list which contains one string defining the function declaration and
any number of function arg declarationdictionaries.
Can, optionally, contain a number of additional components like the name override components — name andnames.
Can also contain requisite declarations.
Occurs under an ID declaration.
Requisite declaration
Requisite declarationA list containing requisite references.
Used to build the action dependency tree. While Salt states are made to execute in a deterministic order, this order is managed by requiring and watching other Salt states.
Occurs as a list component under a state declaration or as
a key under an ID declaration.
Requisite reference
Requisite referenceA single key dictionary. The key is the name of the referenced state
declaration and the value is the ID of the referenced ID declaration.
Occurs as a single index in a requisite declaration list.
Function declaration
Function declarationThe name of the function to call within the state. A state declaration can contain only a single function declaration.
For example, the following state declaration calls the installed function
in the pkg state module:
httpd: pkg.installed
The function can be declared inline with the state as a shortcut, but the actual data structure is better referenced in this form:
httpd: pkg: - installed
Where the function is a string in the body of the state declaration. Technically when the function is declared in dot notation the compiler converts it to be a string in the state declaration list. Note that the use of the first example more than
once in an ID declaration is invalid yaml.
INVALID:
httpd: pkg.installedservice.running
When passing a function without arguments and another state declaration within a single ID declaration, then the long or "standard" format needs to be used since otherwise it does not represent a valid data structure.
VALID:
httpd: pkg: - installedservice:
- running
Occurs as the only index in the state declaration list.
Function arg declaration
Function arg declarationA single key dictionary referencing a Python type which is to be passed to the named function
declaration as a parameter. The type must be the data type expected by the function.
Occurs under a function declaration.
For example in the following state declaration user, group, and mode are
passed as arguments to the managedfunction
in the file state module:
/etc/http/conf/http.conf: file.managed: - user: root - group: root - mode: 644
Name declaration
Name declarationOverrides the name argument of a state
declaration. If name is not specified the ID
declaration satisfies thename argument.
The name is always a single key dictionary referencing a string.
Overriding name is useful for a variety of scenarios.
For example, avoiding clashing ID declarations. The following two state declarations cannot both have/etc/motd as the ID declaration:
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."
Another common reason to override name is if the ID declaration is long and needs to be referenced in multiple places. In the example below it is much easier to specify mywebsite than
to specify /etc/apache2/sites-available/mywebsite.com multiple times:
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
Names declaration
Names declarationExpands the contents of the containing state declaration into multiplestate declarations, each with its own name.
For example, given the following state declaration:
python-pkgs: pkg.installed: - names: - python-django - python-crypto - python-yaml
Once converted into the lowstate data structure the above state declaration will be expanded into the following three state declarations:
python-django: pkg.installed python-crypto: pkg.installed python-yaml: pkg.installed
LARGE EXAMPLE
Here is the layout in yaml using the names of the highdata structure components.<Include Declaration>: - <Module Reference> - <Module Reference> <Extend Declaration>: <ID Declaration>: [<overrides>] # standard declaration <ID Declaration>: <State Declaration>: - <Function> - <Function Arg> - <Function Arg> - <Function Arg> - <Name>: <name> - <Requisite Declaration>: - <Requisite Reference> - <Requisite Reference> # inline function and names <ID Declaration>: <State Declaration>.<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 Declaration>: - <Function> - <Function Arg> - <Name>: <name> - <Requisite Declaration>: - <Requisite Reference> <State Declaration>: - <Function> - <Function Arg> - <Names>: - <name> - <name> - <Requisite Declaration>: - <Requisite Reference>
相关文章推荐
- saltstack官方文档——Full list of builtin state modules
- saltstack官方文档——State Enforcement
- saltstack官方文档——The Top File
- Salt Stack 官方文档翻译 - 一个想做dba的sa - 博客频道 - CSDN.NET
- Saltstack安装和基础配置官方文档
- saltstack官方文档——Salt Syndic
- saltstack官方文档——Salt File Server
- saltstack state.sls 与 state.highstate
- saltstack官方文档——Configuring the Salt Master
- saltstack官方文档——Configuring the Salt Minion
- 自动化运维工具SaltStack - 多环境(使用记录【state.sls 与 state.highstate】)
- saltstack官方文档——File Server Client API
- saltstack官方文档——Full list of builtin execution modules
- Salt Stack 官方文档翻译
- saltstack的state.sls和state.highstate之区别
- saltstack的常用操作(二)---帮助文档的使用
- React官方文档--Lifting State Up
- DataBindingGuidegoogle官方文档翻译(下)
- C Datastructure 5 ---- stack
- Android HIDL 官方文档(四)—— 服务与数据转换(Services & Data Transfer)