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.

master 50KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314
  1. ##### Primary configuration settings #####
  2. ##########################################
  3. # This configuration file is used to manage the behavior of the Salt Master.
  4. # Values that are commented out but have an empty line after the comment are
  5. # defaults that do not need to be set in the config. If there is no blank line
  6. # after the comment then the value is presented as an example and is not the
  7. # default.
  8. # Per default, the master will automatically include all config files
  9. # from master.d/*.conf (master.d is a directory in the same directory
  10. # as the main master config file).
  11. #default_include: master.d/*.conf
  12. # The address of the interface to bind to:
  13. interface: 0.0.0.0
  14. # Whether the master should listen for IPv6 connections. If this is set to True,
  15. # the interface option must be adjusted, too. (For example: "interface: '::'")
  16. #ipv6: False
  17. # The tcp port used by the publisher:
  18. #publish_port: 4505
  19. # The user under which the salt master will run. Salt will update all
  20. # permissions to allow the specified user to run the master. The exception is
  21. # the job cache, which must be deleted if this user is changed. If the
  22. # modified files cause conflicts, set verify_env to False.
  23. #user: root
  24. # The port used by the communication interface. The ret (return) port is the
  25. # interface used for the file server, authentication, job returns, etc.
  26. #ret_port: 4506
  27. # Specify the location of the daemon process ID file:
  28. #pidfile: /var/run/salt-master.pid
  29. # The root directory prepended to these options: pki_dir, cachedir,
  30. # sock_dir, log_file, autosign_file, autoreject_file, extension_modules,
  31. # key_logfile, pidfile, autosign_grains_dir:
  32. #root_dir: /
  33. # The path to the master's configuration file.
  34. #conf_file: /etc/salt/master
  35. # Directory used to store public key data:
  36. #pki_dir: /etc/salt/pki/master
  37. # Key cache. Increases master speed for large numbers of accepted
  38. # keys. Available options: 'sched'. (Updates on a fixed schedule.)
  39. # Note that enabling this feature means that minions will not be
  40. # available to target for up to the length of the maintanence loop
  41. # which by default is 60s.
  42. #key_cache: ''
  43. # Directory to store job and cache data:
  44. # This directory may contain sensitive data and should be protected accordingly.
  45. #
  46. #cachedir: /var/cache/salt/master
  47. # Directory for custom modules. This directory can contain subdirectories for
  48. # each of Salt's module types such as "runners", "output", "wheel", "modules",
  49. # "states", "returners", "engines", "utils", etc.
  50. #extension_modules: /var/cache/salt/master/extmods
  51. # Directory for custom modules. This directory can contain subdirectories for
  52. # each of Salt's module types such as "runners", "output", "wheel", "modules",
  53. # "states", "returners", "engines", "utils", etc.
  54. # Like 'extension_modules' but can take an array of paths
  55. #module_dirs: []
  56. # Verify and set permissions on configuration directories at startup:
  57. #verify_env: True
  58. # Set the number of hours to keep old job information in the job cache:
  59. #keep_jobs: 24
  60. # The number of seconds to wait when the client is requesting information
  61. # about running jobs.
  62. #gather_job_timeout: 10
  63. # Set the default timeout for the salt command and api. The default is 5
  64. # seconds.
  65. #timeout: 5
  66. # The loop_interval option controls the seconds for the master's maintenance
  67. # process check cycle. This process updates file server backends, cleans the
  68. # job cache and executes the scheduler.
  69. #loop_interval: 60
  70. # Set the default outputter used by the salt command. The default is "nested".
  71. #output: nested
  72. # To set a list of additional directories to search for salt outputters, set the
  73. # outputter_dirs option.
  74. #outputter_dirs: []
  75. # Set the default output file used by the salt command. Default is to output
  76. # to the CLI and not to a file. Functions the same way as the "--out-file"
  77. # CLI option, only sets this to a single file for all salt commands.
  78. #output_file: None
  79. # Return minions that timeout when running commands like test.ping
  80. #show_timeout: True
  81. # Tell the client to display the jid when a job is published.
  82. #show_jid: False
  83. # By default, output is colored. To disable colored output, set the color value
  84. # to False.
  85. #color: True
  86. # Do not strip off the colored output from nested results and state outputs
  87. # (true by default).
  88. # strip_colors: False
  89. # To display a summary of the number of minions targeted, the number of
  90. # minions returned, and the number of minions that did not return, set the
  91. # cli_summary value to True. (False by default.)
  92. #
  93. #cli_summary: False
  94. # Set the directory used to hold unix sockets:
  95. #sock_dir: /var/run/salt/master
  96. # The master can take a while to start up when lspci and/or dmidecode is used
  97. # to populate the grains for the master. Enable if you want to see GPU hardware
  98. # data for your master.
  99. # enable_gpu_grains: False
  100. # The master maintains a job cache. While this is a great addition, it can be
  101. # a burden on the master for larger deployments (over 5000 minions).
  102. # Disabling the job cache will make previously executed jobs unavailable to
  103. # the jobs system and is not generally recommended.
  104. #job_cache: True
  105. # Cache minion grains, pillar and mine data via the cache subsystem in the
  106. # cachedir or a database.
  107. #minion_data_cache: True
  108. # Cache subsystem module to use for minion data cache.
  109. #cache: localfs
  110. # Enables a fast in-memory cache booster and sets the expiration time.
  111. #memcache_expire_seconds: 0
  112. # Set a memcache limit in items (bank + key) per cache storage (driver + driver_opts).
  113. #memcache_max_items: 1024
  114. # Each time a cache storage got full cleanup all the expired items not just the oldest one.
  115. #memcache_full_cleanup: False
  116. # Enable collecting the memcache stats and log it on `debug` log level.
  117. #memcache_debug: False
  118. # Store all returns in the given returner.
  119. # Setting this option requires that any returner-specific configuration also
  120. # be set. See various returners in salt/returners for details on required
  121. # configuration values. (See also, event_return_queue below.)
  122. #
  123. #event_return: mysql
  124. # On busy systems, enabling event_returns can cause a considerable load on
  125. # the storage system for returners. Events can be queued on the master and
  126. # stored in a batched fashion using a single transaction for multiple events.
  127. # By default, events are not queued.
  128. #event_return_queue: 0
  129. # Only return events matching tags in a whitelist, supports glob matches.
  130. #event_return_whitelist:
  131. # - salt/master/a_tag
  132. # - salt/run/*/ret
  133. # Store all event returns **except** the tags in a blacklist, supports globs.
  134. #event_return_blacklist:
  135. # - salt/master/not_this_tag
  136. # - salt/wheel/*/ret
  137. # Passing very large events can cause the minion to consume large amounts of
  138. # memory. This value tunes the maximum size of a message allowed onto the
  139. # master event bus. The value is expressed in bytes.
  140. #max_event_size: 1048576
  141. # By default, the master AES key rotates every 24 hours. The next command
  142. # following a key rotation will trigger a key refresh from the minion which may
  143. # result in minions which do not respond to the first command after a key refresh.
  144. #
  145. # To tell the master to ping all minions immediately after an AES key refresh, set
  146. # ping_on_rotate to True. This should mitigate the issue where a minion does not
  147. # appear to initially respond after a key is rotated.
  148. #
  149. # Note that ping_on_rotate may cause high load on the master immediately after
  150. # the key rotation event as minions reconnect. Consider this carefully if this
  151. # salt master is managing a large number of minions.
  152. #
  153. # If disabled, it is recommended to handle this event by listening for the
  154. # 'aes_key_rotate' event with the 'key' tag and acting appropriately.
  155. # ping_on_rotate: False
  156. # By default, the master deletes its cache of minion data when the key for that
  157. # minion is removed. To preserve the cache after key deletion, set
  158. # 'preserve_minion_cache' to True.
  159. #
  160. # WARNING: This may have security implications if compromised minions auth with
  161. # a previous deleted minion ID.
  162. #preserve_minion_cache: False
  163. # Allow or deny minions from requesting their own key revocation
  164. #allow_minion_key_revoke: True
  165. # If max_minions is used in large installations, the master might experience
  166. # high-load situations because of having to check the number of connected
  167. # minions for every authentication. This cache provides the minion-ids of
  168. # all connected minions to all MWorker-processes and greatly improves the
  169. # performance of max_minions.
  170. # con_cache: False
  171. # The master can include configuration from other files. To enable this,
  172. # pass a list of paths to this option. The paths can be either relative or
  173. # absolute; if relative, they are considered to be relative to the directory
  174. # the main master configuration file lives in (this file). Paths can make use
  175. # of shell-style globbing. If no files are matched by a path passed to this
  176. # option, then the master will log a warning message.
  177. #
  178. # Include a config file from some other path:
  179. # include: /etc/salt/extra_config
  180. #
  181. # Include config from several files and directories:
  182. # include:
  183. # - /etc/salt/extra_config
  184. ##### Large-scale tuning settings #####
  185. ##########################################
  186. # Max open files
  187. #
  188. # Each minion connecting to the master uses AT LEAST one file descriptor, the
  189. # master subscription connection. If enough minions connect you might start
  190. # seeing on the console (and then salt-master crashes):
  191. # Too many open files (tcp_listener.cpp:335)
  192. # Aborted (core dumped)
  193. #
  194. # By default this value will be the one of `ulimit -Hn`, ie, the hard limit for
  195. # max open files.
  196. #
  197. # If you wish to set a different value than the default one, uncomment and
  198. # configure this setting. Remember that this value CANNOT be higher than the
  199. # hard limit. Raising the hard limit depends on your OS and/or distribution,
  200. # a good way to find the limit is to search the internet. For example:
  201. # raise max open files hard limit debian
  202. #
  203. #max_open_files: 100000
  204. # The number of worker threads to start. These threads are used to manage
  205. # return calls made from minions to the master. If the master seems to be
  206. # running slowly, increase the number of threads. This setting can not be
  207. # set lower than 3.
  208. #worker_threads: 5
  209. # Set the ZeroMQ high water marks
  210. # http://api.zeromq.org/3-2:zmq-setsockopt
  211. # The listen queue size / backlog
  212. #zmq_backlog: 1000
  213. # The publisher interface ZeroMQPubServerChannel
  214. #pub_hwm: 1000
  215. # These two ZMQ HWM settings, salt_event_pub_hwm and event_publisher_pub_hwm
  216. # are significant for masters with thousands of minions. When these are
  217. # insufficiently high it will manifest in random responses missing in the CLI
  218. # and even missing from the job cache. Masters that have fast CPUs and many
  219. # cores with appropriate worker_threads will not need these set as high.
  220. # On deployment with 8,000 minions, 2.4GHz CPUs, 24 cores, 32GiB memory has
  221. # these settings:
  222. #
  223. # salt_event_pub_hwm: 128000
  224. # event_publisher_pub_hwm: 64000
  225. # ZMQ high-water-mark for SaltEvent pub socket
  226. #salt_event_pub_hwm: 20000
  227. # ZMQ high-water-mark for EventPublisher pub socket
  228. #event_publisher_pub_hwm: 10000
  229. # The master may allocate memory per-event and not
  230. # reclaim it.
  231. # To set a high-water mark for memory allocation, use
  232. # ipc_write_buffer to set a high-water mark for message
  233. # buffering.
  234. # Value: In bytes. Set to 'dynamic' to have Salt select
  235. # a value for you. Default is disabled.
  236. # ipc_write_buffer: 'dynamic'
  237. # These two batch settings, batch_safe_limit and batch_safe_size, are used to
  238. # automatically switch to a batch mode execution. If a command would have been
  239. # sent to more than <batch_safe_limit> minions, then run the command in
  240. # batches of <batch_safe_size>. If no batch_safe_size is specified, a default
  241. # of 8 will be used. If no batch_safe_limit is specified, then no automatic
  242. # batching will occur.
  243. #batch_safe_limit: 100
  244. #batch_safe_size: 8
  245. # Master stats enables stats events to be fired from the master at close
  246. # to the defined interval
  247. #master_stats: False
  248. #master_stats_event_iter: 60
  249. ##### Security settings #####
  250. ##########################################
  251. # Enable passphrase protection of Master private key. Although a string value
  252. # is acceptable; passwords should be stored in an external vaulting mechanism
  253. # and retrieved via sdb. See https://docs.saltstack.com/en/latest/topics/sdb/.
  254. # Passphrase protection is off by default but an example of an sdb profile and
  255. # query is as follows.
  256. # masterkeyring:
  257. # driver: keyring
  258. # service: system
  259. #
  260. # key_pass: sdb://masterkeyring/key_pass
  261. # Enable passphrase protection of the Master signing_key. This only applies if
  262. # master_sign_pubkey is set to True. This is disabled by default.
  263. # master_sign_pubkey: True
  264. # signing_key_pass: sdb://masterkeyring/signing_pass
  265. # Enable "open mode", this mode still maintains encryption, but turns off
  266. # authentication, this is only intended for highly secure environments or for
  267. # the situation where your keys end up in a bad state. If you run in open mode
  268. # you do so at your own risk!
  269. #open_mode: False
  270. # Enable auto_accept, this setting will automatically accept all incoming
  271. # public keys from the minions. Note that this is insecure.
  272. #auto_accept: False
  273. # The size of key that should be generated when creating new keys.
  274. #keysize: 2048
  275. # Time in minutes that an incoming public key with a matching name found in
  276. # pki_dir/minion_autosign/keyid is automatically accepted. Expired autosign keys
  277. # are removed when the master checks the minion_autosign directory.
  278. # 0 equals no timeout
  279. # autosign_timeout: 120
  280. # If the autosign_file is specified, incoming keys specified in the
  281. # autosign_file will be automatically accepted. This is insecure. Regular
  282. # expressions as well as globing lines are supported. The file must be readonly
  283. # except for the owner. Use permissive_pki_access to allow the group write access.
  284. #autosign_file: /etc/salt/autosign.conf
  285. # Works like autosign_file, but instead allows you to specify minion IDs for
  286. # which keys will automatically be rejected. Will override both membership in
  287. # the autosign_file and the auto_accept setting.
  288. #autoreject_file: /etc/salt/autoreject.conf
  289. # If the autosign_grains_dir is specified, incoming keys from minons with grain
  290. # values matching those defined in files in this directory will be accepted
  291. # automatically. This is insecure. Minions need to be configured to send the grains.
  292. #autosign_grains_dir: /etc/salt/autosign_grains
  293. # Enable permissive access to the salt keys. This allows you to run the
  294. # master or minion as root, but have a non-root group be given access to
  295. # your pki_dir. To make the access explicit, root must belong to the group
  296. # you've given access to. This is potentially quite insecure. If an autosign_file
  297. # is specified, enabling permissive_pki_access will allow group access to that
  298. # specific file.
  299. #permissive_pki_access: False
  300. # Allow users on the master access to execute specific commands on minions.
  301. # This setting should be treated with care since it opens up execution
  302. # capabilities to non root users. By default this capability is completely
  303. # disabled.
  304. #publisher_acl:
  305. # larry:
  306. # - test.ping
  307. # - network.*
  308. #
  309. # Blacklist any of the following users or modules
  310. #
  311. # This example would blacklist all non sudo users, including root from
  312. # running any commands. It would also blacklist any use of the "cmd"
  313. # module. This is completely disabled by default.
  314. #
  315. #
  316. # Check the list of configured users in client ACL against users on the
  317. # system and throw errors if they do not exist.
  318. #client_acl_verify: True
  319. #
  320. #publisher_acl_blacklist:
  321. # users:
  322. # - root
  323. # - '^(?!sudo_).*$' # all non sudo users
  324. # modules:
  325. # - cmd
  326. # Enforce publisher_acl & publisher_acl_blacklist when users have sudo
  327. # access to the salt command.
  328. #
  329. #sudo_acl: False
  330. # The external auth system uses the Salt auth modules to authenticate and
  331. # validate users to access areas of the Salt system.
  332. #external_auth:
  333. # pam:
  334. # fred:
  335. # - test.*
  336. #
  337. # Time (in seconds) for a newly generated token to live. Default: 12 hours
  338. #token_expire: 43200
  339. #
  340. # Allow eauth users to specify the expiry time of the tokens they generate.
  341. # A boolean applies to all users or a dictionary of whitelisted eauth backends
  342. # and usernames may be given.
  343. # token_expire_user_override:
  344. # pam:
  345. # - fred
  346. # - tom
  347. # ldap:
  348. # - gary
  349. #
  350. #token_expire_user_override: False
  351. # Set to True to enable keeping the calculated user's auth list in the token
  352. # file. This is disabled by default and the auth list is calculated or requested
  353. # from the eauth driver each time.
  354. #keep_acl_in_token: False
  355. # Auth subsystem module to use to get authorized access list for a user. By default it's
  356. # the same module used for external authentication.
  357. #eauth_acl_module: django
  358. # Allow minions to push files to the master. This is disabled by default, for
  359. # security purposes.
  360. #file_recv: False
  361. # Set a hard-limit on the size of the files that can be pushed to the master.
  362. # It will be interpreted as megabytes. Default: 100
  363. #file_recv_max_size: 100
  364. # Signature verification on messages published from the master.
  365. # This causes the master to cryptographically sign all messages published to its event
  366. # bus, and minions then verify that signature before acting on the message.
  367. #
  368. # This is False by default.
  369. #
  370. # Note that to facilitate interoperability with masters and minions that are different
  371. # versions, if sign_pub_messages is True but a message is received by a minion with
  372. # no signature, it will still be accepted, and a warning message will be logged.
  373. # Conversely, if sign_pub_messages is False, but a minion receives a signed
  374. # message it will be accepted, the signature will not be checked, and a warning message
  375. # will be logged. This behavior went away in Salt 2014.1.0 and these two situations
  376. # will cause minion to throw an exception and drop the message.
  377. # sign_pub_messages: False
  378. # Signature verification on messages published from minions
  379. # This requires that minions cryptographically sign the messages they
  380. # publish to the master. If minions are not signing, then log this information
  381. # at loglevel 'INFO' and drop the message without acting on it.
  382. # require_minion_sign_messages: False
  383. # The below will drop messages when their signatures do not validate.
  384. # Note that when this option is False but `require_minion_sign_messages` is True
  385. # minions MUST sign their messages but the validity of their signatures
  386. # is ignored.
  387. # These two config options exist so a Salt infrastructure can be moved
  388. # to signing minion messages gradually.
  389. # drop_messages_signature_fail: False
  390. # Use TLS/SSL encrypted connection between master and minion.
  391. # Can be set to a dictionary containing keyword arguments corresponding to Python's
  392. # 'ssl.wrap_socket' method.
  393. # Default is None.
  394. #ssl:
  395. # keyfile: <path_to_keyfile>
  396. # certfile: <path_to_certfile>
  397. # ssl_version: PROTOCOL_TLSv1_2
  398. ##### Salt-SSH Configuration #####
  399. ##########################################
  400. # Define the default salt-ssh roster module to use
  401. #roster: flat
  402. # Pass in an alternative location for the salt-ssh `flat` roster file
  403. #roster_file: /etc/salt/roster
  404. # Define locations for `flat` roster files so they can be chosen when using Salt API.
  405. # An administrator can place roster files into these locations. Then when
  406. # calling Salt API, parameter 'roster_file' should contain a relative path to
  407. # these locations. That is, "roster_file=/foo/roster" will be resolved as
  408. # "/etc/salt/roster.d/foo/roster" etc. This feature prevents passing insecure
  409. # custom rosters through the Salt API.
  410. #
  411. #rosters:
  412. # - /etc/salt/roster.d
  413. # - /opt/salt/some/more/rosters
  414. # The ssh password to log in with.
  415. #ssh_passwd: ''
  416. #The target system's ssh port number.
  417. #ssh_port: 22
  418. # Comma-separated list of ports to scan.
  419. #ssh_scan_ports: 22
  420. # Scanning socket timeout for salt-ssh.
  421. #ssh_scan_timeout: 0.01
  422. # Boolean to run command via sudo.
  423. #ssh_sudo: False
  424. # Number of seconds to wait for a response when establishing an SSH connection.
  425. #ssh_timeout: 60
  426. # The user to log in as.
  427. #ssh_user: root
  428. # The log file of the salt-ssh command:
  429. #ssh_log_file: /var/log/salt/ssh
  430. # Pass in minion option overrides that will be inserted into the SHIM for
  431. # salt-ssh calls. The local minion config is not used for salt-ssh. Can be
  432. # overridden on a per-minion basis in the roster (`minion_opts`)
  433. #ssh_minion_opts:
  434. # gpg_keydir: /root/gpg
  435. # Set this to True to default to using ~/.ssh/id_rsa for salt-ssh
  436. # authentication with minions
  437. #ssh_use_home_key: False
  438. # Set this to True to default salt-ssh to run with ``-o IdentitiesOnly=yes``.
  439. # This option is intended for situations where the ssh-agent offers many
  440. # different identities and allows ssh to ignore those identities and use the
  441. # only one specified in options.
  442. #ssh_identities_only: False
  443. # List-only nodegroups for salt-ssh. Each group must be formed as either a
  444. # comma-separated list, or a YAML list. This option is useful to group minions
  445. # into easy-to-target groups when using salt-ssh. These groups can then be
  446. # targeted with the normal -N argument to salt-ssh.
  447. #ssh_list_nodegroups: {}
  448. # salt-ssh has the ability to update the flat roster file if a minion is not
  449. # found in the roster. Set this to True to enable it.
  450. #ssh_update_roster: False
  451. ##### Master Module Management #####
  452. ##########################################
  453. # Manage how master side modules are loaded.
  454. # Add any additional locations to look for master runners:
  455. #runner_dirs: []
  456. # Add any additional locations to look for master utils:
  457. #utils_dirs: []
  458. # Enable Cython for master side modules:
  459. #cython_enable: False
  460. ##### State System settings #####
  461. ##########################################
  462. # The state system uses a "top" file to tell the minions what environment to
  463. # use and what modules to use. The state_top file is defined relative to the
  464. # root of the base environment as defined in "File Server settings" below.
  465. #state_top: top.sls
  466. # The master_tops option replaces the external_nodes option by creating
  467. # a plugable system for the generation of external top data. The external_nodes
  468. # option is deprecated by the master_tops option.
  469. #
  470. # To gain the capabilities of the classic external_nodes system, use the
  471. # following configuration:
  472. # master_tops:
  473. # ext_nodes: <Shell command which returns yaml>
  474. #
  475. #master_tops: {}
  476. # The external_nodes option allows Salt to gather data that would normally be
  477. # placed in a top file. The external_nodes option is the executable that will
  478. # return the ENC data. Remember that Salt will look for external nodes AND top
  479. # files and combine the results if both are enabled!
  480. #external_nodes: None
  481. # The renderer to use on the minions to render the state data
  482. #renderer: yaml_jinja
  483. # Default Jinja environment options for all templates except sls templates
  484. #jinja_env:
  485. # block_start_string: '{%'
  486. # block_end_string: '%}'
  487. # variable_start_string: '{{'
  488. # variable_end_string: '}}'
  489. # comment_start_string: '{#'
  490. # comment_end_string: '#}'
  491. # line_statement_prefix:
  492. # line_comment_prefix:
  493. # trim_blocks: False
  494. # lstrip_blocks: False
  495. # newline_sequence: '\n'
  496. # keep_trailing_newline: False
  497. # Jinja environment options for sls templates
  498. #jinja_sls_env:
  499. # block_start_string: '{%'
  500. # block_end_string: '%}'
  501. # variable_start_string: '{{'
  502. # variable_end_string: '}}'
  503. # comment_start_string: '{#'
  504. # comment_end_string: '#}'
  505. # line_statement_prefix:
  506. # line_comment_prefix:
  507. # trim_blocks: False
  508. # lstrip_blocks: False
  509. # newline_sequence: '\n'
  510. # keep_trailing_newline: False
  511. # The failhard option tells the minions to stop immediately after the first
  512. # failure detected in the state execution, defaults to False
  513. #failhard: False
  514. # The state_verbose and state_output settings can be used to change the way
  515. # state system data is printed to the display. By default all data is printed.
  516. # The state_verbose setting can be set to True or False, when set to False
  517. # all data that has a result of True and no changes will be suppressed.
  518. #state_verbose: True
  519. # The state_output setting controls which results will be output full multi line
  520. # full, terse - each state will be full/terse
  521. # mixed - only states with errors will be full
  522. # changes - states with changes and errors will be full
  523. # full_id, mixed_id, changes_id and terse_id are also allowed;
  524. # when set, the state ID will be used as name in the output
  525. state_output: changes
  526. # The state_output_diff setting changes whether or not the output from
  527. # successful states is returned. Useful when even the terse output of these
  528. # states is cluttering the logs. Set it to True to ignore them.
  529. #state_output_diff: False
  530. # Automatically aggregate all states that have support for mod_aggregate by
  531. # setting to 'True'. Or pass a list of state module names to automatically
  532. # aggregate just those types.
  533. #
  534. # state_aggregate:
  535. # - pkg
  536. #
  537. #state_aggregate: False
  538. # Send progress events as each function in a state run completes execution
  539. # by setting to 'True'. Progress events are in the format
  540. # 'salt/job/<JID>/prog/<MID>/<RUN NUM>'.
  541. #state_events: False
  542. ##### File Server settings #####
  543. ##########################################
  544. # Salt runs a lightweight file server written in zeromq to deliver files to
  545. # minions. This file server is built into the master daemon and does not
  546. # require a dedicated port.
  547. # The file server works on environments passed to the master, each environment
  548. # can have multiple root directories, the subdirectories in the multiple file
  549. # roots cannot match, otherwise the downloaded files will not be able to be
  550. # reliably ensured. A base environment is required to house the top file.
  551. # Example:
  552. # file_roots:
  553. # base:
  554. # - /srv/salt/
  555. # dev:
  556. # - /srv/salt/dev/services
  557. # - /srv/salt/dev/states
  558. # prod:
  559. # - /srv/salt/prod/services
  560. # - /srv/salt/prod/states
  561. #
  562. #file_roots:
  563. # base:
  564. # - /srv/salt
  565. #
  566. file_roots:
  567. base:
  568. - /data/salt/states/
  569. # The master_roots setting configures a master-only copy of the file_roots dictionary,
  570. # used by the state compiler.
  571. #master_roots: /srv/salt-master
  572. # When using multiple environments, each with their own top file, the
  573. # default behaviour is an unordered merge. To prevent top files from
  574. # being merged together and instead to only use the top file from the
  575. # requested environment, set this value to 'same'.
  576. #top_file_merging_strategy: merge
  577. # To specify the order in which environments are merged, set the ordering
  578. # in the env_order option. Given a conflict, the last matching value will
  579. # win.
  580. #env_order: ['base', 'dev', 'prod']
  581. # If top_file_merging_strategy is set to 'same' and an environment does not
  582. # contain a top file, the top file in the environment specified by default_top
  583. # will be used instead.
  584. #default_top: base
  585. # The hash_type is the hash to use when discovering the hash of a file on
  586. # the master server. The default is sha256, but md5, sha1, sha224, sha384 and
  587. # sha512 are also supported.
  588. #
  589. # WARNING: While md5 and sha1 are also supported, do not use them due to the
  590. # high chance of possible collisions and thus security breach.
  591. #
  592. # Prior to changing this value, the master should be stopped and all Salt
  593. # caches should be cleared.
  594. #hash_type: sha256
  595. # The buffer size in the file server can be adjusted here:
  596. #file_buffer_size: 1048576
  597. # A regular expression (or a list of expressions) that will be matched
  598. # against the file path before syncing the modules and states to the minions.
  599. # This includes files affected by the file.recurse state.
  600. # For example, if you manage your custom modules and states in subversion
  601. # and don't want all the '.svn' folders and content synced to your minions,
  602. # you could set this to '/\.svn($|/)'. By default nothing is ignored.
  603. #file_ignore_regex:
  604. # - '/\.svn($|/)'
  605. # - '/\.git($|/)'
  606. # A file glob (or list of file globs) that will be matched against the file
  607. # path before syncing the modules and states to the minions. This is similar
  608. # to file_ignore_regex above, but works on globs instead of regex. By default
  609. # nothing is ignored.
  610. # file_ignore_glob:
  611. # - '*.pyc'
  612. # - '*/somefolder/*.bak'
  613. # - '*.swp'
  614. # File Server Backend
  615. #
  616. # Salt supports a modular fileserver backend system, this system allows
  617. # the salt master to link directly to third party systems to gather and
  618. # manage the files available to minions. Multiple backends can be
  619. # configured and will be searched for the requested file in the order in which
  620. # they are defined here. The default setting only enables the standard backend
  621. # "roots" which uses the "file_roots" option.
  622. #fileserver_backend:
  623. # - roots
  624. #
  625. # To use multiple backends list them in the order they are searched:
  626. #fileserver_backend:
  627. # - git
  628. # - roots
  629. #
  630. # Uncomment the line below if you do not want the file_server to follow
  631. # symlinks when walking the filesystem tree. This is set to True
  632. # by default. Currently this only applies to the default roots
  633. # fileserver_backend.
  634. #fileserver_followsymlinks: False
  635. #
  636. # Uncomment the line below if you do not want symlinks to be
  637. # treated as the files they are pointing to. By default this is set to
  638. # False. By uncommenting the line below, any detected symlink while listing
  639. # files on the Master will not be returned to the Minion.
  640. #fileserver_ignoresymlinks: True
  641. #
  642. # By default, the Salt fileserver recurses fully into all defined environments
  643. # to attempt to find files. To limit this behavior so that the fileserver only
  644. # traverses directories with SLS files and special Salt directories like _modules,
  645. # enable the option below. This might be useful for installations where a file root
  646. # has a very large number of files and performance is impacted. Default is False.
  647. # fileserver_limit_traversal: False
  648. #
  649. # The fileserver can fire events off every time the fileserver is updated,
  650. # these are disabled by default, but can be easily turned on by setting this
  651. # flag to True
  652. #fileserver_events: False
  653. # Git File Server Backend Configuration
  654. #
  655. # Optional parameter used to specify the provider to be used for gitfs. Must be
  656. # either pygit2 or gitpython. If unset, then both will be tried (in that
  657. # order), and the first one with a compatible version installed will be the
  658. # provider that is used.
  659. #
  660. #gitfs_provider: pygit2
  661. # Along with gitfs_password, is used to authenticate to HTTPS remotes.
  662. # gitfs_user: ''
  663. # Along with gitfs_user, is used to authenticate to HTTPS remotes.
  664. # This parameter is not required if the repository does not use authentication.
  665. #gitfs_password: ''
  666. # By default, Salt will not authenticate to an HTTP (non-HTTPS) remote.
  667. # This parameter enables authentication over HTTP. Enable this at your own risk.
  668. #gitfs_insecure_auth: False
  669. # Along with gitfs_privkey (and optionally gitfs_passphrase), is used to
  670. # authenticate to SSH remotes. This parameter (or its per-remote counterpart)
  671. # is required for SSH remotes.
  672. #gitfs_pubkey: ''
  673. # Along with gitfs_pubkey (and optionally gitfs_passphrase), is used to
  674. # authenticate to SSH remotes. This parameter (or its per-remote counterpart)
  675. # is required for SSH remotes.
  676. #gitfs_privkey: ''
  677. # This parameter is optional, required only when the SSH key being used to
  678. # authenticate is protected by a passphrase.
  679. #gitfs_passphrase: ''
  680. # When using the git fileserver backend at least one git remote needs to be
  681. # defined. The user running the salt master will need read access to the repo.
  682. #
  683. # The repos will be searched in order to find the file requested by a client
  684. # and the first repo to have the file will return it.
  685. # When using the git backend branches and tags are translated into salt
  686. # environments.
  687. # Note: file:// repos will be treated as a remote, so refs you want used must
  688. # exist in that repo as *local* refs.
  689. #gitfs_remotes:
  690. # - git://github.com/saltstack/salt-states.git
  691. # - file:///var/git/saltmaster
  692. #
  693. # The gitfs_ssl_verify option specifies whether to ignore ssl certificate
  694. # errors when contacting the gitfs backend. You might want to set this to
  695. # false if you're using a git backend that uses a self-signed certificate but
  696. # keep in mind that setting this flag to anything other than the default of True
  697. # is a security concern, you may want to try using the ssh transport.
  698. #gitfs_ssl_verify: True
  699. #
  700. # The gitfs_root option gives the ability to serve files from a subdirectory
  701. # within the repository. The path is defined relative to the root of the
  702. # repository and defaults to the repository root.
  703. #gitfs_root: somefolder/otherfolder
  704. #
  705. # The refspecs fetched by gitfs remotes
  706. #gitfs_refspecs:
  707. # - '+refs/heads/*:refs/remotes/origin/*'
  708. # - '+refs/tags/*:refs/tags/*'
  709. #
  710. #
  711. ##### Pillar settings #####
  712. ##########################################
  713. # Salt Pillars allow for the building of global data that can be made selectively
  714. # available to different minions based on minion grain filtering. The Salt
  715. # Pillar is laid out in the same fashion as the file server, with environments,
  716. # a top file and sls files. However, pillar data does not need to be in the
  717. # highstate format, and is generally just key/value pairs.
  718. #pillar_roots:
  719. # base:
  720. # - /srv/pillar
  721. #
  722. #ext_pillar:
  723. # - hiera: /etc/hiera.yaml
  724. # - cmd_yaml: cat /etc/salt/yaml
  725. pillar_roots:
  726. base:
  727. - /data/salt/pillar/
  728. # A list of paths to be recursively decrypted during pillar compilation.
  729. # Entries in this list can be formatted either as a simple string, or as a
  730. # key/value pair, with the key being the pillar location, and the value being
  731. # the renderer to use for pillar decryption. If the former is used, the
  732. # renderer specified by decrypt_pillar_default will be used.
  733. #decrypt_pillar:
  734. # - 'foo:bar': gpg
  735. # - 'lorem:ipsum:dolor'
  736. # The delimiter used to distinguish nested data structures in the
  737. # decrypt_pillar option.
  738. #decrypt_pillar_delimiter: ':'
  739. # The default renderer used for decryption, if one is not specified for a given
  740. # pillar key in decrypt_pillar.
  741. #decrypt_pillar_default: gpg
  742. # List of renderers which are permitted to be used for pillar decryption.
  743. #decrypt_pillar_renderers:
  744. # - gpg
  745. # The ext_pillar_first option allows for external pillar sources to populate
  746. # before file system pillar. This allows for targeting file system pillar from
  747. # ext_pillar.
  748. #ext_pillar_first: False
  749. # The external pillars permitted to be used on-demand using pillar.ext
  750. #on_demand_ext_pillar:
  751. # - libvirt
  752. # - virtkey
  753. # The pillar_gitfs_ssl_verify option specifies whether to ignore ssl certificate
  754. # errors when contacting the pillar gitfs backend. You might want to set this to
  755. # false if you're using a git backend that uses a self-signed certificate but
  756. # keep in mind that setting this flag to anything other than the default of True
  757. # is a security concern, you may want to try using the ssh transport.
  758. #pillar_gitfs_ssl_verify: True
  759. # The pillar_opts option adds the master configuration file data to a dict in
  760. # the pillar called "master". This is used to set simple configurations in the
  761. # master config file that can then be used on minions.
  762. #pillar_opts: False
  763. # The pillar_safe_render_error option prevents the master from passing pillar
  764. # render errors to the minion. This is set on by default because the error could
  765. # contain templating data which would give that minion information it shouldn't
  766. # have, like a password! When set true the error message will only show:
  767. # Rendering SLS 'my.sls' failed. Please see master log for details.
  768. #pillar_safe_render_error: True
  769. # The pillar_source_merging_strategy option allows you to configure merging strategy
  770. # between different sources. It accepts five values: none, recurse, aggregate, overwrite,
  771. # or smart. None will not do any merging at all. Recurse will merge recursively mapping of data.
  772. # Aggregate instructs aggregation of elements between sources that use the #!yamlex renderer. Overwrite
  773. # will overwrite elements according the order in which they are processed. This is
  774. # behavior of the 2014.1 branch and earlier. Smart guesses the best strategy based
  775. # on the "renderer" setting and is the default value.
  776. #pillar_source_merging_strategy: smart
  777. # Recursively merge lists by aggregating them instead of replacing them.
  778. #pillar_merge_lists: False
  779. # Set this option to True to force the pillarenv to be the same as the effective
  780. # saltenv when running states. If pillarenv is specified this option will be
  781. # ignored.
  782. #pillarenv_from_saltenv: False
  783. # Set this option to 'True' to force a 'KeyError' to be raised whenever an
  784. # attempt to retrieve a named value from pillar fails. When this option is set
  785. # to 'False', the failed attempt returns an empty string. Default is 'False'.
  786. #pillar_raise_on_missing: False
  787. # Git External Pillar (git_pillar) Configuration Options
  788. #
  789. # Specify the provider to be used for git_pillar. Must be either pygit2 or
  790. # gitpython. If unset, then both will be tried in that same order, and the
  791. # first one with a compatible version installed will be the provider that
  792. # is used.
  793. #git_pillar_provider: pygit2
  794. # If the desired branch matches this value, and the environment is omitted
  795. # from the git_pillar configuration, then the environment for that git_pillar
  796. # remote will be base.
  797. #git_pillar_base: master
  798. # If the branch is omitted from a git_pillar remote, then this branch will
  799. # be used instead
  800. #git_pillar_branch: master
  801. # Environment to use for git_pillar remotes. This is normally derived from
  802. # the branch/tag (or from a per-remote env parameter), but if set this will
  803. # override the process of deriving the env from the branch/tag name.
  804. #git_pillar_env: ''
  805. # Path relative to the root of the repository where the git_pillar top file
  806. # and SLS files are located.
  807. #git_pillar_root: ''
  808. # Specifies whether or not to ignore SSL certificate errors when contacting
  809. # the remote repository.
  810. #git_pillar_ssl_verify: False
  811. # When set to False, if there is an update/checkout lock for a git_pillar
  812. # remote and the pid written to it is not running on the master, the lock
  813. # file will be automatically cleared and a new lock will be obtained.
  814. #git_pillar_global_lock: True
  815. # Git External Pillar Authentication Options
  816. #
  817. # Along with git_pillar_password, is used to authenticate to HTTPS remotes.
  818. #git_pillar_user: ''
  819. # Along with git_pillar_user, is used to authenticate to HTTPS remotes.
  820. # This parameter is not required if the repository does not use authentication.
  821. #git_pillar_password: ''
  822. # By default, Salt will not authenticate to an HTTP (non-HTTPS) remote.
  823. # This parameter enables authentication over HTTP.
  824. #git_pillar_insecure_auth: False
  825. # Along with git_pillar_privkey (and optionally git_pillar_passphrase),
  826. # is used to authenticate to SSH remotes.
  827. #git_pillar_pubkey: ''
  828. # Along with git_pillar_pubkey (and optionally git_pillar_passphrase),
  829. # is used to authenticate to SSH remotes.
  830. #git_pillar_privkey: ''
  831. # This parameter is optional, required only when the SSH key being used
  832. # to authenticate is protected by a passphrase.
  833. #git_pillar_passphrase: ''
  834. # The refspecs fetched by git_pillar remotes
  835. #git_pillar_refspecs:
  836. # - '+refs/heads/*:refs/remotes/origin/*'
  837. # - '+refs/tags/*:refs/tags/*'
  838. # A master can cache pillars locally to bypass the expense of having to render them
  839. # for each minion on every request. This feature should only be enabled in cases
  840. # where pillar rendering time is known to be unsatisfactory and any attendant security
  841. # concerns about storing pillars in a master cache have been addressed.
  842. #
  843. # When enabling this feature, be certain to read through the additional ``pillar_cache_*``
  844. # configuration options to fully understand the tunable parameters and their implications.
  845. #
  846. # Note: setting ``pillar_cache: True`` has no effect on targeting Minions with Pillars.
  847. # See https://docs.saltstack.com/en/latest/topics/targeting/pillar.html
  848. #pillar_cache: False
  849. # If and only if a master has set ``pillar_cache: True``, the cache TTL controls the amount
  850. # of time, in seconds, before the cache is considered invalid by a master and a fresh
  851. # pillar is recompiled and stored.
  852. #pillar_cache_ttl: 3600
  853. # If and only if a master has set `pillar_cache: True`, one of several storage providers
  854. # can be utilized.
  855. #
  856. # `disk`: The default storage backend. This caches rendered pillars to the master cache.
  857. # Rendered pillars are serialized and deserialized as msgpack structures for speed.
  858. # Note that pillars are stored UNENCRYPTED. Ensure that the master cache
  859. # has permissions set appropriately. (Same defaults are provided.)
  860. #
  861. # memory: [EXPERIMENTAL] An optional backend for pillar caches which uses a pure-Python
  862. # in-memory data structure for maximal performance. There are several caveats,
  863. # however. First, because each master worker contains its own in-memory cache,
  864. # there is no guarantee of cache consistency between minion requests. This
  865. # works best in situations where the pillar rarely if ever changes. Secondly,
  866. # and perhaps more importantly, this means that unencrypted pillars will
  867. # be accessible to any process which can examine the memory of the ``salt-master``!
  868. # This may represent a substantial security risk.
  869. #
  870. #pillar_cache_backend: disk
  871. ###### Reactor Settings #####
  872. ###########################################
  873. # Define a salt reactor. See https://docs.saltstack.com/en/latest/topics/reactor/
  874. #reactor: []
  875. #Set the TTL for the cache of the reactor configuration.
  876. #reactor_refresh_interval: 60
  877. #Configure the number of workers for the runner/wheel in the reactor.
  878. #reactor_worker_threads: 10
  879. #Define the queue size for workers in the reactor.
  880. #reactor_worker_hwm: 10000
  881. ##### Syndic settings #####
  882. ##########################################
  883. # The Salt syndic is used to pass commands through a master from a higher
  884. # master. Using the syndic is simple. If this is a master that will have
  885. # syndic servers(s) below it, then set the "order_masters" setting to True.
  886. #
  887. # If this is a master that will be running a syndic daemon for passthrough, then
  888. # the "syndic_master" setting needs to be set to the location of the master server
  889. # to receive commands from.
  890. # Set the order_masters setting to True if this master will command lower
  891. # masters' syndic interfaces.
  892. #order_masters: False
  893. # If this master will be running a salt syndic daemon, syndic_master tells
  894. # this master where to receive commands from.
  895. #syndic_master: masterofmasters
  896. # This is the 'ret_port' of the MasterOfMaster:
  897. #syndic_master_port: 4506
  898. # PID file of the syndic daemon:
  899. #syndic_pidfile: /var/run/salt-syndic.pid
  900. # The log file of the salt-syndic daemon:
  901. #syndic_log_file: /var/log/salt/syndic
  902. # The behaviour of the multi-syndic when connection to a master of masters failed.
  903. # Can specify ``random`` (default) or ``ordered``. If set to ``random``, masters
  904. # will be iterated in random order. If ``ordered`` is specified, the configured
  905. # order will be used.
  906. #syndic_failover: random
  907. # The number of seconds for the salt client to wait for additional syndics to
  908. # check in with their lists of expected minions before giving up.
  909. #syndic_wait: 5
  910. ##### Peer Publish settings #####
  911. ##########################################
  912. # Salt minions can send commands to other minions, but only if the minion is
  913. # allowed to. By default "Peer Publication" is disabled, and when enabled it
  914. # is enabled for specific minions and specific commands. This allows secure
  915. # compartmentalization of commands based on individual minions.
  916. # The configuration uses regular expressions to match minions and then a list
  917. # of regular expressions to match functions. The following will allow the
  918. # minion authenticated as foo.example.com to execute functions from the test
  919. # and pkg modules.
  920. #peer:
  921. # foo.example.com:
  922. # - test.*
  923. # - pkg.*
  924. #
  925. # This will allow all minions to execute all commands:
  926. #peer:
  927. # .*:
  928. # - .*
  929. #
  930. # This is not recommended, since it would allow anyone who gets root on any
  931. # single minion to instantly have root on all of the minions!
  932. # Minions can also be allowed to execute runners from the salt master.
  933. # Since executing a runner from the minion could be considered a security risk,
  934. # it needs to be enabled. This setting functions just like the peer setting
  935. # except that it opens up runners instead of module functions.
  936. #
  937. # All peer runner support is turned off by default and must be enabled before
  938. # using. This will enable all peer runners for all minions:
  939. #peer_run:
  940. # .*:
  941. # - .*
  942. #
  943. # To enable just the manage.up runner for the minion foo.example.com:
  944. #peer_run:
  945. # foo.example.com:
  946. # - manage.up
  947. #
  948. #
  949. ##### Mine settings #####
  950. #####################################
  951. # Restrict mine.get access from minions. By default any minion has a full access
  952. # to get all mine data from master cache. In acl definion below, only pcre matches
  953. # are allowed.
  954. # mine_get:
  955. # .*:
  956. # - .*
  957. #
  958. # The example below enables minion foo.example.com to get 'network.interfaces' mine
  959. # data only, minions web* to get all network.* and disk.* mine data and all other
  960. # minions won't get any mine data.
  961. # mine_get:
  962. # foo.example.com:
  963. # - network.interfaces
  964. # web.*:
  965. # - network.*
  966. # - disk.*
  967. ##### Logging settings #####
  968. ##########################################
  969. # The location of the master log file
  970. # The master log can be sent to a regular file, local path name, or network
  971. # location. Remote logging works best when configured to use rsyslogd(8) (e.g.:
  972. # ``file:///dev/log``), with rsyslogd(8) configured for network logging. The URI
  973. # format is: <file|udp|tcp>://<host|socketpath>:<port-if-required>/<log-facility>
  974. #log_file: /var/log/salt/master
  975. #log_file: file:///dev/log
  976. #log_file: udp://loghost:10514
  977. #log_file: /var/log/salt/master
  978. #key_logfile: /var/log/salt/key
  979. # The level of messages to send to the console.
  980. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  981. #
  982. # The following log levels are considered INSECURE and may log sensitive data:
  983. # ['garbage', 'trace', 'debug']
  984. #
  985. #log_level: warning
  986. # The level of messages to send to the log file.
  987. # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
  988. # If using 'log_granular_levels' this must be set to the highest desired level.
  989. #log_level_logfile: warning
  990. # The date and time format used in log messages. Allowed date/time formatting
  991. # can be seen here: http://docs.python.org/library/time.html#time.strftime
  992. #log_datefmt: '%H:%M:%S'
  993. #log_datefmt_logfile: '%Y-%m-%d %H:%M:%S'
  994. # The format of the console logging messages. Allowed formatting options can
  995. # be seen here: http://docs.python.org/library/logging.html#logrecord-attributes
  996. #
  997. # Console log colors are specified by these additional formatters:
  998. #
  999. # %(colorlevel)s
  1000. # %(colorname)s
  1001. # %(colorprocess)s
  1002. # %(colormsg)s
  1003. #
  1004. # Since it is desirable to include the surrounding brackets, '[' and ']', in
  1005. # the coloring of the messages, these color formatters also include padding as
  1006. # well. Color LogRecord attributes are only available for console logging.
  1007. #
  1008. #log_fmt_console: '%(colorlevel)s %(colormsg)s'
  1009. #log_fmt_console: '[%(levelname)-8s] %(message)s'
  1010. #
  1011. #log_fmt_logfile: '%(asctime)s,%(msecs)03d [%(name)-17s][%(levelname)-8s] %(message)s'
  1012. # This can be used to control logging levels more specificically. This
  1013. # example sets the main salt library at the 'warning' level, but sets
  1014. # 'salt.modules' to log at the 'debug' level:
  1015. # log_granular_levels:
  1016. # 'salt': 'warning'
  1017. # 'salt.modules': 'debug'
  1018. #
  1019. #log_granular_levels: {}
  1020. ##### Node Groups ######
  1021. ##########################################
  1022. # Node groups allow for logical groupings of minion nodes. A group consists of
  1023. # a group name and a compound target. Nodgroups can reference other nodegroups
  1024. # with 'N@' classifier. Ensure that you do not have circular references.
  1025. #
  1026. #nodegroups:
  1027. # group1: 'L@foo.domain.com,bar.domain.com,baz.domain.com or bl*.domain.com'
  1028. # group2: 'G@os:Debian and foo.domain.com'
  1029. # group3: 'G@os:Debian and N@group1'
  1030. # group4:
  1031. # - 'G@foo:bar'
  1032. # - 'or'
  1033. # - 'G@foo:baz'
  1034. ##### Range Cluster settings #####
  1035. ##########################################
  1036. # The range server (and optional port) that serves your cluster information
  1037. # https://github.com/ytoolshed/range/wiki/%22yamlfile%22-module-file-spec
  1038. #
  1039. #range_server: range:80
  1040. ##### Windows Software Repo settings #####
  1041. ###########################################
  1042. # Location of the repo on the master:
  1043. #winrepo_dir_ng: '/srv/salt/win/repo-ng'
  1044. #
  1045. # List of git repositories to include with the local repo:
  1046. #winrepo_remotes_ng:
  1047. # - 'https://github.com/saltstack/salt-winrepo-ng.git'
  1048. ##### Windows Software Repo settings - Pre 2015.8 #####
  1049. ########################################################
  1050. # Legacy repo settings for pre-2015.8 Windows minions.
  1051. #
  1052. # Location of the repo on the master:
  1053. #winrepo_dir: '/srv/salt/win/repo'
  1054. #
  1055. # Location of the master's repo cache file:
  1056. #winrepo_mastercachefile: '/srv/salt/win/repo/winrepo.p'
  1057. #
  1058. # List of git repositories to include with the local repo:
  1059. #winrepo_remotes:
  1060. # - 'https://github.com/saltstack/salt-winrepo.git'
  1061. # The refspecs fetched by winrepo remotes
  1062. #winrepo_refspecs:
  1063. # - '+refs/heads/*:refs/remotes/origin/*'
  1064. # - '+refs/tags/*:refs/tags/*'
  1065. #
  1066. ##### Returner settings ######
  1067. ############################################
  1068. # Which returner(s) will be used for minion's result:
  1069. #return: mysql
  1070. ###### Miscellaneous settings ######
  1071. ############################################
  1072. # Default match type for filtering events tags: startswith, endswith, find, regex, fnmatch
  1073. #event_match_type: startswith
  1074. # Save runner returns to the job cache
  1075. #runner_returns: True
  1076. # Permanently include any available Python 3rd party modules into thin and minimal Salt
  1077. # when they are generated for Salt-SSH or other purposes.
  1078. # The modules should be named by the names they are actually imported inside the Python.
  1079. # The value of the parameters can be either one module or a comma separated list of them.
  1080. #thin_extra_mods: foo,bar
  1081. #min_extra_mods: foo,bar,baz
  1082. ###### Keepalive settings ######
  1083. ############################################
  1084. # Warning: Failure to set TCP keepalives on the salt-master can result in
  1085. # not detecting the loss of a minion when the connection is lost or when
  1086. # it's host has been terminated without first closing the socket.
  1087. # Salt's Presence System depends on this connection status to know if a minion
  1088. # is "present".
  1089. # ZeroMQ now includes support for configuring SO_KEEPALIVE if supported by
  1090. # the OS. If connections between the minion and the master pass through
  1091. # a state tracking device such as a firewall or VPN gateway, there is
  1092. # the risk that it could tear down the connection the master and minion
  1093. # without informing either party that their connection has been taken away.
  1094. # Enabling TCP Keepalives prevents this from happening.
  1095. # Overall state of TCP Keepalives, enable (1 or True), disable (0 or False)
  1096. # or leave to the OS defaults (-1), on Linux, typically disabled. Default True, enabled.
  1097. #tcp_keepalive: True
  1098. # How long before the first keepalive should be sent in seconds. Default 300
  1099. # to send the first keepalive after 5 minutes, OS default (-1) is typically 7200 seconds
  1100. # on Linux see /proc/sys/net/ipv4/tcp_keepalive_time.
  1101. #tcp_keepalive_idle: 300
  1102. # How many lost probes are needed to consider the connection lost. Default -1
  1103. # to use OS defaults, typically 9 on Linux, see /proc/sys/net/ipv4/tcp_keepalive_probes.
  1104. #tcp_keepalive_cnt: -1
  1105. # How often, in seconds, to send keepalives after the first one. Default -1 to
  1106. # use OS defaults, typically 75 seconds on Linux, see
  1107. # /proc/sys/net/ipv4/tcp_keepalive_intvl.
  1108. #tcp_keepalive_intvl: -1