SaltStack 学习笔记 - 第三篇： Salt-Minion配置文件详解
建议把这篇文章作为配置参考查询，不需要详细阅读##### 主要配置设置 #####
配置默认值说明例子default_includeminion.d/*.confminion可以从其他文件读取配置，默认情况下minion将自动的将minion.d/*.conf中的配置读取出来并应用，其中minion.d目录是相对存在于主配置文件所在的目录 default_include: minion.d/*.conf
master saltmaster服务器的IDmaster : saltipv6Falseminion是否应该通过IPV6连接masteripv6 : Falseretry_dns30minion在解析master的ip失败后的重试等待时间，设置为0，则关闭重试retry_dns : 30userrootminion的运行用户，关系到minion执行命令的权限user : rootpidfile /var/run/salt-minion.pid
minion的pid文件位置 pidfile: /var/run/salt-minion.pid
root_dir /指定该目录为salt运行的根目录，改变它可以使salt从另外一个目录开始运行，好比chroot root_dir: /pki_dir/etc/salt/pki/minion存储PIK信息的目录 pki_dir: /etc/salt/pki/minion
id不指定的话，salt通过socket.getfqdn()来获取主机的名称来作为标识，指定给ID，作为minion与master交互的身份标识id: 192.168.0.100append_domain指定一个主机名称或是一个域名，当socket.getfqdn()获取主机标识失败时候，可以用来作为替补IDappend_domain : 192.168.0.100grains 使用sls文件给minion自定义静态的grain信息。
grains相当于对minion特别信息的匹配对象组，例如例子里面的匹配粒子信息中roles值为webserber,memcache的minion
## 注意sls文件是利用缩进两个空格来作为缩进标识
grains:
roles:
- webserver
- memcache
deployment: datacenter4
cabinet: 13
cab_u: 14-15
cachedir /var/cache/salt/minion
这个目录是用来存放缓存信息，特别是salt工作执行的命令信息cachedir: /var/cache/salt/minionverify_envTrue启动时候对配置目录进行验证并设置权限verify_env: Truecache_jobsFalseminion会在本地缓存salt执行过的命令返回数据。可以减少命令执行时间，减低IO，但结果可能不会实时cache_jobs: Falsesock_dir/var/run/salt/minionminion socke保存目录sock_dir: /var/run/salt/minionoutputnested设置salt-call的默认输出方式，nested是使用默认设置的来输出output: nestedcolorTrue是否对输出结果进行颜色渲染color : Truebackup_modeminion当进行文件更新，修改，***操作时，备份文件的方式，minion是本地进行备份 /etc/ssh/sshd_config:
file.managed:
- source: salt://ssh/sshd_config
- backup: minion
acceptance_wait_time10等待master接受minion的认证时间 acceptance_wait_time: 10
acceptance_wait_time_max0断线重试次数，如果设置为0，无限次重试，如果大于0，则连接重试到该设置值 acceptance_wait_time_max: 0
random_reauth_delay60随机重认证间隔（秒），例如当master修改key时，所有的minion需要重新认证，这个时候容易产生syn风暴，设置该随机值，可以使minion分不同时间进行重新认证，避免该问题random_reauth_delay:60loop_interval60 minion定时任务执行时间间隔
loop_interval: 60
dns_checkTrue确保原先的dns解析是正常的dns_check: Trueipc_modeipcwindows缺少IPC协议支持，而是使用更慢的TCP来作为内部进程交流的协议，在windows上需要设置为tcp ipc_mode: ipc
tcp_pub_port 4510当设置为tcp模式时候，该参数覆盖掉原先minon指定的tcp端口tcp_pub_port: 4510tcp_pull_port 4511tcp_pull_port: 4511include/etc/salt/extra_config可以包含其他文件中的配置，要启用此功能，通过此参数定义路径或文件，此路径可以是相对的也可以是绝对的，相对的，会被看作相对于主配置文件所在的目录，路径中还可以使用类似于shell风格的通配符，如果没有文件匹配的路径传递给此选项，那么master将会在日志中记录一条警告的消息 include:
- /etc/salt/extra_config
- /etc/roles/webserver
##### Minion 模块管理配置 #####
disable_modules[]限制允许执行的模块，对特别的权限可以进行设置，防止服务器重启等disable_modules: module_dirs []模块可以通过指定任意目录进行加载；指定一系列的外部目录用于搜索minion的模块以及returners。指定的路径必须给minion完全的操作权限 module_dirs: []
returner_dirs[]returner_dirs: []states_dirs[]states_dirs: []render_dirs[]render_dirs: []providers minion的模块provider可以通过参数providers来进行特别指定 providers:
pkg: yumpkg5
ython_enableFalse允许加载加密的模块ython_enable: False ##### State 管理设置 #####
renderer yaml_jinja
state配置文件支持下面的配置语法，通过执行该参数，告诉saltstatck解析state模板的语言方法 # yaml_jinja
# yaml_mako
# yaml_wempy
# json_jinja
# json_mako
# json_wempy
renderer: yaml_jinjafailhardFalse设置一个全局的failhard表示，当单个的状态执行失败后，将会通知所有的状态停止运行状态failhard: Falseautoload_dynamic_modulesTrue自动发现并加载master上的模块 autoload_dynamic_modules: True
clean_dynamic_modulesTrue如果发现master上的模块已经清除，则自动清楚对应的模块clean_dynamic_modules : TrueenvironmentNonemaster在运行states的时候，通常不会把minion分割出来给任意一个单独的环境，但在minion端，可以自行进行独立的环境设置environment:None state_top
top.sls指定top.sls文件的位置 state_top: top.sls
startup_states
'' 在minion daemon开始时执行states.
# 'highstate' -- 执行 state.highstate
# 'sls' -- 读取 sls_list 参数配置的路径下的sls文件列表并执行
# 'top' -- 读取top_file参数设置的文件并执行master上面设置的sls配置
startup_states: ''
sls_list当startup_states配置为sls，该参数列出minion要运行的states文件 sls_list:
- edit.vim
- hyper
top_file"当startup_states是top时，指定要执行的top文件top_file: '' ##### 文件目录设置 #####
#########################
file_clientremote设置minion的文件客户端，reomote，默认选项，minon会到master去查找文件；设置为local，则minion会在本地查找配置文件file_client: remotefile_roots file_roots:
base:
- /srv/salt
设置文件客户端路径 file_roots:
base:
- /srv/salt/
dev:
- /srv/salt/dev/services
- /srv/salt/dev/states
prod:
- /srv/salt/prod/services
- /srv/salt/prod/states
fileserver_limit_traversal
False设置saltstack查找state文件时候，仅遍历查找带sls后缀的文件或是带_modules后缀的目录 fileserver_limit_traversal: False
pillar_roots pillar_roots:
base:
- /srv/pillar
当file_client设置为local时候，该参数制定pillar的搜索路径 pillar_roots:
base:
- /srv/pillar
###### 安全设置 #####
open_mode
Falseopen_mode是一个危险的安全特***，当master遇到pki认证系统，秘钥混淆和身份验证失效时，打开open_mode，master将会接受所有的身份验证。这将会清理掉pki秘钥接受的minions。通常情况下open_mode不应该被打开，它只适用于短时间内清理pki keys，若要打开它，可将值调整为True open_mode: False
permissive_pki_accessFalsepermissive_pki_access:Falsestate_verboseTruestate_verbose允许从minions返回更多详细的信息，通常清空下只返回失败或者已经更改，但是将state_verbose设置为True,将会返回所有的状态检查state_verbose:Truestate_outputfullstate_output的设置将会改变信息输出的格式，当被设置为”full”时，将全部的输出一行一行的显示输出；当被设置为”terse“时，将会被缩短为一行进行输出；当被设置为”mixed”时，输出样式将会是简洁的，除非状态失败，这种情况下将会全部输出；当被设置为”change”时，输出将会完全输出除非状态没有改变state_output:fullmaster_finger''master_finger:'' ###### Thread 设置 #####
multiprocessingTrue多线程支持multiprocessing: True ##### Logging 设置 #####
log_file/var/log/salt/minionlog输出路径设置 #log_file: /var/log/salt/minion
#log_file: file:///dev/log
#log_file: udp://loghost:10514
#
#log_file: /var/log/salt/minion
#key_logfile: /var/log/salt/key
log_levelwarning 控制台（console）日志默认输出等级：
'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'
log_level: warninglog_level_logfilewarning 日志文件输出等级：
'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
log_level_logfile:warninglog_datefmt'%H:%M:%S'控制台日志日期格式 log_datefmt: '%H:%M:%S'
log_datefmt_logfile%Y-%m-%d %H:%M:%S'日志文件日期格式log_datefmt_logfile: '%Y-%m-%d %H:%M:%S'log_fmt_console'[%(levelname)-8s] %(message)s'控制台日志格式 log_fmt_console: '[%(levelname)-8s] %(message)s'
log_fmt_logfile'%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'日志文件信息格式 log_fmt_logfile: '%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'
log_granular_levels{}更加高级的指定日志输出 log_granular_levels:
'salt': 'warning',
'salt.modules': 'debug'
###### Module 配置 #####
testTrue指定允许所有的模块运行测试模式test:Truetest.foofoo给测试模块test.foo指定一个简单的值test.foo: footest.bar
列表的测试模块值test.bar: test.baz
{spam: sausage, cheese: bread}测试模块指定字典格式的值 test.baz: {spam: sausage, cheese: bread}
页:
[1]