Saltstack Official Salt Formula
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

466 line
17KB

  1. # This file managed by Salt, do not edit!!
  2. #
  3. #
  4. ##### Primary configuration settings #####
  5. ##########################################
  6. # This configuration file is used to manage the behavior of the Salt Master
  7. # Values that are commented out but have no space after the comment are
  8. # defaults that need not be set in the config. If there is a space after the
  9. # comment that the value is presented as an example and is not the default.
  10. # Per default, the master will automatically include all config files
  11. # from master.d/*.conf (master.d is a directory in the same directory
  12. # as the main master config file)
  13. #default_include: master.d/*.conf
  14. # The address of the interface to bind to
  15. #interface: 0.0.0.0
  16. # The tcp port used by the publisher
  17. #publish_port: 4505
  18. # The user to run the salt-master as. Salt will update all permissions to
  19. # allow the specified user to run the master. If the modified files cause
  20. # conflicts set verify_env to False.
  21. #user: root
  22. # Max open files
  23. # Each minion connecting to the master uses AT LEAST one file descriptor, the
  24. # master subscription connection. If enough minions connect you might start
  25. # seeing on the console(and then salt-master crashes):
  26. # Too many open files (tcp_listener.cpp:335)
  27. # Aborted (core dumped)
  28. #
  29. # By default this value will be the one of `ulimit -Hn`, ie, the hard limit for
  30. # max open files.
  31. #
  32. # If you wish to set a different value than the default one, uncomment and
  33. # configure this setting. Remember that this value CANNOT be higher than the
  34. # hard limit. Raising the hard limit depends on your OS and/or distribution,
  35. # a good way to find the limit is to search the internet for(for example):
  36. # raise max open files hard limit debian
  37. #
  38. #max_open_files: 100000
  39. # The number of worker threads to start, these threads are used to manage
  40. # return calls made from minions to the master, if the master seems to be
  41. # running slowly, increase the number of threads
  42. #worker_threads: 5
  43. # The port used by the communication interface. The ret (return) port is the
  44. # interface used for the file server, authentication, job returnes, etc.
  45. #ret_port: 4506
  46. # Specify the location of the daemon process ID file
  47. #pidfile: /var/run/salt-master.pid
  48. # The root directory prepended to these options: pki_dir, cachedir,
  49. # sock_dir, log_file, autosign_file, extension_modules, key_logfile, pidfile.
  50. #root_dir: /
  51. # Directory used to store public key data
  52. #pki_dir: /etc/salt/pki/master
  53. # Directory to store job and cache data
  54. #cachedir: /var/cache/salt/master
  55. # Verify and set permissions on configuration directories at startup
  56. #verify_env: True
  57. # Set the number of hours to keep old job information in the job cache
  58. #keep_jobs: 24
  59. # Set the default timeout for the salt command and api, the default is 5
  60. # seconds
  61. #timeout: 5
  62. # The loop_interval option controls the seconds for the master's maintinance
  63. # process check cycle. This process updates file server backends, cleans the
  64. # job cache and executes the scheduler.
  65. #loop_interval: 60
  66. # Set the default outputter used by the salt command. The default is "nested"
  67. #output: nested
  68. # By default output is colored, to disable colored output set the color value
  69. # to False
  70. #color: True
  71. # Set the directory used to hold unix sockets
  72. #sock_dir: /var/run/salt/master
  73. # The master maintains a job cache, while this is a great addition it can be
  74. # a burden on the master for larger deployments (over 5000 minions).
  75. # Disabling the job cache will make previously executed jobs unavailable to
  76. # the jobs system and is not generally recommended.
  77. #
  78. #job_cache: True
  79. # Cache minion grains and pillar data in the cachedir.
  80. #minion_data_cache: True
  81. # The master can include configuration from other files. To enable this,
  82. # pass a list of paths to this option. The paths can be either relative or
  83. # absolute; if relative, they are considered to be relative to the directory
  84. # the main master configuration file lives in (this file). Paths can make use
  85. # of shell-style globbing. If no files are matched by a path passed to this
  86. # option then the master will log a warning message.
  87. #
  88. #
  89. # Include a config file from some other path:
  90. # include: /etc/salt/extra_config
  91. #
  92. # Include config from several files and directories:
  93. # include:
  94. # - /etc/salt/extra_config
  95. ##### Security settings #####
  96. ##########################################
  97. # Enable "open mode", this mode still maintains encryption, but turns off
  98. # authentication, this is only intended for highly secure environments or for
  99. # the situation where your keys end up in a bad state. If you run in open mode
  100. # you do so at your own risk!
  101. #open_mode: False
  102. # Enable auto_accept, this setting will automatically accept all incoming
  103. # public keys from the minions. Note that this is insecure.
  104. #auto_accept: False
  105. # If the autosign_file is specified only incoming keys specified in
  106. # the autosign_file will be automatically accepted. This is insecure.
  107. # Regular expressions as well as globing lines are supported.
  108. #autosign_file: /etc/salt/autosign.conf
  109. # Enable permissive access to the salt keys. This allows you to run the
  110. # master or minion as root, but have a non-root group be given access to
  111. # your pki_dir. To make the access explicit, root must belong to the group
  112. # you've given access to. This is potentially quite insecure.
  113. # If an autosign_file is specified, enabling permissive_pki_access will allow group access
  114. # to that specific file.
  115. #permissive_pki_access: False
  116. # Allow users on the master access to execute specific commands on minions.
  117. # This setting should be treated with care since it opens up execution
  118. # capabilities to non root users. By default this capability is completely
  119. # disabled.
  120. #
  121. # client_acl:
  122. # larry:
  123. # - test.ping
  124. # - network.*
  125. #
  126. # Blacklist any of the following users or modules
  127. #
  128. # This example would blacklist all non sudo users, including root from
  129. # running any commands. It would also blacklist any use of the "cmd"
  130. # module.
  131. # This is completely disabled by default.
  132. #
  133. # client_acl_blacklist:
  134. # users:
  135. # - root
  136. # - '^(?!sudo_).*$' # all non sudo users
  137. # modules:
  138. # - cmd
  139. # The external auth system uses the Salt auth modules to authenticate and
  140. # validate users to access areas of the Salt system
  141. #
  142. # external_auth:
  143. # pam:
  144. # fred:
  145. # - test.*
  146. #
  147. # Time (in seconds) for a newly generated token to live. Default: 12 hours
  148. # token_expire: 43200
  149. ##### Master Module Management #####
  150. ##########################################
  151. # Manage how master side modules are loaded
  152. # Add any additional locations to look for master runners
  153. #runner_dirs: []
  154. # Enable Cython for master side modules
  155. #cython_enable: False
  156. ##### State System settings #####
  157. ##########################################
  158. # The state system uses a "top" file to tell the minions what environment to
  159. # use and what modules to use. The state_top file is defined relative to the
  160. # root of the base environment as defined in "File Server settings" below.
  161. #state_top: top.sls
  162. # The master_tops option replaces the external_nodes option by creating
  163. # a plugable system for the generation of external top data. The external_nodes
  164. # option is deprecated by the master_tops option.
  165. # To gain the capabilities of the classic external_nodes system, use the
  166. # following configuration:
  167. # master_tops:
  168. # ext_nodes: <Shell command which returns yaml>
  169. #
  170. #master_tops: {}
  171. # The external_nodes option allows Salt to gather data that would normally be
  172. # placed in a top file. The external_nodes option is the executable that will
  173. # return the ENC data. Remember that Salt will look for external nodes AND top
  174. # files and combine the results if both are enabled!
  175. #external_nodes: None
  176. # The renderer to use on the minions to render the state data
  177. #renderer: yaml_jinja
  178. # The failhard option tells the minions to stop immediately after the first
  179. # failure detected in the state execution, defaults to False
  180. #failhard: False
  181. # The state_verbose and state_output settings can be used to change the way
  182. # state system data is printed to the display. By default all data is printed.
  183. # The state_verbose setting can be set to True or False, when set to False
  184. # all data that has a result of True and no changes will be suppressed.
  185. #state_verbose: True
  186. # The state_output setting changes if the output is the full multi line
  187. # output for each changed state if set to 'full', but if set to 'terse'
  188. # the output will be shortened to a single line. If set to 'mixed', the output
  189. # will be terse unless a state failed, in which case that output will be full.
  190. #state_output: full
  191. ##### File Server settings #####
  192. ##########################################
  193. # Salt runs a lightweight file server written in zeromq to deliver files to
  194. # minions. This file server is built into the master daemon and does not
  195. # require a dedicated port.
  196. # The file server works on environments passed to the master, each environment
  197. # can have multiple root directories, the subdirectories in the multiple file
  198. # roots cannot match, otherwise the downloaded files will not be able to be
  199. # reliably ensured. A base environment is required to house the top file.
  200. # Example:
  201. # file_roots:
  202. # base:
  203. # - /srv/salt/
  204. # dev:
  205. # - /srv/salt/dev/services
  206. # - /srv/salt/dev/states
  207. # prod:
  208. # - /srv/salt/prod/services
  209. # - /srv/salt/prod/states
  210. #file_roots:
  211. # base:
  212. # - /srv/salt
  213. # The hash_type is the hash to use when discovering the hash of a file on
  214. # the master server, the default is md5, but sha1, sha224, sha256, sha384
  215. # and sha512 are also supported.
  216. #hash_type: md5
  217. # The buffer size in the file server can be adjusted here:
  218. #file_buffer_size: 1048576
  219. # A regular expression (or a list of expressions) that will be matched
  220. # against the file path before syncing the modules and states to the minions.
  221. # This includes files affected by the file.recurse state.
  222. # For example, if you manage your custom modules and states in subversion
  223. # and don't want all the '.svn' folders and content synced to your minions,
  224. # you could set this to '/\.svn($|/)'. By default nothing is ignored.
  225. # file_ignore_regex:
  226. # - '/\.svn($|/)'
  227. # - '/\.git($|/)'
  228. # A file glob (or list of file globs) that will be matched against the file
  229. # path before syncing the modules and states to the minions. This is similar
  230. # to file_ignore_regex above, but works on globs instead of regex. By default
  231. # nothing is ignored.
  232. # file_ignore_glob:
  233. # - '*.pyc'
  234. # - '*/somefolder/*.bak'
  235. # File Server Backend
  236. # Salt supports a modular fileserver backend system, this system allows
  237. # the salt master to link directly to third party systems to gather and
  238. # manage the files available to minions. Multiple backends can be
  239. # configured and will be searched for the requested file in the order in which
  240. # they are defined here. The default setting only enables the standard backend
  241. # "roots" which uses the "file_roots" option.
  242. #fileserver_backend:
  243. # - roots
  244. # To use multiple backends list them in the order they are searched:
  245. # fileserver_backend:
  246. # - git
  247. # - roots
  248. # Git fileserver backend configuration
  249. # When using the git fileserver backend at least one git remote needs to be
  250. # defined. The user running the salt master will need read access to the repo.
  251. # gitfs_remotes:
  252. # - git://github.com/saltstack/salt-states.git
  253. # - file:///var/git/saltmaster
  254. # The repos will be searched in order to find the file requested by a client
  255. # and the first repo to have the file will return it.
  256. # When using the git backend branches and tags are translated into salt
  257. # environments.
  258. # Note: file:// repos will be treated as a remote, so refs you want used must
  259. # exist in that repo as *local* refs.
  260. ##### Pillar settings #####
  261. ##########################################
  262. # Salt Pillars allow for the building of global data that can be made selectively
  263. # available to different minions based on minion grain filtering. The Salt
  264. # Pillar is laid out in the same fashion as the file server, with environments,
  265. # a top file and sls files. However, pillar data does not need to be in the
  266. # highstate format, and is generally just key/value pairs.
  267. #pillar_roots:
  268. # base:
  269. # - /srv/pillar
  270. # ext_pillar:
  271. # - hiera: /etc/hiera.yaml
  272. # - cmd_yaml: cat /etc/salt/yaml
  273. # The pillar_opts option adds the master configuration file data to a dict in
  274. # the pillar called "master". This is used to set simple configurations in the
  275. # master config file that can then be used on minions.
  276. #pillar_opts: True
  277. ##### Syndic settings #####
  278. ##########################################
  279. # The Salt syndic is used to pass commands through a master from a higher
  280. # master. Using the syndic is simple, if this is a master that will have
  281. # syndic servers(s) below it set the "order_masters" setting to True, if this
  282. # is a master that will be running a syndic daemon for passthrough the
  283. # "syndic_master" setting needs to be set to the location of the master server
  284. # to receive commands from.
  285. # Set the order_masters setting to True if this master will command lower
  286. # masters' syndic interfaces.
  287. #order_masters: False
  288. # If this master will be running a salt syndic daemon, syndic_master tells
  289. # this master where to receive commands from.
  290. #syndic_master: masterofmaster
  291. ##### Peer Publish settings #####
  292. ##########################################
  293. # Salt minions can send commands to other minions, but only if the minion is
  294. # allowed to. By default "Peer Publication" is disabled, and when enabled it
  295. # is enabled for specific minions and specific commands. This allows secure
  296. # compartmentalization of commands based on individual minions.
  297. # The configuration uses regular expressions to match minions and then a list
  298. # of regular expressions to match functions. The following will allow the
  299. # minion authenticated as foo.example.com to execute functions from the test
  300. # and pkg modules.
  301. # peer:
  302. # foo.example.com:
  303. # - test.*
  304. # - pkg.*
  305. #
  306. # This will allow all minions to execute all commands:
  307. # peer:
  308. # .*:
  309. # - .*
  310. # This is not recommended, since it would allow anyone who gets root on any
  311. # single minion to instantly have root on all of the minions!
  312. # Minions can also be allowed to execute runners from the salt master.
  313. # Since executing a runner from the minion could be considered a security risk,
  314. # it needs to be enabled. This setting functions just like the peer setting
  315. # except that it opens up runners instead of module functions.
  316. #
  317. # All peer runner support is turned off by default and must be enabled before
  318. # using. This will enable all peer runners for all minions:
  319. #
  320. # peer_run:
  321. # .*:
  322. # - .*
  323. #
  324. # To enable just the manage.up runner for the minion foo.example.com:
  325. #
  326. # peer_run:
  327. # foo.example.com:
  328. # - manage.up
  329. ##### Logging settings #####
  330. ##########################################
  331. # The location of the master log file
  332. # The master log can be sent to a regular file, local path name, or network
  333. # location. Remote logging works best when configured to use rsyslogd(8) (e.g.:
  334. # ``file:///dev/log``), with rsyslogd(8) configured for network logging. The URI
  335. # format is: <file|udp|tcp>://<host|socketpath>:<port-if-required>/<log-facility>
  336. #log_file: /var/log/salt/master
  337. #log_file: file:///dev/log
  338. #log_file: udp://loghost:10514
  339. #log_file: /var/log/salt/master
  340. #key_logfile: /var/log/salt/key
  341. # The level of messages to send to the console.
  342. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  343. #log_level: warning
  344. # The level of messages to send to the log file.
  345. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  346. #log_level_logfile: warning
  347. # The date and time format used in log messages. Allowed date/time formating
  348. # can be seen here: http://docs.python.org/library/time.html#time.strftime
  349. #log_datefmt: '%H:%M:%S'
  350. #log_datefmt_logfile: '%Y-%m-%d %H:%M:%S'
  351. # The format of the console logging messages. Allowed formatting options can
  352. # be seen here: http://docs.python.org/library/logging.html#logrecord-attributes
  353. #log_fmt_console: '[%(levelname)-8s] %(message)s'
  354. #log_fmt_logfile: '%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'
  355. # This can be used to control logging levels more specificically. This
  356. # example sets the main salt library at the 'warning' level, but sets
  357. # 'salt.modules' to log at the 'debug' level:
  358. # log_granular_levels:
  359. # 'salt': 'warning',
  360. # 'salt.modules': 'debug'
  361. #
  362. #log_granular_levels: {}
  363. ##### Node Groups #####
  364. ##########################################
  365. # Node groups allow for logical groupings of minion nodes.
  366. # A group consists of a group name and a compound target.
  367. #
  368. # nodegroups:
  369. # group1: 'L@foo.domain.com,bar.domain.com,baz.domain.com and bl*.domain.com'
  370. # group2: 'G@os:Debian and foo.domain.com'
  371. ##### Range Cluster settings #####
  372. ##########################################
  373. # The range server (and optional port) that serves your cluster information
  374. # https://github.com/grierj/range/wiki/Introduction-to-Range-with-YAML-files
  375. #
  376. # range_server: range:80
  377. ##### Windows Software Repo settings #####
  378. ##############################################
  379. # Location of the repo on the master
  380. # win_repo: '/srv/salt/win/repo'
  381. # Location of the master's repo cache file
  382. # win_repo_mastercachefile: '/srv/salt/win/repo/winrepo.p'
  383. # List of git repositories to include with the local repo
  384. # win_gitrepos:
  385. # - 'https://github.com/saltstack/salt-winrepo.git'