salt-master配置文件详解

本文系统：centos6.5

[root<span class="variable">@master</span> salt]<span class="comment"># rpm -qa |grep salt*</span>
salt-minion-<span class="number">2014.1</span>.<span class="number">7</span>-<span class="number">3</span>.el6.noarch
salt-master-<span class="number">2014.1</span>.<span class="number">7</span>-<span class="number">3</span>.el6.noarch
salt-<span class="number">2014.1</span>.<span class="number">7</span>-<span class="number">3</span>.el6.noarch

salt-master位置：

/etc/salt/master

# The address of the interface to bind to #interface: 0.0.0.0      # 默认值：0.0.0.0(所有的网络地址接口)； 绑定到本地的某个网络地址接口

<span class="attribute">interface</span>: <span class="string">192.168.28.141</span>

# The tcp port used by the publisher #publish_port: 4505     # 默认值：4505  ； 设置master与minion的认证通信端口

<span class="attribute">publish_port</span>: <span class="string">4505</span>

#user: root            # 默认值：root ；运行salt进程的用户

<span class="attribute">user</span>: <span class="string">root</span>

#max_open_files: 100000   #默认值：100000 ；salt-master可以打开的最大句柄数

<span class="attribute">max_open_files</span>: <span class="string">100000</span>

#worker_threads: 5       #默认值：5 ；启动用来接收或应答minion的线程数

<span class="attribute">worker_threads</span>: <span class="string">5</span>

#ret_port: 4506         #默认值：4506 ；master用来发送命令或者接收minions的命令执行返回信息

<span class="attribute">ret_port</span>: <span class="string">4506</span>

#pidfile: /var/run/salt-master.pid  #默认值：/var/run/salt-master.pid ；指定master的pid文件位置

<span class="attribute">pidfile</span>: <span class="string">/var/run/salt-master.pid</span>

#root_dir: /         # 默认值：/  ； 该目录为salt运行的根目录，改变它可以使salt从另外一个目录开始运行，好比chroot

<span class="attribute">root_dir</span>: <span class="string">/</span>

#pki_dir: /etc/salt/pki/master  # 默认值：/etc/salt/pki ； 这个目录是用来存放pki认证秘钥

<span class="attribute">pki_dir</span>: <span class="string">/etc/salt/pki/master</span>

#cachedir: /var/cache/salt/master # 默认值：/var/cache/salt ； 用来存放缓存信息，salt工作执行的命令信息

<span class="attribute">cachedir</span>: <span class="string">/var/cache/salt</span>

#verify_env: True  # 默认值 ： True ； 在启动验证和设置权限配置目录

<span class="attribute">verify_env</span>: <span class="string">True</span>

#keep_jobs: 24   #默认值：24 ；设置保持老的工作信息的过期时间，单位小时

<span class="attribute">keep_jobs</span>: <span class="string">24</span>

#job_cache: True   # 默认值：True ；设置master维护的工作缓存，这是一个很好的功能，当你的Minons超过5000台时，他将很好的承担这个大的架构，关闭这个选项，之前的工作执行以及工作系统将无法被利用，一般不推荐关掉改选项，开启改选项将会是很明智的，他将使master获得更快的IO系统

<span class="attribute">job_cache</span>: <span class="string">True</span>

#timeout: 5  #默认值：5 ；master执行命令的可以接受的延迟时间

<span class="attribute">timeout</span>: <span class="string">5</span>

#output: nested   #默认值：nested ；salt命令的输出格式

<span class="attribute">output</span>: <span class="string">nested</span>

#sock_dir: /var/run/salt/master  #默认值：/var/run/salt/master ； 指定unix socket主进程通信的socket创建路径

<span class="attribute">sock_dir</span>: <span class="string">/var/run/salt/master</span>

#minion_data_cache: True  # 默认值：True ；minion data cache是关于minion信息存储在master上的参数，这些信息主要是pillar 和 grains数据.这些数据被缓存在cachedir定义的目录下的minion目录下以minion名为名的目录下并且预先确定哪些minions将从 执行回复

