MOD AGGREGATE STATE RUNTIME MODIFICATIONS
略
ALTERING STATES
略
FILE STATE BACKUPS
可以在多个地方设置minion端的文件备份。
示例：
backup_mode: minion
或
1 /etc/ssh/sshd_config: 2 file.managed: 3 - source: salt://ssh/sshd_config 4 - backup: minion
BACKED-UP FILES
备份文件的位置位于minion端配置的file_backup目录下，后面添加了时间戳。
INTERACTING WITH BACKUPS
backup文件的操作，可以进行列出，删除，回滚等操作。
LISTING
# salt foo.bar.com file.list_backups /tmp/foo.txt
示例：
1 foo.bar.com: 2 ---------- 3 0: 4 ---------- 5 Backup Time: 6 Sat Jul 27 2013 17:48:41.738027 7 Location: 8 /var/cache/salt/minion/file_backup/tmp/foo.txt_Sat_Jul_27_17:48:41_738027_2013 9 Size: 10 13 11 1: 12 ---------- 13 Backup Time: 14 Sat Jul 27 2013 17:48:28.369804 15 Location: 16 /var/cache/salt/minion/file_backup/tmp/foo.txt_Sat_Jul_27_17:48:28_369804_2013 17 Size: 18 35
列出指定文件的备份文件列表
RESTORING
salt foo.bar.com file.restore_backup /tmp/foo.txt 1
示例：
1 foo.bar.com: 2 ---------- 3 comment: 4 Successfully restored /var/cache/salt/minion/file_backup/tmp/foo.txt_Sat_Jul_27_17:48:28_369804_2013 to /tmp/foo.txt 5 result: 6 True
对指定备份文件进行回滚，现有的文件会被再次进行备份，可以使用file.list_backups查看
DELETING
使用file.delete_backup删除备份文件
# salt foo.bar.com file.delete_backup /tmp/foo.txt 0
示例：
1 foo.bar.com: 2 ---------- 3 comment: 4 Successfully removed /var/cache/salt/minion/file_backup/tmp/foo.txt_Sat_Jul_27_18:00:19_822550_2013 5 result: 6 True
UNDERSTANDING STATE COMPILER ORDERING
state文件编译顺序
COMPILER BASICS
编译的简单知识
HIGH DATA AND LOW DATA
当我们讲state文件以yaml数据的格式编译之后，展示的是一个高级的数据结构，以一个大字典存在，可以被运行。在被编译成高级的数据结构之后接下来会被继续编译成底层的数据结构，底层的数据结构时执行的单状态调用的有序列表。
可以通过调用执行来查看细节：
salt '*' state.show_highstate
salt '*' state.show_lowstate
一个sls文件编写内容示例：
1 apache: 2 pkg.installed: 3 - name: httpd 4 service.running: 5 - name: httpd 6 - watch: 7 - file: apache_conf 8 - pkg: apache 9 10 apache_conf: 11 file.managed: 12 - name: /etc/httpd/conf.d/httpd.conf 13 - source: salt://apache/httpd.conf
一个High Data数据结构示例：
1 { 2 "apache": { 3 "pkg": [ 4 { 5 "name": "httpd" 6 }, 7 "installed", 8 { 9 "order": 10000 10 } 11 ], 12 "service": [ 13 { 14 "name": "httpd" 15 }, 16 { 17 "watch": [ 18 { 19 "file": "apache_conf" 20 }, 21 { 22 "pkg": "apache" 23 } 24 ] 25 }, 26 "running", 27 { 28 "order": 10001 29 } 30 ], 31 "__sls__": "blah", 32 "__env__": "base" 33 }, 34 "apache_conf": { 35 "file": [ 36 { 37 "name": "/etc/httpd/conf.d/httpd.conf" 38 }, 39 { 40 "source": "salt://apache/httpd.conf" 41 }, 42 "managed", 43 { 44 "order": 10002 45 } 46 ], 47 "__sls__": "blah", 48 "__env__": "base" 49 } 50 }
一个Low Data数据结构示例：
1 [ 2 { 3 "name": "httpd", 4 "state": "pkg", 5 "__id__": "apache", 6 "fun": "installed", 7 "__env__": "base", 8 "__sls__": "blah", 9 "order": 10000 10 }, 11 { 12 "name": "httpd", 13 "watch": [ 14 { 15 "file": "apache_conf" 16 }, 17 { 18 "pkg": "apache" 19 } 20 ], 21 "state": "service", 22 "__id__": "apache", 23 "fun": "running", 24 "__env__": "base", 25 "__sls__": "blah", 26 "order": 10001 27 }, 28 { 29 "name": "/etc/httpd/conf.d/httpd.conf", 30 "source": "salt://apache/httpd.conf", 31 "state": "file", 32 "__id__": "apache_conf", 33 "fun": "managed", 34 "__env__": "base", 35 "__sls__": "blah", 36 "order": 10002 37 } 38 ]
ORDERING LAYERS
salt定义了两个顺序接口，这些接口在运行时进行评估。
DEFINITION ORDER
自定义顺序，设置state_auto_order为False
当top文件中在不包含include声明的情况下，顺序是比较容易确定的，在引入include之后排序规则会有一些简单的规则需要被掌握。
THE INCLUDE STATEMENT
示例：
foo.sls
1 include: 2 - bar 3 - baz
bar.sls
1 include: 2 - quo
baz.sls
1 include: 2 - qux
当执行state.apply时，执行的顺序将如下：
1 1.quo 2 2.bar 3 3.qux 4 4.baz 5 5.foo
THE ORDER FLAG
顺序是通过默认的规则生成的，也可以显示的进行定义覆盖
示例：
1 apache: 2 pkg.installed: 3 - name: httpd 4 - order: 1
定义最后的顺序：order: last or order: -1
LEXICOGRAPHICAL FALL-BACK
略
REQUISITE ORDERING
略
RUNTIME REQUISITE EVALUATION
运行时对state中定义的组件顺序进行评估，需要根据一些依赖条件require,watch,prereq的情况进行判断。
SIMPLE RUNTIME EVALUATION EXAMPLE
以下是一个基本的评判执行顺序的规则，基于上面的示例：
1、执行pkg.installed，因为它不包含任何依赖关系，所以第一个执行。
2、接下来service.running将会被评估不被执行，按照顺序读取定义的依赖状态，对文件状态进行检查。
3、执行apache_conf状态，因为它不依赖其他条件。
4、service状态还是不被执行，需要继续检查pkg的执行状态，如果满足条件则执行。
BEST PRACTICE
salt最佳的做法是选择其中一种方法坚持下去，设置failhard为True，确保在一次失败时停止所有的状态继续运行。