SaltStack 入门到精通第三篇:Salt-Minion配置文件详解

时间:2022-10-03 09:03:50

SaltStack 入门到精通第三篇:Salt-Minion配置文件详解

作者:ArlenJ  发布日期:2014-06-09 17:52:16
 

##### 主要配置设置 #####


配置 默认值 说明 例子
default_include minion.d/*.conf master可以从其他文件读取配置,默认情况下master将自动的将master.d/*.conf中的配置读取出来并应用,其中master.d目录是相对存在于主配置文件所在的目录

default_include: minion.d/*.conf

master  salt master服务器的ID master : salt
ipv6 False minion是否应该通过IPV6连接master ipv6 : False
retry_dns 30 minion在解析master的ip失败后的重试等待时间,设置为0,则关闭重试 retry_dns : 30
user root minion的运行用户,关系到minion执行命令的权限 user : root
pidfile

/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.100
append_domain   指定一个主机名称或是一个域名,当socket.getfqdn()获取主机标识失败时候,可以用来作为替补ID append_domain : 192.168.0.100
grains  

使用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/minion
verify_env True 启动时候对配置目录进行验证并设置权限 verify_env: True
cache_jobs False minion会在本地缓存salt执行过的命令返回数据。可以减少命令执行时间,减低IO,但结果可能不会实时 cache_jobs: False
sock_dir /var/run/salt/minion minion socke保存目录 sock_dir: /var/run/salt/minion
output nested 设置salt-call的默认输出方式,nested是使用默认设置的来输出 output: nested
color True 是否对输出结果进行颜色渲染 color : True
backup_mode minion 当进行文件更新,修改,***操作时,备份文件的方式,minion是本地进行备份

/etc/ssh/sshd_config:

file.managed:

- source: salt://ssh/sshd_config

- backup: minion

acceptance_wait_time 10 等待master接受minion的认证时间

acceptance_wait_time: 10

acceptance_wait_time_max 0 断线重试次数,如果设置为0,无限次重试,如果大于0,则连接重试到该设置值

acceptance_wait_time_max: 0

random_reauth_delay 60 随机重认证间隔(秒),例如当master修改key时,所有的minion需要重新认证,这个时候容易产生syn风暴,设置该随机值,可以使minion分不同时间进行重新认证,避免该问题 random_reauth_delay:60
loop_interval 60

minion定时任务执行时间间隔

loop_interval: 60

dns_check True 确保原先的dns解析是正常的 dns_check: True
ipc_mode ipc windows缺少IPC协议支持,而是使用更慢的TCP来作为内部进程交流的协议,在windows上需要设置为tcp

ipc_mode: ipc

tcp_pub_port  4510 当设置为tcp模式时候,该参数覆盖掉原先minon指定的tcp端口 tcp_pub_port: 4510
tcp_pull_port  4511 tcp_pull_port: 4511
include /etc/salt/extra_config 可以包含其他文件中的配置,要启用此功能,通过此参数定义路径或文件,此路径可以是相对的也可以是绝对的,相对的,会被看作相对于主配置文件所在的目录,路径中还可以使用类似于shell风格的通配符,如果没有文件匹配的路径传递给此选项,那么master将会在日志中记录一条警告的消息 

include:

- /etc/salt/extra_config

- /etc/roles/webserver


#####   Minion 模块管理配置    #####

disable_modules [] 限制允许执行的模块,对特别的权限可以进行设置,防止服务器重启等 disable_modules: [cmd,test]
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_enable False 允许加载加密的模块 ython_enable: False
       
       
       

#####    State 管理设置    #####

renderer

yaml_jinja

state配置文件支持下面的配置语法,通过执行该参数,告诉saltstatck解析state模板的语言方法

# yaml_jinja

# yaml_mako

# yaml_wempy

# json_jinja

# json_mako

# json_wempy

renderer: yaml_jinja
failhard False 设置一个全局的failhard表示,当单个的状态执行失败后,将会通知所有的状态停止运行状态 failhard: False
autoload_dynamic_modules True 自动发现并加载master上的模块

autoload_dynamic_modules: True

clean_dynamic_modules True 如果发现master上的模块已经清除,则自动清楚对应的模块 clean_dynamic_modules : True
environment None master在运行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_client remote 设置minion的文件客户端,reomote,默认选项,minon会到master去查找文件;设置为local,则minion会在本地查找配置文件 file_client: remote
file_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

False open_mode是一个危险的安全特性,当master遇到pki认证系统,秘钥混淆和身份验证失效时,打开open_mode,master将会接受所有的身份验证。这将会清理掉pki秘钥接受的minions。通常情况下open_mode不应该被打开,它只适用于短时间内清理pki keys,若要打开它,可将值调整为True

open_mode: False

permissive_pki_access False   permissive_pki_access:False
state_verbose True state_verbose允许从minions返回更多详细的信息,通常清空下只返回失败或者已经更改,但是将state_verbose设置为True,将会返回所有的状态检查 state_verbose:True
state_output full state_output的设置将会改变信息输出的格式,当被设置为”full”时,将全部的输出一行一行的显示输出;当被设置为”terse“时,将会被缩短为一行进行输出;当被设置为”mixed”时,输出样式将会是简洁的,除非状态失败,这种情况下将会全部输出;当被设置为”change”时,输出将会完全输出除非状态没有改变 state_output:full
master_finger ''   master_finger:''

######         Thread 设置        #####

multiprocessing True 多线程支持 multiprocessing: True

#####         Logging 设置       #####

log_file /var/log/salt/minion log输出路径设置

#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_level warning

控制台(console)日志默认输出等级:

'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'

log_level: warning
log_level_logfile warning

日志文件输出等级:

'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.

log_level_logfile:warning
log_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 配置      #####

test True 指定允许所有的模块运行测试模式 test:True
test.foo foo 给测试模块test.foo指定一个简单的值 test.foo: foo
test.bar

[baz,quo]

列表的测试模块值 test.bar: [baz,quo]

test.baz

{spam: sausage, cheese: bread} 测试模块指定字典格式的值

test.baz: {spam: sausage, cheese: bread}