STATES TUTORIAL(第五部分)

Posted 孤独的海浪

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了STATES TUTORIAL(第五部分)相关的知识,希望对你有一定的参考价值。

EXTENDING EXTERNAL SLS DATA

扩展额外的sls数据,当一个sls文件需要被局部修改的时候,譬如当一个state文件需要添加watch条件的时候。


THE EXTEND DECLARATION

通过extend扩展sls数据,一般通过include导入一个ID declaration。
示例:

技术分享
 1 include:
 2   - http
 3   - ssh
 4 
 5 extend:
 6   apache:
 7     file:
 8       - name: /etc/httpd/conf/httpd.conf
 9       - source: salt://http/httpd2.conf
10   ssh-server:
11     service:
12       - watch:
13         - file: /etc/ssh/banner
14 
15 /etc/ssh/banner:
16   file.managed:
17     - source: salt://ssh/banner
View Code

(1)重写apache声明的file模块的name,source参数。
(2)为ssh-server声明的service模块添加一个依赖关系/etc/ssh/banner


EXTEND IS A TOP LEVEL DECLARATION

EXTEND是一个顶级的声明,所以一个sls文件中只能使用一个extend块。
错误的一个示例:

技术分享
 1 include:
 2   - http
 3   - ssh
 4 
 5 extend:
 6   apache:
 7     file:
 8       - name: /etc/httpd/conf/httpd.conf
 9       - source: salt://http/httpd2.conf
10 # Second extend will overwrite the first!! Only make one
11 extend:
12   ssh-server:
13     service:
14       - watch:
15         - file: /etc/ssh/banner
View Code

THE REQUISITE "IN" STATEMENT

在sls文件中使用IN语法
将上面的例子利用IN逻辑进行重写,这样显得逻辑更加清晰。

技术分享
1 include:
2   - ssh
3 
4 /etc/ssh/banner:
5   file.managed:
6     - source: salt://ssh/banner
7     - watch_in:
8       - service: ssh-server
View Code

解析:
上面的extend例子扩展ssh-server的service模块,添加一个watch依赖条件,而在下面的示例则添加了一个/etc/ssh/banner新的ID声明,利用watch_in与ssh-server关联起来,一个是在ID声明里面定义一个依赖,一个是声明一个新ID定义一个被依赖。

#####################################################################################

FAILHARD GLOBAL OPTION

failhard全局选项

有时候执行一个state文件的时候,除了执行使用require等有依赖关系的ID声明以外,我们可能需要定义一个全局选项,当这个ID声明执行失败的时候,整个state文件停止执行。

技术分享
1 /etc/yum.repos.d/company.repo:
2   file.managed:
3     - source: salt://company/yumrepo.conf
4     - user: root
5     - group: root
6     - mode: 644
7     - order: 1
8     - failhard: True
View Code

因为部署环境的基础一般建立在yum源上,所以当包源配置出现故障的时候,应当停止其他的state模块执行。


GLOBAL FAILHARD

在全局配置中使用FAILHARD选项

有时候我们可能想在执行所有state文件的时候,只要一个ID执行失败就停止其余的ID执行,这时候我们不需要在每一个
state中定义FAILHARD,可以在master配置文件中定义FAILHARD选项,作为全局配置。

#####################################################################################

HIGHSTATE DATA STRUCTURE DEFINITIONS

THE SALT STATE TREE

sls文件和目录被定义在file_roots里面,state tree下面的文件和目录名必须不包含点号。


TOP FILE

主state文件,用于引导minion执行时使用什么环境和模块,配置路径在master的配置文件中state_top选项。


INCLUDE DECLARATION

include出现在sls数据结构的最顶级
示例:

技术分享
1 include:
2   - edit.vim
3   - http.server
View Code

MODULE REFERENCE

sls模块文件作为一个独立的sls文件被定义,放在salt master里面,譬如edit.vim就会被通过salt://edit/vim.sls引用。


ID DECLARATION

作为highstate的一个组件,总是包含一个state声明和一个Requisite declaration,能被一个Name declaration或Names declaration重写。

位于顶层结构的下面或extend声明的下面。在整个状态树下ID声明必须是唯一的,如果有多个其余的会被忽略掉,只有第一个被使用,因为所有的ID声明在一个命名空间中。


EXTEND DECLARATION

在一个include的sls模块中extend一个name declaration的前提需要是这个name declaration在include进来的sls文件中已存在。

注意:
  (1)extend只位于顶层结构中
  (2)一个sls文件只能有一个extend扩展

在增加或重写State declaration的时候EXTEND DECLARATION是非常有用的,最常用的就是添加一个watch或require条件等。
示例:

技术分享
 1 include:
 2   - apache
 3 
 4 extend:
 5   apache:
 6     service:
 7       - watch:
 8         - file: mywebsite
 9 
10 mywebsite:
11   file.managed:
12     - name: /var/www/mysite
View Code

STATE DECLARATION

一个包含Function declaration和任意数目的Function arg declaration键值对形成的列表。
可选的,一些额外的组件,如重写部分,name和names,也可以包含一些requisite declarations,被放在ID declaration下面。


REQUISITE DECLARATION

必要的声明

用于构建依赖关系的必要部分,当state以一种特定的顺序进行执行的时候,它可以通过require和watch约束salt state文件的执行。作为 State declaration下的一个列表组件或ID declaration下的一个键。


REQUISITE REFERENCE

