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.

476 lines
18KB

  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: {{ salt['pillar.get']('salt_master: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: {{ salt['pillar.get']('salt_master: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: {{ salt['pillar.get']('salt_master: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. client_acl: {{ salt['pillar.get']('salt_master:client_acl', '{}') }}
  127. # Blacklist any of the following users or modules
  128. #
  129. # This example would blacklist all non sudo users, including root from
  130. # running any commands. It would also blacklist any use of the "cmd"
  131. # module.
  132. # This is completely disabled by default.
  133. #
  134. # client_acl_blacklist:
  135. # users:
  136. # - root
  137. # - '^(?!sudo_).*$' # all non sudo users
  138. # modules:
  139. # - cmd
  140. # The external auth system uses the Salt auth modules to authenticate and
  141. # validate users to access areas of the Salt system
  142. #
  143. # external_auth:
  144. # pam:
  145. # fred:
  146. # - test.*
  147. external_auth: {{ salt['pillar.get']('salt_master:external_auth', '{}') }}
  148. #
  149. # Time (in seconds) for a newly generated token to live. Default: 12 hours
  150. # token_expire: 43200
  151. ##### Master Module Management #####
  152. ##########################################
  153. # Manage how master side modules are loaded
  154. # Add any additional locations to look for master runners
  155. #runner_dirs: []
  156. # Enable Cython for master side modules
  157. #cython_enable: False
  158. ##### State System settings #####
  159. ##########################################
  160. # The state system uses a "top" file to tell the minions what environment to
  161. # use and what modules to use. The state_top file is defined relative to the
  162. # root of the base environment as defined in "File Server settings" below.
  163. #state_top: top.sls
  164. # The master_tops option replaces the external_nodes option by creating
  165. # a plugable system for the generation of external top data. The external_nodes
  166. # option is deprecated by the master_tops option.
  167. # To gain the capabilities of the classic external_nodes system, use the
  168. # following configuration:
  169. # master_tops:
  170. # ext_nodes: <Shell command which returns yaml>
  171. #
  172. #master_tops: {}
  173. # The external_nodes option allows Salt to gather data that would normally be
  174. # placed in a top file. The external_nodes option is the executable that will
  175. # return the ENC data. Remember that Salt will look for external nodes AND top
  176. # files and combine the results if both are enabled!
  177. #external_nodes: None
  178. # The renderer to use on the minions to render the state data
  179. #renderer: yaml_jinja
  180. # The failhard option tells the minions to stop immediately after the first
  181. # failure detected in the state execution, defaults to False
  182. #failhard: False
  183. # The state_verbose and state_output settings can be used to change the way
  184. # state system data is printed to the display. By default all data is printed.
  185. # The state_verbose setting can be set to True or False, when set to False
  186. # all data that has a result of True and no changes will be suppressed.
  187. #state_verbose: True
  188. # The state_output setting changes if the output is the full multi line
  189. # output for each changed state if set to 'full', but if set to 'terse'
  190. # the output will be shortened to a single line. If set to 'mixed', the output
  191. # will be terse unless a state failed, in which case that output will be full.
  192. #state_output: full
  193. ##### File Server settings #####
  194. ##########################################
  195. # Salt runs a lightweight file server written in zeromq to deliver files to
  196. # minions. This file server is built into the master daemon and does not
  197. # require a dedicated port.
  198. # The file server works on environments passed to the master, each environment
  199. # can have multiple root directories, the subdirectories in the multiple file
  200. # roots cannot match, otherwise the downloaded files will not be able to be
  201. # reliably ensured. A base environment is required to house the top file.
  202. # Example:
  203. # file_roots:
  204. # base:
  205. # - /srv/salt/
  206. # dev:
  207. # - /srv/salt/dev/services
  208. # - /srv/salt/dev/states
  209. # prod:
  210. # - /srv/salt/prod/services
  211. # - /srv/salt/prod/states
  212. #file_roots:
  213. # base:
  214. # - /srv/salt
  215. # The hash_type is the hash to use when discovering the hash of a file on
  216. # the master server, the default is md5, but sha1, sha224, sha256, sha384
  217. # and sha512 are also supported.
  218. #hash_type: md5
  219. # The buffer size in the file server can be adjusted here:
  220. #file_buffer_size: 1048576
  221. # A regular expression (or a list of expressions) that will be matched
  222. # against the file path before syncing the modules and states to the minions.
  223. # This includes files affected by the file.recurse state.
  224. # For example, if you manage your custom modules and states in subversion
  225. # and don't want all the '.svn' folders and content synced to your minions,
  226. # you could set this to '/\.svn($|/)'. By default nothing is ignored.
  227. # file_ignore_regex:
  228. # - '/\.svn($|/)'
  229. # - '/\.git($|/)'
  230. # A file glob (or list of file globs) that will be matched against the file
  231. # path before syncing the modules and states to the minions. This is similar
  232. # to file_ignore_regex above, but works on globs instead of regex. By default
  233. # nothing is ignored.
  234. # file_ignore_glob:
  235. # - '*.pyc'
  236. # - '*/somefolder/*.bak'
  237. # File Server Backend
  238. # Salt supports a modular fileserver backend system, this system allows
  239. # the salt master to link directly to third party systems to gather and
  240. # manage the files available to minions. Multiple backends can be
  241. # configured and will be searched for the requested file in the order in which
  242. # they are defined here. The default setting only enables the standard backend
  243. # "roots" which uses the "file_roots" option.
  244. #fileserver_backend:
  245. # - roots
  246. # To use multiple backends list them in the order they are searched:
  247. # fileserver_backend:
  248. # - git
  249. # - roots
  250. fileserver_backend: {{ salt['pillar.get']('salt_master:fileserver_backend', '[]') }}
  251. # Git fileserver backend configuration
  252. # When using the git fileserver backend at least one git remote needs to be
  253. # defined. The user running the salt master will need read access to the repo.
  254. # gitfs_remotes:
  255. # - git://github.com/saltstack/salt-states.git
  256. # - file:///var/git/saltmaster
  257. # The repos will be searched in order to find the file requested by a client
  258. # and the first repo to have the file will return it.
  259. # When using the git backend branches and tags are translated into salt
  260. # environments.
  261. # Note: file:// repos will be treated as a remote, so refs you want used must
  262. # exist in that repo as *local* refs.
  263. gitfs_remotes: {{ salt['pillar.get']('salt_master:gitfs_remotes', '[]') }}
  264. ##### Pillar settings #####
  265. ##########################################
  266. # Salt Pillars allow for the building of global data that can be made selectively
  267. # available to different minions based on minion grain filtering. The Salt
  268. # Pillar is laid out in the same fashion as the file server, with environments,
  269. # a top file and sls files. However, pillar data does not need to be in the
  270. # highstate format, and is generally just key/value pairs.
  271. #pillar_roots:
  272. # base:
  273. # - /srv/pillar
  274. # ext_pillar:
  275. # - hiera: /etc/hiera.yaml
  276. # - cmd_yaml: cat /etc/salt/yaml
  277. # The pillar_opts option adds the master configuration file data to a dict in
  278. # the pillar called "master". This is used to set simple configurations in the
  279. # master config file that can then be used on minions.
  280. #pillar_opts: True
  281. ##### Syndic settings #####
  282. ##########################################
  283. # The Salt syndic is used to pass commands through a master from a higher
  284. # master. Using the syndic is simple, if this is a master that will have
  285. # syndic servers(s) below it set the "order_masters" setting to True, if this
  286. # is a master that will be running a syndic daemon for passthrough the
  287. # "syndic_master" setting needs to be set to the location of the master server
  288. # to receive commands from.
  289. # Set the order_masters setting to True if this master will command lower
  290. # masters' syndic interfaces.
  291. #order_masters: False
  292. # If this master will be running a salt syndic daemon, syndic_master tells
  293. # this master where to receive commands from.
  294. #syndic_master: masterofmaster
  295. ##### Peer Publish settings #####
  296. ##########################################
  297. # Salt minions can send commands to other minions, but only if the minion is
  298. # allowed to. By default "Peer Publication" is disabled, and when enabled it
  299. # is enabled for specific minions and specific commands. This allows secure
  300. # compartmentalization of commands based on individual minions.
  301. # The configuration uses regular expressions to match minions and then a list
  302. # of regular expressions to match functions. The following will allow the
  303. # minion authenticated as foo.example.com to execute functions from the test
  304. # and pkg modules.
  305. # peer:
  306. # foo.example.com:
  307. # - test.*
  308. # - pkg.*
  309. #
  310. # This will allow all minions to execute all commands:
  311. # peer:
  312. # .*:
  313. # - .*
  314. # This is not recommended, since it would allow anyone who gets root on any
  315. # single minion to instantly have root on all of the minions!
  316. # Minions can also be allowed to execute runners from the salt master.
  317. # Since executing a runner from the minion could be considered a security risk,
  318. # it needs to be enabled. This setting functions just like the peer setting
  319. # except that it opens up runners instead of module functions.
  320. #
  321. # All peer runner support is turned off by default and must be enabled before
  322. # using. This will enable all peer runners for all minions:
  323. #
  324. # peer_run:
  325. # .*:
  326. # - .*
  327. #
  328. # To enable just the manage.up runner for the minion foo.example.com:
  329. #
  330. # peer_run:
  331. # foo.example.com:
  332. # - manage.up
  333. ##### Logging settings #####
  334. ##########################################
  335. # The location of the master log file
  336. # The master log can be sent to a regular file, local path name, or network
  337. # location. Remote logging works best when configured to use rsyslogd(8) (e.g.:
  338. # ``file:///dev/log``), with rsyslogd(8) configured for network logging. The URI
  339. # format is: <file|udp|tcp>://<host|socketpath>:<port-if-required>/<log-facility>
  340. #log_file: /var/log/salt/master
  341. #log_file: file:///dev/log
  342. #log_file: udp://loghost:10514
  343. #log_file: /var/log/salt/master
  344. #key_logfile: /var/log/salt/key
  345. # The level of messages to send to the console.
  346. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  347. #log_level: warning
  348. # The level of messages to send to the log file.
  349. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  350. #log_level_logfile: warning
  351. # The date and time format used in log messages. Allowed date/time formating
  352. # can be seen here: http://docs.python.org/library/time.html#time.strftime
  353. #log_datefmt: '%H:%M:%S'
  354. #log_datefmt_logfile: '%Y-%m-%d %H:%M:%S'
  355. # The format of the console logging messages. Allowed formatting options can
  356. # be seen here: http://docs.python.org/library/logging.html#logrecord-attributes
  357. #log_fmt_console: '[%(levelname)-8s] %(message)s'
  358. #log_fmt_logfile: '%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'
  359. # This can be used to control logging levels more specificically. This
  360. # example sets the main salt library at the 'warning' level, but sets
  361. # 'salt.modules' to log at the 'debug' level:
  362. # log_granular_levels:
  363. # 'salt': 'warning',
  364. # 'salt.modules': 'debug'
  365. #
  366. #log_granular_levels: {}
  367. ##### Node Groups #####
  368. ##########################################
  369. # Node groups allow for logical groupings of minion nodes.
  370. # A group consists of a group name and a compound target.
  371. #
  372. # nodegroups:
  373. # group1: 'L@foo.domain.com,bar.domain.com,baz.domain.com and bl*.domain.com'
  374. # group2: 'G@os:Debian and foo.domain.com'
  375. ##### Range Cluster settings #####
  376. ##########################################
  377. # The range server (and optional port) that serves your cluster information
  378. # https://github.com/grierj/range/wiki/Introduction-to-Range-with-YAML-files
  379. #
  380. # range_server: range:80
  381. ##### Windows Software Repo settings #####
  382. ##############################################
  383. # Location of the repo on the master
  384. # win_repo: '/srv/salt/win/repo'
  385. # Location of the master's repo cache file
  386. # win_repo_mastercachefile: '/srv/salt/win/repo/winrepo.p'
  387. # List of git repositories to include with the local repo
  388. # win_gitrepos:
  389. # - 'https://github.com/saltstack/salt-winrepo.git'