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.

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