一个简单的键字典,键的名称是State declaration值是ID declaration


FUNCTION DECLARATION

函数声明被包含在state里面,一个state只能包含一个函数声明。
示例:

技术分享
1 httpd:
2   pkg.installed: []
View Code

或这样的内联格式

技术分享
1 httpd:
2   pkg:
3     - installed
View Code

当在一个ID声明中使用多个函数时,需要使用标准格式,如果参数没有也需要定义一个空列表。
示例:

技术分享
1 httpd:
2   pkg.installed: []
3   service.running: []
View Code

FUNCTION ARG DECLARATION 

函数参数定义

使用一个或多个简单的键值对作为参数传递给Function declaration。
示例:

技术分享
1 /etc/http/conf/http.conf:
2   file.managed:
3     - user: root
4     - group: root
5     - mode: 644
View Code

NAME DECLARATION

name定义

重写State declaration里面的name参数,如果name参数没有被定义的话,默认使用ID declaration。
示例:

技术分享
1 motd_perms:
2   file.managed:
3     - name: /etc/motd
4     - mode: 644
5 
6 motd_quote:
7   file.append:
8     - name: /etc/motd
9     - text: "Of all smells, bread; of all tastes, salt."
View Code

由于可能存在多个name参数值是相同的,这种情况下就不能使用ID declaration作为默认的name参数。

重写name参数的另一个原因可能是由于ID declaration太长了,不便于引用。
示例:

技术分享
 1 mywebsite:
 2   file.managed:
 3     - name: /etc/apache2/sites-available/mywebsite.com
 4     - source: salt://mywebsite.com
 5 
 6 a2ensite mywebsite.com:
 7   cmd.wait:
 8     - unless: test -L /etc/apache2/sites-enabled/mywebsite.com
 9     - watch:
10       - file: mywebsite
11 
12 apache2:
13   service.running:
14     - watch:
15       - file: mywebsite
View Code

NAMES DECLARATION

names参数定义

从一个State declaration扩展到多个state declarations的时候,可以使用names参数:

技术分享
1 python-pkgs:
2   pkg.installed:
3     - names:
4       - python-django
5       - python-crypto
6       - python-yaml
View Code

一旦转换成底层的数据结构会变成一下数据结构:

技术分享
1 python-django:
2   pkg.installed
3 
4 python-crypto:
5   pkg.installed
6 
7 python-yaml:
8   pkg.installed
View Code

可以通过设置额外的字典结构重写部分参数:
示例:

技术分享
 1 ius:
 2   pkgrepo.managed:
 3     - humanname: IUS Community Packages for Enterprise Linux 6 - $basearch
 4     - gpgcheck: 1
 5     - baseurl: http://mirror.rackspace.com/ius/stable/CentOS/6/$basearch
 6     - gpgkey: http://dl.iuscommunity.org/pub/ius/IUS-COMMUNITY-GPG-KEY
 7     - names:
 8         - ius
 9         - ius-devel:
10             - baseurl: http://mirror.rackspace.com/ius/development/CentOS/6/$basearch
View Code

添加了两个name参数,相当于设置了两个repo源。


LARGE EXAMPLE

一个较大的示例,一个使用yaml格式的数据格式:

技术分享
 1 <Include Declaration>:
 2   - <Module Reference>        #模块函数,state modules
 3   - <Module Reference>
 4 
 5 <Extend Declaration>:        #重写已存在的ID declaration
 6   <ID Declaration>:
 7     [<overrides>]
 8 
 9 
10 # standard declaration
11 
12 <ID Declaration>:
13   <State Module>:
14     - <Function>
15     - <Function Arg>
16     - <Function Arg>
17     - <Function Arg>
18     - <Name>: <name>
19     - <Requisite Declaration>:
20       - <Requisite Reference>
21       - <Requisite Reference>
22 
23 
24 # inline function and names
25 
26 <ID Declaration>:
27   <State Module>.<Function>:
28     - <Function Arg>
29     - <Function Arg>
30     - <Function Arg>
31     - <Names>:
32       - <name>
33       - <name>
34       - <name>
35     - <Requisite Declaration>:
36       - <Requisite Reference>
37       - <Requisite Reference>
38 
39 
40 # multiple states for single id
41 
42 <ID Declaration>:
43   <State Module>:
44     - <Function>
45     - <Function Arg>
46     - <Name>: <name>
47     - <Requisite Declaration>:
48       - <Requisite Reference>
49   <State Module>:
50     - <Function>
51     - <Function Arg>
52     - <Names>:
53       - <name>
54       - <name>
55     - <Requisite Declaration>:
56       - <Requisite Reference>
View Code

以上是一个相当全的一个模板示例,但是具体的使用方法还需要参考具体的模块和参数的使用方法。

 


















以上是关于STATES TUTORIAL(第五部分)的主要内容,如果未能解决你的问题,请参考以下文章

STATES TUTORIAL, PART 4(第三部分)

STATES TUTORIAL, PART 1 - BASIC USAGE(第二部分)

Ng第五课:Octave 教程(Octave Tutorial)2

Octave Tutorial(《Machine Learning》)之第五课《控制语句和方程及向量化》

Azure 机器人微软Azure Bot 编辑器系列 : 机器人/用户提问回答模式,机器人从API获取响应并组织答案 (The Bot Framework Composer tutorial(代码片段

Flask 教程 第五章:用户登录