<span class="attribute">minion_data_cache</span>: <span class="string">True</span>

#include: /etc/salt/extra_config #默认值：/etc/salt/extra_config ；包含其他路径上的配置文件

<span class="attribute">include</span>: <span class="string">/etc/salt/extra_config</span>

#####        Security settings       #####

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

<span class="attribute">open_mode</span>: <span class="string">False</span>

#auto_accept: False #默认值：False ；这个设置将会使master自动接受所有发送公钥的minions

<span class="attribute">auto_accept</span>: <span class="string">False</span>

#autosign_file: /etc/salt/autosign.conf #默认值：/etc/salt/autosign.conf ；如果autosign_file的值被指定，那么autosign_file将会通过该输入允许所有的匹配项，首先会搜索字符串进行匹配，然后通过正则表达式进行匹配。这是不安全的

<span class="attribute">autosign_file</span>: <span class="string">/etc/salt/autosign.conf</span>

#client_acl: # 默认值：{} ；开启对系统上非root的系统用户在master上执行特殊的模块，这些模块名可以使用正则表达式进行表示

client_acl:
  larry:
    - test.ping
    - network.*

#client_acl_blacklist  #默认值：{} ；黑名单用户或模块，表示所有非sudo用户以及root都无法通过cmd这个模块执行命令，默认情况改配置是完全禁用的

client_acl_blacklist:
  users:
    - root
    - '^(?!sudo_).*$'   #  all non su<span class="operator"><span class="keyword">do</span> users
  modules:
    - cmd</span>

#external_auth:  #默认值：{} ； salt的认证模块采用外部的认证系统用来做认证和验证用户在salt系统中的访问区域

  pam:
    fred:
      - test.*

#file_recv: False #默认值：False ； 允许minions推送文件到master上，这个选项默认是禁用的，出于安全考虑

<span class="attribute">file_recv</span>: <span class="string">False</span>

#file_recv_max_size: 100 # 默认值：100 设置一个hard-limit文件的大小,可以推到master。

<span class="attribute">file_recv_max_size</span>: <span class="string">100</span>

#####      State System settings     #####

#state_top: top.sls #默认值：top.sls ; 状态系统使用一个入口文件告诉minions在什么环境下使用什么模块，这个状态入口文件被定义在基础环境的相对根路径下

<span class="attribute">state_top</span>: <span class="string">top.sls</span>

#renderer: yaml_jinja #默认值：yaml_jinja ；使用渲染器用来渲染minions的状态数据

<span class="attribute">renderer</span>: <span class="string">yaml_jinja</span>

#failhard: False #默认值：False ； 设置一个全局的failhard表示，当单个的状态执行失败后，将会通知所有的状态停止运行状态

<span class="attribute">failhard</span>: <span class="string">False</span>

#state_verbose: True #默认值：False ；state_verbose允许从minions返回更多详细的信息，通常清空下只返回失败或者已经更改，但是将state_verbose设置为True,将会返回所有的状态检查

<span class="attribute">state_verbose</span>: <span class="string">True</span>

##state_output: full #默认值：full ； state_output的设置将会改变信息输出的格式，当被设置为”full”时，将全部的输出一行一行的显示输出；当被设置为”terse“时，将会 被缩短为一行进行输出；当被设置为”mixed”时，输出样式将会是简洁的，除非状态失败，这种情况下将会全部输出；当被设置为”change”时，输出 将会完全输出除非状态没有改变

<span class="attribute">state_output</span>: <span class="string">full</span>

#####      File Server settings      #####

# file_roots: # 默认值： base: \n\t - /srv/salt ； salt运行一个轻量级的文件服务器通过ZeroMQ对minions进行文件传输，因此这个文件服务器是构造在master的守护进程中，并且不需要依赖于专用的端口

