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.

996 lines
37KB

  1. # This file managed by Salt, do not edit by hand!!
  2. # Based on salt version 2014.7 default config
  3. {% set reserved_keys = ['master', 'minion', 'cloud', 'salt_cloud_certs'] -%}
  4. {% set cfg_salt = pillar.get('salt', {}) -%}
  5. {% set cfg_master = cfg_salt.get('master', {}) -%}
  6. {%- macro get_config(configname, default_value) -%}
  7. {%- if configname in cfg_master -%}
  8. {{ configname }}: {{ cfg_master[configname] }}
  9. {%- elif configname in cfg_salt and configname not in reserved_keys -%}
  10. {{ configname }}: {{ cfg_salt[configname] }}
  11. {%- else -%}
  12. #{{ configname }}: {{ default_value }}
  13. {%- endif -%}
  14. {%- endmacro -%}
  15. {%- from 'salt/formulas.jinja' import file_roots, formulas with context -%}
  16. ##### Primary configuration settings #####
  17. ##########################################
  18. # This configuration file is used to manage the behavior of the Salt Master
  19. # Values that are commented out but have no space after the comment are
  20. # defaults that need not be set in the config. If there is a space after the
  21. # comment that the value is presented as an example and is not the default.
  22. # Per default, the master will automatically include all config files
  23. # from master.d/*.conf (master.d is a directory in the same directory
  24. # as the main master config file).
  25. {{ get_config('default_include', 'master.d/*.conf') }}
  26. # The address of the interface to bind to:
  27. {{ get_config('interface', '0.0.0.0') }}
  28. # Whether the master should listen for IPv6 connections. If this is set to True,
  29. # the interface option must be adjusted, too. (For example: "interface: '::'")
  30. {{ get_config('ipv6', 'False') }}
  31. # The tcp port used by the publisher:
  32. {{ get_config('publish_port', '4505') }}
  33. # The user under which the salt master will run. Salt will update all
  34. # permissions to allow the specified user to run the master. The exception is
  35. # the job cache, which must be deleted if this user is changed. If the
  36. # modified files cause conflicts, set verify_env to False.
  37. {{ get_config('user', 'root') }}
  38. # Max open files
  39. #
  40. # Each minion connecting to the master uses AT LEAST one file descriptor, the
  41. # master subscription connection. If enough minions connect you might start
  42. # seeing on the console (and then salt-master crashes):
  43. # Too many open files (tcp_listener.cpp:335)
  44. # Aborted (core dumped)
  45. #
  46. # By default this value will be the one of `ulimit -Hn`, ie, the hard limit for
  47. # max open files.
  48. #
  49. # If you wish to set a different value than the default one, uncomment and
  50. # configure this setting. Remember that this value CANNOT be higher than the
  51. # hard limit. Raising the hard limit depends on your OS and/or distribution,
  52. # a good way to find the limit is to search the internet. For example:
  53. # raise max open files hard limit debian
  54. #
  55. {{ get_config('max_open_files', '100000') }}
  56. # The number of worker threads to start. These threads are used to manage
  57. # return calls made from minions to the master. If the master seems to be
  58. # running slowly, increase the number of threads.
  59. {{ get_config('worker_threads', '5') }}
  60. # The port used by the communication interface. The ret (return) port is the
  61. # interface used for the file server, authentication, job returns, etc.
  62. {{ get_config('ret_port', '4506') }}
  63. # Specify the location of the daemon process ID file:
  64. {{ get_config('pidfile', '/var/run/salt-master.pid') }}
  65. # The root directory prepended to these options: pki_dir, cachedir,
  66. # sock_dir, log_file, autosign_file, autoreject_file, extension_modules,
  67. # key_logfile, pidfile:
  68. {{ get_config('root_dir', '/') }}
  69. # Directory used to store public key data:
  70. {{ get_config('pki_dir', '/etc/salt/pki/master') }}
  71. # Directory to store job and cache data:
  72. {{ get_config('cachedir', '/var/cache/salt/master') }}
  73. # Directory for custom modules. This directory can contain subdirectories for
  74. # each of Salt's module types such as "runners", "output", "wheel", "modules",
  75. # "states", "returners", etc.
  76. {{ get_config('extension_modules', '<no default>') }}
  77. # Verify and set permissions on configuration directories at startup:
  78. {{ get_config('verify_env', 'True') }}
  79. # Set the number of hours to keep old job information in the job cache:
  80. {{ get_config('keep_jobs', '24') }}
  81. # Set the default timeout for the salt command and api. The default is 5
  82. # seconds.
  83. {{ get_config('timeout', '5') }}
  84. # The loop_interval option controls the seconds for the master's maintenance
  85. # process check cycle. This process updates file server backends, cleans the
  86. # job cache and executes the scheduler.
  87. {{ get_config('loop_interval', '60') }}
  88. # Set the default outputter used by the salt command. The default is "nested".
  89. {{ get_config('output', 'nested') }}
  90. # Return minions that timeout when running commands like test.ping
  91. {{ get_config('show_timeout', 'True') }}
  92. # Display the jid when a job is published
  93. {{ get_config('show_jid', 'False') }}
  94. # By default, output is colored. To disable colored output, set the color value
  95. # to False.
  96. {{ get_config('color', 'True') }}
  97. # Do not strip off the colored output from nested results and state outputs
  98. # (true by default).
  99. {{ get_config('strip_colors', 'False') }}
  100. # Set the directory used to hold unix sockets:
  101. {{ get_config('sock_dir', '/var/run/salt/master') }}
  102. # The master can take a while to start up when lspci and/or dmidecode is used
  103. # to populate the grains for the master. Enable if you want to see GPU hardware
  104. # data for your master.
  105. {{ get_config('enable_gpu_grains', 'False') }}
  106. # The master maintains a job cache. While this is a great addition, it can be
  107. # a burden on the master for larger deployments (over 5000 minions).
  108. # Disabling the job cache will make previously executed jobs unavailable to
  109. # the jobs system and is not generally recommended.
  110. {{ get_config('job_cache', 'True') }}
  111. # Cache minion grains and pillar data in the cachedir.
  112. {{ get_config('minion_data_cache', 'True') }}
  113. # Store all returns in the given returner.
  114. # Setting this option requires that any returner-specific configuration also
  115. # be set. See various returners in salt/returners for details on required
  116. # configuration values. (See also, event_return_queue below.)
  117. #
  118. {{ get_config('event_return', 'mysql') }}
  119. # On busy systems, enabling event_returns can cause a considerable load on
  120. # the storage system for returners. Events can be queued on the master and
  121. # stored in a batched fashion using a single transaction for multiple events.
  122. # By default, events are not queued.
  123. {{ get_config('event_return_queue', '0') }}
  124. # Only events returns matching tags in a whitelist
  125. {% if 'event_return_whitelist' in cfg_master -%}
  126. event_return_whitelist:
  127. {%- for event_return in cfg_master['event_return_whitelist'] %}
  128. - {{ event_return }}
  129. {%- endfor -%}
  130. {% elif 'event_return_whitelist' in cfg_salt -%}
  131. event_return_whitelist:
  132. {%- for event_return in cfg_salt['event_return_whitelist'] %}
  133. - {{ event_return }}
  134. {%- endfor -%}
  135. {% else -%}
  136. # event_return_whitelist:
  137. # - salt/master/a_tag
  138. # - salt/master/another_tag
  139. {% endif %}
  140. # Store all event returns _except_ the tags in a blacklist
  141. {% if 'event_return_blacklist' in cfg_master -%}
  142. event_return_blacklist:
  143. {%- for event_return in cfg_master['event_return_blacklist'] %}
  144. - {{ event_return }}
  145. {%- endfor -%}
  146. {% elif 'event_return_blacklist' in cfg_salt -%}
  147. event_return_blacklist:
  148. {%- for event_return in cfg_salt['event_return_blacklist'] %}
  149. - {{ event_return }}
  150. {%- endfor -%}
  151. {% else -%}
  152. # event_return_blacklist:
  153. # - salt/master/not_this_tag
  154. # - salt/master/or_this_one
  155. {% endif %}
  156. # Passing very large events can cause the minion to consume large amounts of
  157. # memory. This value tunes the maximum size of a message allowed onto the
  158. # master event bus. The value is expressed in bytes.
  159. {{ get_config('max_event_size', '1048576') }}
  160. # By default, the master AES key rotates every 24 hours. The next command
  161. # following a key rotation will trigger a key refresh from the minion which may
  162. # result in minions which do not respond to the first command after a key refresh.
  163. #
  164. # To tell the master to ping all minions immediately after an AES key refresh, set
  165. # ping_on_rotate to True. This should mitigate the issue where a minion does not
  166. # appear to initially respond after a key is rotated.
  167. #
  168. # Note that ping_on_rotate may cause high load on the master immediately after
  169. # the key rotation event as minions reconnect. Consider this carefully if this
  170. # salt master is managing a large number of minions.
  171. #
  172. # If disabled, it is recommended to handle this event by listening for the
  173. # 'aes_key_rotate' event with the 'key' tag and acting appropriately.
  174. {{ get_config('ping_on_rotate', 'False') }}
  175. # By default, the master deletes its cache of minion data when the key for that
  176. # minion is removed. To preserve the cache after key deletion, set
  177. # 'preserve_minion_cache' to True.
  178. #
  179. # WARNING: This may have security implications if compromised minions auth with
  180. # a previous deleted minion ID.
  181. {{ get_config('preserve_minion_cache', 'False') }}
  182. # If max_minions is used in large installations, the master might experience
  183. # high-load situations because of having to check the number of connected
  184. # minions for every authentication. This cache provides the minion-ids of
  185. # all connected minions to all MWorker-processes and greatly improves the
  186. # performance of max_minions.
  187. {{ get_config('con_cache', 'False') }}
  188. # The master can include configuration from other files. To enable this,
  189. # pass a list of paths to this option. The paths can be either relative or
  190. # absolute; if relative, they are considered to be relative to the directory
  191. # the main master configuration file lives in (this file). Paths can make use
  192. # of shell-style globbing. If no files are matched by a path passed to this
  193. # option, then the master will log a warning message.
  194. #
  195. # Include a config file from some other path:
  196. # include: /etc/salt/extra_config
  197. #
  198. # Include config from several files and directories:
  199. # include:
  200. # - /etc/salt/extra_config
  201. {{ get_config('include', '[]') }}
  202. ##### Security settings #####
  203. ##########################################
  204. # Enable "open mode", this mode still maintains encryption, but turns off
  205. # authentication, this is only intended for highly secure environments or for
  206. # the situation where your keys end up in a bad state. If you run in open mode
  207. # you do so at your own risk!
  208. {{ get_config('open_mode', 'False') }}
  209. # Enable auto_accept, this setting will automatically accept all incoming
  210. # public keys from the minions. Note that this is insecure.
  211. {{ get_config('auto_accept', 'False') }}
  212. # Time in minutes that a incoming public key with a matching name found in
  213. # pki_dir/minion_autosign/keyid is automatically accepted. Expired autosign keys
  214. # are removed when the master checks the minion_autosign directory.
  215. # 0 equals no timeout
  216. {{ get_config('autosign_timeout', '120') }}
  217. # If the autosign_file is specified, incoming keys specified in the
  218. # autosign_file will be automatically accepted. This is insecure. Regular
  219. # expressions as well as globing lines are supported.
  220. {{ get_config('autosign_file', '/etc/salt/autosign.conf') }}
  221. # Works like autosign_file, but instead allows you to specify minion IDs for
  222. # which keys will automatically be rejected. Will override both membership in
  223. # the autosign_file and the auto_accept setting.
  224. {{ get_config('autoreject_file', '/etc/salt/autoreject.conf') }}
  225. # Enable permissive access to the salt keys. This allows you to run the
  226. # master or minion as root, but have a non-root group be given access to
  227. # your pki_dir. To make the access explicit, root must belong to the group
  228. # you've given access to. This is potentially quite insecure. If an autosign_file
  229. # is specified, enabling permissive_pki_access will allow group access to that
  230. # specific file.
  231. {{ get_config('permissive_pki_access', 'False') }}
  232. # Allow users on the master access to execute specific commands on minions.
  233. # This setting should be treated with care since it opens up execution
  234. # capabilities to non root users. By default this capability is completely
  235. # disabled.
  236. #client_acl:
  237. # larry:
  238. # - test.ping
  239. # - network.*
  240. {% if 'client_acl' in cfg_master -%}
  241. client_acl:
  242. {%- for name, user in cfg_master['client_acl']|dictsort %}
  243. {{ name}}:
  244. {%- for command in user %}
  245. - {% raw %}'{% endraw %}{{ command }}{% raw %}'{% endraw %}
  246. {%- endfor -%}
  247. {%- endfor -%}
  248. {% elif 'client_acl' in cfg_salt -%}
  249. client_acl:
  250. {%- for name, user in cfg_salt['client_acl']|dictsort %}
  251. {{ name }}:
  252. {%- for command in user %}
  253. - {% raw %}'{% endraw %}{{ command }}{% raw %}'{% endraw %}
  254. {%- endfor -%}
  255. {%- endfor -%}
  256. {% else -%}
  257. #client_acl:
  258. # larry:
  259. # - test.ping
  260. # - network.*
  261. {%- endif %}
  262. # Blacklist any of the following users or modules
  263. #
  264. # This example would blacklist all non sudo users, including root from
  265. # running any commands. It would also blacklist any use of the "cmd"
  266. # module. This is completely disabled by default.
  267. #
  268. {% if 'client_acl_blacklist' in cfg_master %}
  269. client_acl_blacklist:
  270. users:
  271. {% for user in cfg_master['client_acl_blacklist'].get('users', []) %}
  272. - {{ user }}
  273. {% endfor %}
  274. modules:
  275. {% for mod in cfg_master['client_acl_blacklist'].get('modules', []) %}
  276. - {{ mod }}
  277. {% endfor %}
  278. {% elif 'client_acl_blacklist' in cfg_salt %}
  279. client_acl_blacklist:
  280. users:
  281. {% for user in cfg_salt['client_acl_blacklist'].get('users', []) %}
  282. - {{ user }}
  283. {% endfor %}
  284. modules:
  285. {% for mod in cfg_salt['client_acl_blacklist'].get('modules', []) %}
  286. - {{ mod }}
  287. {% endfor %}
  288. {% else %}
  289. #client_acl_blacklist:
  290. # users:
  291. # - root
  292. # - '^(?!sudo_).*$' # all non sudo users
  293. # modules:
  294. # - cmd
  295. {% endif %}
  296. # Enforce client_acl & client_acl_blacklist when users have sudo
  297. # access to the salt command.
  298. #
  299. {{ get_config('sudo_acl', 'False') }}
  300. # The external auth system uses the Salt auth modules to authenticate and
  301. # validate users to access areas of the Salt system.
  302. #external_auth:
  303. # pam:
  304. # fred:
  305. # - test.*
  306. {{ get_config('external_auth', '{}') }}
  307. # Time (in seconds) for a newly generated token to live. Default: 12 hours
  308. {{ get_config('token_expire', '43200') }}
  309. # Allow minions to push files to the master. This is disabled by default, for
  310. # security purposes.
  311. {{ get_config('file_recv', 'False') }}
  312. # Set a hard-limit on the size of the files that can be pushed to the master.
  313. # It will be interpreted as megabytes. Default: 100
  314. {{ get_config('file_recv_max_size', '100') }}
  315. # Signature verification on messages published from the master.
  316. # This causes the master to cryptographically sign all messages published to its event
  317. # bus, and minions then verify that signature before acting on the message.
  318. #
  319. # This is False by default.
  320. #
  321. # Note that to facilitate interoperability with masters and minions that are different
  322. # versions, if sign_pub_messages is True but a message is received by a minion with
  323. # no signature, it will still be accepted, and a warning message will be logged.
  324. # Conversely, if sign_pub_messages is False, but a minion receives a signed
  325. # message it will be accepted, the signature will not be checked, and a warning message
  326. # will be logged. This behavior went away in Salt 2014.1.0 and these two situations
  327. # will cause minion to throw an exception and drop the message.
  328. {{ get_config('sign_pub_message', 'False') }}
  329. {{ get_config('master_sign_pubkey', 'False') }}
  330. ##### Master Module Management #####
  331. ##########################################
  332. # Manage how master side modules are loaded.
  333. # Add any additional locations to look for master runners:
  334. {{ get_config('runner_dirs', '[]') }}
  335. # Enable Cython for master side modules:
  336. {{ get_config('cython_enable', 'False') }}
  337. ##### State System settings #####
  338. ##########################################
  339. # The state system uses a "top" file to tell the minions what environment to
  340. # use and what modules to use. The state_top file is defined relative to the
  341. # root of the base environment as defined in "File Server settings" below.
  342. {{ get_config('state_top', 'top.sls') }}
  343. # The master_tops option replaces the external_nodes option by creating
  344. # a plugable system for the generation of external top data. The external_nodes
  345. # option is deprecated by the master_tops option.
  346. #
  347. # To gain the capabilities of the classic external_nodes system, use the
  348. # following configuration:
  349. # master_tops:
  350. # ext_nodes: <Shell command which returns yaml>
  351. #
  352. {{ get_config('master_tops', '{}') }}
  353. # The external_nodes option allows Salt to gather data that would normally be
  354. # placed in a top file. The external_nodes option is the executable that will
  355. # return the ENC data. Remember that Salt will look for external nodes AND top
  356. # files and combine the results if both are enabled!
  357. {{ get_config('external_nodes', 'None') }}
  358. # The renderer to use on the minions to render the state data
  359. {{ get_config('renderer', 'yaml_jinja') }}
  360. # The Jinja renderer can strip extra carriage returns and whitespace
  361. # See http://jinja.pocoo.org/docs/api/#high-level-api
  362. #
  363. # If this is set to True the first newline after a Jinja block is removed
  364. # (block, not variable tag!). Defaults to False, corresponds to the Jinja
  365. # environment init variable "trim_blocks".
  366. {{ get_config('jinja_trim_blocks', 'False') }}
  367. #
  368. # If this is set to True leading spaces and tabs are stripped from the start
  369. # of a line to a block. Defaults to False, corresponds to the Jinja
  370. # environment init variable "lstrip_blocks".
  371. {{ get_config('jinja_lstrip_blocks', 'False') }}
  372. # The failhard option tells the minions to stop immediately after the first
  373. # failure detected in the state execution, defaults to False
  374. {{ get_config('failhard', 'False') }}
  375. # The state_verbose and state_output settings can be used to change the way
  376. # state system data is printed to the display. By default all data is printed.
  377. # The state_verbose setting can be set to True or False, when set to False
  378. # all data that has a result of True and no changes will be suppressed.
  379. {{ get_config('state_verbose', 'True') }}
  380. # The state_output setting changes if the output is the full multi line
  381. # output for each changed state if set to 'full', but if set to 'terse'
  382. # the output will be shortened to a single line. If set to 'mixed', the output
  383. # will be terse unless a state failed, in which case that output will be full.
  384. # If set to 'changes', the output will be full unless the state didn't change.
  385. {{ get_config('state_output', 'full') }}
  386. # Automatically aggregate all states that have support for mod_aggregate by
  387. # setting to True. Or pass a list of state module names to automatically
  388. # aggregate just those types.
  389. #
  390. # state_aggregate:
  391. # - pkg
  392. #
  393. #state_aggregate: False
  394. ##### File Server settings #####
  395. ##########################################
  396. # Salt runs a lightweight file server written in zeromq to deliver files to
  397. # minions. This file server is built into the master daemon and does not
  398. # require a dedicated port.
  399. # The file server works on environments passed to the master, each environment
  400. # can have multiple root directories, the subdirectories in the multiple file
  401. # roots cannot match, otherwise the downloaded files will not be able to be
  402. # reliably ensured. A base environment is required to house the top file.
  403. # Example:
  404. # file_roots:
  405. # base:
  406. # - /srv/salt/
  407. # dev:
  408. # - /srv/salt/dev/services
  409. # - /srv/salt/dev/states
  410. # prod:
  411. # - /srv/salt/prod/services
  412. # - /srv/salt/prod/states
  413. {% if 'file_roots' in cfg_master -%}
  414. {{ file_roots(cfg_master['file_roots']) }}
  415. {%- elif 'file_roots' in cfg_salt -%}
  416. {{ file_roots(cfg_salt['file_roots']) }}
  417. {%- elif formulas|length -%}
  418. {{ file_roots({'base': ['/srv/salt']}) }}
  419. {%- else -%}
  420. #file_roots:
  421. # base:
  422. # - /srv/salt
  423. {%- endif %}
  424. # The hash_type is the hash to use when discovering the hash of a file on
  425. # the master server. The default is md5, but sha1, sha224, sha256, sha384
  426. # and sha512 are also supported.
  427. #
  428. # Prior to changing this value, the master should be stopped and all Salt
  429. # caches should be cleared.
  430. {{ get_config('hash_type', 'md5') }}
  431. # The buffer size in the file server can be adjusted here:
  432. {{ get_config('file_buffer_size', '1048576') }}
  433. # A regular expression (or a list of expressions) that will be matched
  434. # against the file path before syncing the modules and states to the minions.
  435. # This includes files affected by the file.recurse state.
  436. # For example, if you manage your custom modules and states in subversion
  437. # and don't want all the '.svn' folders and content synced to your minions,
  438. # you could set this to '/\.svn($|/)'. By default nothing is ignored.
  439. {% if 'file_ignore_regex' in cfg_master %}
  440. file_ignore_regex:
  441. {% for regex in cfg_master['file_ignore_regex'] %}
  442. - {{ regex }}
  443. {% endfor %}
  444. {% elif 'file_ignore_regex' in cfg_salt %}
  445. file_ignore_regex:
  446. {% for regex in cfg_salt['file_ignore_regex'] %}
  447. - {{ regex }}
  448. {% endfor %}
  449. {% else %}
  450. #file_ignore_regex:
  451. # - '/\.svn($|/)'
  452. # - '/\.git($|/)'
  453. {% endif %}
  454. # A file glob (or list of file globs) that will be matched against the file
  455. # path before syncing the modules and states to the minions. This is similar
  456. # to file_ignore_regex above, but works on globs instead of regex. By default
  457. # nothing is ignored.
  458. {% if 'file_ignore_glob' in cfg_master %}
  459. file_ignore_glob:
  460. {% for glob in cfg_master['file_ignore_glob'] %}
  461. - {{ glob }}
  462. {% endfor %}
  463. {% elif 'file_ignore_glob' in cfg_salt %}
  464. file_ignore_glob:
  465. {% for glob in cfg_salt['file_ignore_glob'] %}
  466. - {{ glob }}
  467. {% endfor %}
  468. {% else %}
  469. # file_ignore_glob:
  470. # - '*.pyc'
  471. # - '*/somefolder/*.bak'
  472. # - '*.swp'
  473. {% endif %}
  474. # File Server Backend
  475. #
  476. # Salt supports a modular fileserver backend system, this system allows
  477. # the salt master to link directly to third party systems to gather and
  478. # manage the files available to minions. Multiple backends can be
  479. # configured and will be searched for the requested file in the order in which
  480. # they are defined here. The default setting only enables the standard backend
  481. # "roots" which uses the "file_roots" option.
  482. #fileserver_backend:
  483. # - roots
  484. #
  485. # To use multiple backends list them in the order they are searched:
  486. #fileserver_backend:
  487. # - git
  488. # - roots
  489. {% if 'fileserver_backend' in cfg_master -%}
  490. fileserver_backend:
  491. {%- for backend in cfg_master['fileserver_backend'] %}
  492. - {{ backend }}
  493. {%- endfor -%}
  494. {%- endif %}
  495. #
  496. # Uncomment the line below if you do not want the file_server to follow
  497. # symlinks when walking the filesystem tree. This is set to True
  498. # by default. Currently this only applies to the default roots
  499. # fileserver_backend.
  500. {{ get_config('fileserver_followsymlinks', 'False') }}
  501. #
  502. # Uncomment the line below if you do not want symlinks to be
  503. # treated as the files they are pointing to. By default this is set to
  504. # False. By uncommenting the line below, any detected symlink while listing
  505. # files on the Master will not be returned to the Minion.
  506. {{ get_config('fileserver_ignoresymlinks', 'True') }}
  507. #
  508. # By default, the Salt fileserver recurses fully into all defined environments
  509. # to attempt to find files. To limit this behavior so that the fileserver only
  510. # traverses directories with SLS files and special Salt directories like _modules,
  511. # enable the option below. This might be useful for installations where a file root
  512. # has a very large number of files and performance is impacted. Default is False.
  513. {{ get_config('fileserver_limit_traversal', 'False') }}
  514. #
  515. # The fileserver can fire events off every time the fileserver is updated,
  516. # these are disabled by default, but can be easily turned on by setting this
  517. # flag to True
  518. {{ get_config('fileserver_events', 'False') }}
  519. # Git File Server Backend Configuration
  520. #
  521. # Gitfs can be provided by one of two python modules: GitPython or pygit2. If
  522. # using pygit2, both libgit2 and git must also be installed.
  523. {{ get_config('gitfs_provider', 'gitpython') }}
  524. #
  525. # When using the git fileserver backend at least one git remote needs to be
  526. # defined. The user running the salt master will need read access to the repo.
  527. #
  528. # The repos will be searched in order to find the file requested by a client
  529. # and the first repo to have the file will return it.
  530. # When using the git backend branches and tags are translated into salt
  531. # environments.
  532. # Note: file:// repos will be treated as a remote, so refs you want used must
  533. # exist in that repo as *local* refs.
  534. {% if 'gitfs_remotes' in cfg_master -%}
  535. gitfs_remotes:
  536. {%- for remote in cfg_master['gitfs_remotes'] %}
  537. {%- if remote is iterable and remote is not string %}
  538. {%- for repo, children in remote.items() %}
  539. - {{ repo }}:
  540. {%- for child in children %}
  541. {%- for key, value in child.items() %}
  542. - {{ key }}: {{ value }}
  543. {%- endfor -%}
  544. {%- endfor -%}
  545. {%- endfor -%}
  546. {%- else %}
  547. - {{ remote }}
  548. {%- endif -%}
  549. {%- endfor -%}
  550. {%- endif %}
  551. #gitfs_remotes:
  552. # - git://github.com/saltstack/salt-states.git
  553. # - file:///var/git/saltmaster
  554. #
  555. # The gitfs_ssl_verify option specifies whether to ignore ssl certificate
  556. # errors when contacting the gitfs backend. You might want to set this to
  557. # false if you're using a git backend that uses a self-signed certificate but
  558. # keep in mind that setting this flag to anything other than the default of True
  559. # is a security concern, you may want to try using the ssh transport.
  560. {{ get_config('gitfs_ssl_verify', 'True') }}
  561. #
  562. # The gitfs_root option gives the ability to serve files from a subdirectory
  563. # within the repository. The path is defined relative to the root of the
  564. # repository and defaults to the repository root.
  565. {{ get_config('gitfs_root', 'somefolder/otherfolder') }}
  566. ##### Pillar settings #####
  567. ##########################################
  568. # Salt Pillars allow for the building of global data that can be made selectively
  569. # available to different minions based on minion grain filtering. The Salt
  570. # Pillar is laid out in the same fashion as the file server, with environments,
  571. # a top file and sls files. However, pillar data does not need to be in the
  572. # highstate format, and is generally just key/value pairs.
  573. {% if 'pillar_roots' in cfg_master -%}
  574. pillar_roots:
  575. {%- for name, roots in cfg_master['pillar_roots']|dictsort %}
  576. {{ name }}:
  577. {%- for dir in roots %}
  578. - {{ dir }}
  579. {%- endfor -%}
  580. {%- endfor -%}
  581. {% elif 'pillar_roots' in cfg_salt -%}
  582. pillar_roots:
  583. {%- for name, roots in cfg_salt['pillar_roots']|dictsort %}
  584. {{ name }}:
  585. {%- for dir in roots %}
  586. - {{ dir }}
  587. {%- endfor -%}
  588. {%- endfor -%}
  589. {%- else -%}
  590. #pillar_roots:
  591. # base:
  592. # - /srv/pillar
  593. {%- endif %}
  594. #
  595. {% if 'ext_pillar' in cfg_master %}
  596. ext_pillar:
  597. {% for pillar in cfg_master['ext_pillar'] %}
  598. - {{ pillar.items()[0][0] }}: {{ pillar.items()[0][1] }}
  599. {% endfor %}
  600. {% elif 'ext_pillar' in cfg_salt %}
  601. ext_pillar:
  602. {% for pillar in cfg_salt['ext_pillar'] %}
  603. - {{ pillar.items()[0][0] }}: {{ pillar.items()[0][1] }}
  604. {% endfor %}
  605. {% else %}
  606. #ext_pillar:
  607. # - hiera: /etc/hiera.yaml
  608. # - cmd_yaml: cat /etc/salt/yaml
  609. {% endif %}
  610. # The ext_pillar_first option allows for external pillar sources to populate
  611. # before file system pillar. This allows for targeting file system pillar from
  612. # ext_pillar.
  613. {{ get_config('ext_pillar_first', 'False') }}
  614. # The pillar_gitfs_ssl_verify option specifies whether to ignore ssl certificate
  615. # errors when contacting the pillar gitfs backend. You might want to set this to
  616. # false if you're using a git backend that uses a self-signed certificate but
  617. # keep in mind that setting this flag to anything other than the default of True
  618. # is a security concern, you may want to try using the ssh transport.
  619. {{ get_config('pillar_gitfs_ssl_verify', 'True') }}
  620. # The pillar_opts option adds the master configuration file data to a dict in
  621. # the pillar called "master". This is used to set simple configurations in the
  622. # master config file that can then be used on minions.
  623. {{ get_config('pillar_opts', 'True') }}
  624. # The pillar_source_merging_strategy option allows you to configure merging strategy
  625. # between different sources. It accepts four values: recurse, aggregate, overwrite,
  626. # or smart. Recurse will merge recursively mapping of data. Aggregate instructs
  627. # aggregation of elements between sources that use the #!yamlex renderer. Overwrite
  628. # will verwrite elements according the order in which they are processed. This is
  629. # behavior of the 2014.1 branch and earlier. Smart guesses the best strategy based
  630. # on the "renderer" setting and is the default value.
  631. {{ get_config('pillar_source_merging_strategy', 'smart') }}
  632. ##### Syndic settings #####
  633. ##########################################
  634. # The Salt syndic is used to pass commands through a master from a higher
  635. # master. Using the syndic is simple, if this is a master that will have
  636. # syndic servers(s) below it set the "order_masters" setting to True, if this
  637. # is a master that will be running a syndic daemon for passthrough the
  638. # "syndic_master" setting needs to be set to the location of the master server
  639. # to receive commands from.
  640. # Set the order_masters setting to True if this master will command lower
  641. # masters' syndic interfaces.
  642. {{ get_config('order_masters', 'False') }}
  643. # If this master will be running a salt syndic daemon, syndic_master tells
  644. # this master where to receive commands from.
  645. {{ get_config('syndic_master', 'masterofmaster') }}
  646. # This is the 'ret_port' of the MasterOfMaster:
  647. {{ get_config('syndic_master_port', '4506') }}
  648. # PID file of the syndic daemon:
  649. {{ get_config('syndic_pidfile', '/var/run/salt-syndic.pid') }}
  650. # LOG file of the syndic daemon:
  651. {{ get_config('syndic_log_file', 'syndic.log') }}
  652. ##### Peer Publish settings #####
  653. ##########################################
  654. # Salt minions can send commands to other minions, but only if the minion is
  655. # allowed to. By default "Peer Publication" is disabled, and when enabled it
  656. # is enabled for specific minions and specific commands. This allows secure
  657. # compartmentalization of commands based on individual minions.
  658. # The configuration uses regular expressions to match minions and then a list
  659. # of regular expressions to match functions. The following will allow the
  660. # minion authenticated as foo.example.com to execute functions from the test
  661. # and pkg modules.
  662. #peer:
  663. # foo.example.com:
  664. # - test.*
  665. # - pkg.*
  666. #
  667. # This will allow all minions to execute all commands:
  668. #peer:
  669. # .*:
  670. # - .*
  671. #
  672. # This is not recommended, since it would allow anyone who gets root on any
  673. # single minion to instantly have root on all of the minions!
  674. {% if 'peer' in cfg_master %}
  675. peer:
  676. {% for name, roots in cfg_master['peer'].items() %}
  677. {{ name }}:
  678. {% for mod in roots %}
  679. - {{ mod }}
  680. {% endfor %}
  681. {% endfor %}
  682. {% elif 'peer' in cfg_salt %}
  683. peer:
  684. {% for name, roots in cfg_salt['peer'].items() %}
  685. {{ name }}:
  686. {% for mod in roots %}
  687. - {{ mod }}
  688. {% endfor %}
  689. {% endfor %}
  690. {% endif %}
  691. # Minions can also be allowed to execute runners from the salt master.
  692. # Since executing a runner from the minion could be considered a security risk,
  693. # it needs to be enabled. This setting functions just like the peer setting
  694. # except that it opens up runners instead of module functions.
  695. #
  696. # All peer runner support is turned off by default and must be enabled before
  697. # using. This will enable all peer runners for all minions:
  698. #peer_run:
  699. # .*:
  700. # - .*
  701. #
  702. # To enable just the manage.up runner for the minion foo.example.com:
  703. #peer_run:
  704. # foo.example.com:
  705. # - manage.up
  706. {% if 'peer_run' in cfg_master %}
  707. peer_run:
  708. {% for name, roots in cfg_master['peer_run'].items() %}
  709. {{ name }}:
  710. {% for mod in roots %}
  711. - {{ mod }}
  712. {% endfor %}
  713. {% endfor %}
  714. {% elif 'peer_run' in cfg_salt %}
  715. peer_run:
  716. {% for name, roots in cfg_salt['peer_run'].items() %}
  717. {{ name }}:
  718. {% for mod in roots %}
  719. - {{ mod }}
  720. {% endfor %}
  721. {% endfor %}
  722. {% endif %}
  723. ##### Mine settings #####
  724. ##########################################
  725. # Restrict mine.get access from minions. By default any minion has a full access
  726. # to get all mine data from master cache. In acl definion below, only pcre matches
  727. # are allowed.
  728. # mine_get:
  729. # .*:
  730. # - .*
  731. #
  732. # The example below enables minion foo.example.com to get 'network.interfaces' mine
  733. # data only, minions web* to get all network.* and disk.* mine data and all other
  734. # minions won't get any mine data.
  735. {% if 'mine_get' in cfg_master -%}
  736. mine_get:
  737. {%- for minion, data in cfg_master['mine_get']|dictsort %}
  738. {{ minion }}:
  739. {%- for command in data %}
  740. - {% raw %}'{% endraw %}{{ command }}{% raw %}'{% endraw %}
  741. {%- endfor -%}
  742. {%- endfor -%}
  743. {% elif 'mine_get' in cfg_salt -%}
  744. mine_get:
  745. {%- for minion, data in cfg_salt['mine_get']|dictsort %}
  746. {{ minion }}:
  747. {%- for command in data %}
  748. - {% raw %}'{% endraw %}{{ command }}{% raw %}'{% endraw %}
  749. {%- endfor -%}
  750. {%- endfor -%}
  751. {% else -%}
  752. # mine_get:
  753. # foo.example.com:
  754. # - network.interfaces
  755. # web.*:
  756. # - network.*
  757. # - disk.*
  758. {%- endif %}
  759. ##### Logging settings #####
  760. ##########################################
  761. # The location of the master log file
  762. # The master log can be sent to a regular file, local path name, or network
  763. # location. Remote logging works best when configured to use rsyslogd(8) (e.g.:
  764. # ``file:///dev/log``), with rsyslogd(8) configured for network logging. The URI
  765. # format is: <file|udp|tcp>://<host|socketpath>:<port-if-required>/<log-facility>
  766. #log_file: /var/log/salt/master
  767. #log_file: file:///dev/log
  768. #log_file: udp://loghost:10514
  769. {{ get_config('log_file', '/var/log/salt/master') }}
  770. {{ get_config('key_logfile', '/var/log/salt/key') }}
  771. # The level of messages to send to the console.
  772. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  773. {{ get_config('log_level', 'warning') }}
  774. # The level of messages to send to the log file.
  775. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  776. {{ get_config('log_level_logfile', 'warning') }}
  777. # The date and time format used in log messages. Allowed date/time formating
  778. # can be seen here: http://docs.python.org/library/time.html#time.strftime
  779. {{ get_config('log_datefmt', "'%H:%M:%S'") }}
  780. {{ get_config('log_datefmt_logfile', "'%Y-%m-%d %H:%M:%S'") }}
  781. # The format of the console logging messages. Allowed formatting options can
  782. # be seen here: http://docs.python.org/library/logging.html#logrecord-attributes
  783. {{ get_config('log_fmt_console', "'[%(levelname)-8s] %(message)s'") }}
  784. {{ get_config('log_fmt_logfile', "'%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'") }}
  785. # This can be used to control logging levels more specificically. This
  786. # example sets the main salt library at the 'warning' level, but sets
  787. # 'salt.modules' to log at the 'debug' level:
  788. # log_granular_levels:
  789. # 'salt': 'warning'
  790. # 'salt.modules': 'debug'
  791. #
  792. {% if 'log_granular_levels' in cfg_master %}
  793. log_granular_levels:
  794. {% for name, lvl in cfg_master['log_granular_levels'].items() %}
  795. {{ name }}: {{ lvl }}
  796. {% endfor %}
  797. {% elif 'log_granular_levels' in cfg_salt %}
  798. log_granular_levels:
  799. {% for name, lvl in cfg_salt['log_granular_levels'].items() %}
  800. {{ name }}: {{ lvl }}
  801. {% endfor %}
  802. {% else %}
  803. #log_granular_levels: {}
  804. {% endif %}
  805. ##### Node Groups #####
  806. ##########################################
  807. # Node groups allow for logical groupings of minion nodes. A group consists of a group
  808. # name and a compound target.
  809. #nodegroups:
  810. # group1: 'L@foo.domain.com,bar.domain.com,baz.domain.com and bl*.domain.com'
  811. # group2: 'G@os:Debian and foo.domain.com'
  812. {% if 'nodegroups' in cfg_master %}
  813. nodegroups:
  814. {% for name, lvl in cfg_master['nodegroups'].items() %}
  815. {{ name }}: {{ lvl }}
  816. {% endfor %}
  817. {% elif 'nodegroups' in cfg_salt %}
  818. nodegroups:
  819. {% for name, lvl in cfg_salt['nodegroups'].items() %}
  820. {{ name }}: {{ lvl }}
  821. {% endfor %}
  822. {% endif %}
  823. ##### Range Cluster settings #####
  824. ##########################################
  825. # The range server (and optional port) that serves your cluster information
  826. # https://github.com/ytoolshed/range/wiki/%22yamlfile%22-module-file-spec
  827. #
  828. {{ get_config('range_server', 'range:80') }}
  829. ##### Windows Software Repo settings #####
  830. ##############################################
  831. # Location of the repo on the master:
  832. {{ get_config('win_repo', '/srv/salt/win/repo') }}
  833. # Location of the master's repo cache file:
  834. {{ get_config('win_repo_mastercachefile', '/srv/salt/win/repo/winrepo.p') }}
  835. # List of git repositories to include with the local repo:
  836. {% if 'win_gitrepos' in cfg_master %}
  837. win_gitrepos:
  838. {% for repo in cfg_master['win_gitrepos'] %}
  839. - {{ repo }}
  840. {% endfor %}
  841. {% elif 'win_gitrepos' in cfg_salt %}
  842. win_gitrepos:
  843. {% for repo in cfg_salt['win_gitrepos'] %}
  844. - {{ repo }}
  845. {% endfor %}
  846. {% else %}
  847. #win_gitrepos:
  848. # - 'https://github.com/saltstack/salt-winrepo.git'
  849. {% endif %}
  850. ##### Returner settings ######
  851. ############################################
  852. # Which returner(s) will be used for minion's result:
  853. #return: mysql
  854. {% if 'halite' in cfg_master %}
  855. ##### Halite #####
  856. ##########################################
  857. halite:
  858. {% for name, value in cfg_master['halite'].items() %}
  859. {{ name }}: {{ value }}
  860. {% endfor %}
  861. {% endif %}
  862. {% if 'rest_cherrypy' in cfg_master %}
  863. ##### rest_cherrypy #####
  864. ##########################################
  865. rest_cherrypy:
  866. {% for name, value in cfg_master['rest_cherrypy'].items() %}
  867. {{ name }}: {{ value }}
  868. {%- endfor %}
  869. {%- endif %}
  870. {% if 'rest_tornado' in cfg_master %}
  871. ##### rest_tornado #####
  872. ###########################################
  873. rest_tornado:
  874. {% for name, value in cfg_master['rest_tornado'].items() %}
  875. {{ name }}: {{ value }}
  876. {%- endfor %}
  877. {%- endif %}
  878. {% if 'presence_events' in cfg_master %}
  879. ##### presence events #####
  880. ##########################################
  881. {{ get_config('presence_events', 'False') }}
  882. {% endif %}