文件服务器的工作环境传递给master，每一个环境可以有多个根目录，但是相同环境下多个文件的子目录不能相同，否则下载的文件将不能被可靠的保证，一个基础环境依赖于主的入口文件，

 Example:
 file_roots:
   base:
     - <span class="regexp">/srv/</span>salt/
   dev:
     - <span class="regexp">/srv/</span>salt/dev/services
     - <span class="regexp">/srv/</span>salt/dev/states
   prod:
     - <span class="regexp">/srv/</span>salt/prod/services
     - <span class="regexp">/srv/</span>salt/prod/states

#hash_type: md5  # 默认值：md5 ； hash_type是用来当发现在master上需要对一个文件进行hash时的hash使用的算法，默认是md5.但是它也支持sha1,sha224,shar256,shar384,shar512

<span class="attribute">hash_type</span>: <span class="string">md5</span>

#file_buffer_size: 1048576  # 默认值：1048576 ；文件服务器的缓存区大小

<span class="attribute">file_buffer_size</span>: <span class="string">1048576</span>

#fileserver_backend:  # 默认值： fileserver_backend: \n\t - roots ；salt支持模块化的后端文件系统服务器，它允许salt通过第三方的系统来管理收集文件并提供给minions使用，可以配置多个后端文件系统，这里支 持gitfs、hgfs、roots、s3fs文件调用的搜索顺序按照后台文件系统的配置顺序来搜索，默认的设置只开启了标准的后端服务器roots，具 体的根选项配置通过file_roots参数设置

fileserver_backend:
  - git
  - roots

#####         Pillar settings        #####

#pillar_roots:  # 默认值： base: \n\t – /srv/pillar 设置不同的环境对应的存放pillar数据的目录，这个配置和file_roots参数配置一样

pillar_roots:
    base:
        - <span class="regexp">/srv/</span>pillar
    dev:
       - <span class="regexp">/srv/</span>pillar/dev
    prod:
        - <span class="regexp">/srv/</span>pillar/prod

#####         Logging settings       #####

#log_file: /var/log/salt/master # 默认值：/var/log/salt/master ；master的日志可以发送到一个普通文件，本地路径名或者网络位置

eg:
log_file: /<span class="keyword">var</span>/log/salt/master
log_file: 
log_file: udp:<span class="comment">//loghost:10514</span>

#log_level: warning  #默认值：warning ； 按照日志级别发送信息到控制台 可选项：# One of ‘garbage’, ‘trace’, ‘debug’, info’, ‘warning’, ‘error’, ‘critical’.

<span class="attribute">log_level</span>: <span class="string">warning</span>

#log_level_logfile: warning #默认值：warning ； 按照日志级别发送信息到日志文件

<span class="attribute">log_level_logfile</span>: <span class="string">warning</span>

#log_datefmt: ‘%H:%M:%S’  #默认值：%H:%M:%S ；发送到控制台信息所用的日期时间格式，更多详情

<span class="attribute">log_datefmt</span>: <span class="string">'%H:%M:%S'</span>

log_fmt_console

默认值: [%(levelname)-8s] %(message)s

控制台日志信息格式，

<span class="attribute">log_fmt_console</span>: <span class="string">'[%(levelname)-8s] %(message)s'</span>

log_fmt_logfile

默认值: %(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s

%(asctime)s：2003-07-08 16:49:45

%(msecs)03.0f：当前时间的毫秒部分

%(name)：日志记录调用器的名字

%(levelname)：日志记录级别

%(message)s：日志详细信息

<span class="attribute">log_fmt_logfile</span>: <span class="string">'%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'</span>

log_granular_levels  #默认值：{} ； 这可以更加具体的控制日志记录级别

#####         Node Groups           #####

nodegroups:
   webgroup1: 'L@_host_serv_1.lansgg.com,_host_serv_1.lansgg.com'

上面配置是我这边测试用；编辑后，重启master

[root<span class="variable">@master</span> salt]<span class="comment"># salt -N webgroup1 test.ping</span>

高级用法：

关于组的混合匹配：（ Compound matchers）

转载请注明：爱开源 » salt-master配置文件详解