summaryrefslogtreecommitdiffstats
path: root/meta-openstack/recipes-support/salt/files/minion
diff options
context:
space:
mode:
Diffstat (limited to 'meta-openstack/recipes-support/salt/files/minion')
-rw-r--r--meta-openstack/recipes-support/salt/files/minion494
1 files changed, 494 insertions, 0 deletions
diff --git a/meta-openstack/recipes-support/salt/files/minion b/meta-openstack/recipes-support/salt/files/minion
new file mode 100644
index 0000000..8fdde14
--- /dev/null
+++ b/meta-openstack/recipes-support/salt/files/minion
@@ -0,0 +1,494 @@
1##### Primary configuration settings #####
2##########################################
3
4# Per default the minion will automatically include all config files
5# from minion.d/*.conf (minion.d is a directory in the same directory
6# as the main minion config file).
7#default_include: minion.d/*.conf
8
9# Set the location of the salt master server, if the master server cannot be
10# resolved, then the minion will fail to start.
11#master: salt
12
13# Set whether the minion should connect to the master via IPv6
14#ipv6: False
15
16# Set the number of seconds to wait before attempting to resolve
17# the master hostname if name resolution fails. Defaults to 30 seconds.
18# Set to zero if the minion should shutdown and not retry.
19# retry_dns: 30
20
21# Set the port used by the master reply and authentication server
22#master_port: 4506
23
24# The user to run salt
25#user: root
26
27# Specify the location of the daemon process ID file
28#pidfile: /var/run/salt-minion.pid
29
30# The root directory prepended to these options: pki_dir, cachedir, log_file,
31# sock_dir, pidfile.
32#root_dir: /
33
34# The directory to store the pki information in
35#pki_dir: /etc/salt/pki/minion
36
37# Explicitly declare the id for this minion to use, if left commented the id
38# will be the hostname as returned by the python call: socket.getfqdn()
39# Since salt uses detached ids it is possible to run multiple minions on the
40# same machine but with different ids, this can be useful for salt compute
41# clusters.
42#id:
43
44# Append a domain to a hostname in the event that it does not exist. This is
45# useful for systems where socket.getfqdn() does not actually result in a
46# FQDN (for instance, Solaris).
47#append_domain:
48
49# Custom static grains for this minion can be specified here and used in SLS
50# files just like all other grains. This example sets 4 custom grains, with
51# the 'roles' grain having two values that can be matched against:
52#grains:
53# roles:
54# - webserver
55# - memcache
56# deployment: datacenter4
57# cabinet: 13
58# cab_u: 14-15
59
60# Where cache data goes
61#cachedir: /var/cache/salt/minion
62
63# Verify and set permissions on configuration directories at startup
64#verify_env: True
65
66# The minion can locally cache the return data from jobs sent to it, this
67# can be a good way to keep track of jobs the minion has executed
68# (on the minion side). By default this feature is disabled, to enable
69# set cache_jobs to True
70#cache_jobs: False
71
72# set the directory used to hold unix sockets
73#sock_dir: /var/run/salt/minion
74
75# Set the default outputter used by the salt-call command. The default is
76# "nested"
77#output: nested
78#
79# By default output is colored, to disable colored output set the color value
80# to False
81#color: True
82
83# Backup files that are replaced by file.managed and file.recurse under
84# 'cachedir'/file_backups relative to their original location and appended
85# with a timestamp. The only valid setting is "minion". Disabled by default.
86#
87# Alternatively this can be specified for each file in state files:
88#
89# /etc/ssh/sshd_config:
90# file.managed:
91# - source: salt://ssh/sshd_config
92# - backup: minion
93#
94#backup_mode: minion
95
96# When waiting for a master to accept the minion's public key, salt will
97# continuously attempt to reconnect until successful. This is the time, in
98# seconds, between those reconnection attempts.
99#acceptance_wait_time: 10
100
101# If this is nonzero, the time between reconnection attempts will increase by
102# acceptance_wait_time seconds per iteration, up to this maximum. If this is
103# set to zero, the time between reconnection attempts will stay constant.
104#acceptance_wait_time_max: 0
105
106# When the master key changes, the minion will try to re-auth itself to receive
107# the new master key. In larger environments this can cause a SYN flood on the
108# master because all minions try to re-auth immediately. To prevent this and
109# have a minion wait for a random amount of time, use this optional parameter.
110# The wait-time will be a random number of seconds between
111# 0 and the defined value.
112#random_reauth_delay: 60
113
114
115# If you don't have any problems with syn-floods, dont bother with the
116# three recon_* settings described below, just leave the defaults!
117#
118# The ZeroMQ pull-socket that binds to the masters publishing interface tries
119# to reconnect immediately, if the socket is disconnected (for example if
120# the master processes are restarted). In large setups this will have all
121# minions reconnect immediately which might flood the master (the ZeroMQ-default
122# is usually a 100ms delay). To prevent this, these three recon_* settings
123# can be used.
124#
125# recon_default: the interval in milliseconds that the socket should wait before
126# trying to reconnect to the master (100ms = 1 second)
127#
128# recon_max: the maximum time a socket should wait. each interval the time to wait
129# is calculated by doubling the previous time. if recon_max is reached,
130# it starts again at recon_default. Short example:
131#
132# reconnect 1: the socket will wait 'recon_default' milliseconds
133# reconnect 2: 'recon_default' * 2
134# reconnect 3: ('recon_default' * 2) * 2
135# reconnect 4: value from previous interval * 2
136# reconnect 5: value from previous interval * 2
137# reconnect x: if value >= recon_max, it starts again with recon_default
138#
139# recon_randomize: generate a random wait time on minion start. The wait time will
140# be a random value between recon_default and recon_default +
141# recon_max. Having all minions reconnect with the same recon_default
142# and recon_max value kind of defeats the purpose of being able to
143# change these settings. If all minions have the same values and your
144# setup is quite large (several thousand minions), they will still
145# flood the master. The desired behaviour is to have timeframe within
146# all minions try to reconnect.
147
148# Example on how to use these settings:
149# The goal: have all minions reconnect within a 60 second timeframe on a disconnect
150#
151# The settings:
152#recon_default: 1000
153#recon_max: 59000
154#recon_randomize: True
155#
156# Each minion will have a randomized reconnect value between 'recon_default'
157# and 'recon_default + recon_max', which in this example means between 1000ms
158# 60000ms (or between 1 and 60 seconds). The generated random-value will be
159# doubled after each attempt to reconnect. Lets say the generated random
160# value is 11 seconds (or 11000ms).
161#
162# reconnect 1: wait 11 seconds
163# reconnect 2: wait 22 seconds
164# reconnect 3: wait 33 seconds
165# reconnect 4: wait 44 seconds
166# reconnect 5: wait 55 seconds
167# reconnect 6: wait time is bigger than 60 seconds (recon_default + recon_max)
168# reconnect 7: wait 11 seconds
169# reconnect 8: wait 22 seconds
170# reconnect 9: wait 33 seconds
171# reconnect x: etc.
172#
173# In a setup with ~6000 thousand hosts these settings would average the reconnects
174# to about 100 per second and all hosts would be reconnected within 60 seconds.
175#recon_default: 100
176#recon_max: 5000
177#recon_randomize: False
178
179# The loop_interval sets how long in seconds the minion will wait between
180# evaluating the scheduler and running cleanup tasks. This defaults to a
181# sane 60 seconds, but if the minion scheduler needs to be evaluated more
182# often lower this value
183#loop_interval: 60
184
185# When healing, a dns_check is run. This is to make sure that the originally
186# resolved dns has not changed. If this is something that does not happen in
187# your environment, set this value to False.
188#dns_check: True
189
190# Windows platforms lack posix IPC and must rely on slower TCP based inter-
191# process communications. Set ipc_mode to 'tcp' on such systems
192#ipc_mode: ipc
193#
194# Overwrite the default tcp ports used by the minion when in tcp mode
195#tcp_pub_port: 4510
196#tcp_pull_port: 4511
197
198# The minion can include configuration from other files. To enable this,
199# pass a list of paths to this option. The paths can be either relative or
200# absolute; if relative, they are considered to be relative to the directory
201# the main minion configuration file lives in (this file). Paths can make use
202# of shell-style globbing. If no files are matched by a path passed to this
203# option then the minion will log a warning message.
204#
205#
206# Include a config file from some other path:
207# include: /etc/salt/extra_config
208#
209# Include config from several files and directories:
210#include:
211# - /etc/salt/extra_config
212# - /etc/roles/webserver
213
214##### Minion module management #####
215##########################################
216# Disable specific modules. This allows the admin to limit the level of
217# access the master has to the minion
218#disable_modules: [cmd,test]
219#disable_returners: []
220#
221# Modules can be loaded from arbitrary paths. This enables the easy deployment
222# of third party modules. Modules for returners and minions can be loaded.
223# Specify a list of extra directories to search for minion modules and
224# returners. These paths must be fully qualified!
225#module_dirs: []
226#returner_dirs: []
227#states_dirs: []
228#render_dirs: []
229#
230# A module provider can be statically overwritten or extended for the minion
231# via the providers option, in this case the default module will be
232# overwritten by the specified module. In this example the pkg module will
233# be provided by the yumpkg5 module instead of the system default.
234#
235#providers:
236# pkg: yumpkg5
237#
238# Enable Cython modules searching and loading. (Default: False)
239#cython_enable: False
240#
241
242##### State Management Settings #####
243###########################################
244# The state management system executes all of the state templates on the minion
245# to enable more granular control of system state management. The type of
246# template and serialization used for state management needs to be configured
247# on the minion, the default renderer is yaml_jinja. This is a yaml file
248# rendered from a jinja template, the available options are:
249# yaml_jinja
250# yaml_mako
251# yaml_wempy
252# json_jinja
253# json_mako
254# json_wempy
255#
256#renderer: yaml_jinja
257#
258# The failhard option tells the minions to stop immediately after the first
259# failure detected in the state execution, defaults to False
260#failhard: False
261#
262# autoload_dynamic_modules Turns on automatic loading of modules found in the
263# environments on the master. This is turned on by default, to turn of
264# autoloading modules when states run set this value to False
265#autoload_dynamic_modules: True
266#
267# clean_dynamic_modules keeps the dynamic modules on the minion in sync with
268# the dynamic modules on the master, this means that if a dynamic module is
269# not on the master it will be deleted from the minion. By default this is
270# enabled and can be disabled by changing this value to False
271#clean_dynamic_modules: True
272#
273# Normally the minion is not isolated to any single environment on the master
274# when running states, but the environment can be isolated on the minion side
275# by statically setting it. Remember that the recommended way to manage
276# environments is to isolate via the top file.
277#environment: None
278#
279# If using the local file directory, then the state top file name needs to be
280# defined, by default this is top.sls.
281#state_top: top.sls
282#
283# Run states when the minion daemon starts. To enable, set startup_states to:
284# 'highstate' -- Execute state.highstate
285# 'sls' -- Read in the sls_list option and execute the named sls files
286# 'top' -- Read top_file option and execute based on that file on the Master
287#startup_states: ''
288#
289# list of states to run when the minion starts up if startup_states is 'sls'
290#sls_list:
291# - edit.vim
292# - hyper
293#
294# top file to execute if startup_states is 'top'
295#top_file: ''
296
297##### File Directory Settings #####
298##########################################
299# The Salt Minion can redirect all file server operations to a local directory,
300# this allows for the same state tree that is on the master to be used if
301# copied completely onto the minion. This is a literal copy of the settings on
302# the master but used to reference a local directory on the minion.
303
304# Set the file client. The client defaults to looking on the master server for
305# files, but can be directed to look at the local file directory setting
306# defined below by setting it to local.
307#file_client: remote
308
309# The file directory works on environments passed to the minion, each environment
310# can have multiple root directories, the subdirectories in the multiple file
311# roots cannot match, otherwise the downloaded files will not be able to be
312# reliably ensured. A base environment is required to house the top file.
313# Example:
314# file_roots:
315# base:
316# - /srv/salt/
317# dev:
318# - /srv/salt/dev/services
319# - /srv/salt/dev/states
320# prod:
321# - /srv/salt/prod/services
322# - /srv/salt/prod/states
323#
324#file_roots:
325# base:
326# - /srv/salt
327
328# By default, the Salt fileserver recurses fully into all defined environments
329# to attempt to find files. To limit this behavior so that the fileserver only
330# traverses directories with SLS files and special Salt directories like _modules,
331# enable the option below. This might be useful for installations where a file root
332# has a very large number of files and performance is negatively impacted.
333#
334# Default is False.
335#
336# fileserver_limit_traversal: False
337
338# The hash_type is the hash to use when discovering the hash of a file in
339# the local fileserver. The default is md5, but sha1, sha224, sha256, sha384
340# and sha512 are also supported.
341#hash_type: md5
342
343# The Salt pillar is searched for locally if file_client is set to local. If
344# this is the case, and pillar data is defined, then the pillar_roots need to
345# also be configured on the minion:
346#pillar_roots:
347# base:
348# - /srv/pillar
349
350###### Security settings #####
351###########################################
352# Enable "open mode", this mode still maintains encryption, but turns off
353# authentication, this is only intended for highly secure environments or for
354# the situation where your keys end up in a bad state. If you run in open mode
355# you do so at your own risk!
356#open_mode: False
357
358# Enable permissive access to the salt keys. This allows you to run the
359# master or minion as root, but have a non-root group be given access to
360# your pki_dir. To make the access explicit, root must belong to the group
361# you've given access to. This is potentially quite insecure.
362#permissive_pki_access: False
363
364# The state_verbose and state_output settings can be used to change the way
365# state system data is printed to the display. By default all data is printed.
366# The state_verbose setting can be set to True or False, when set to False
367# all data that has a result of True and no changes will be suppressed.
368#state_verbose: True
369#
370# The state_output setting changes if the output is the full multi line
371# output for each changed state if set to 'full', but if set to 'terse'
372# the output will be shortened to a single line.
373#state_output: full
374#
375# Fingerprint of the master public key to double verify the master is valid,
376# the master fingerprint can be found by running "salt-key -F master" on the
377# salt master.
378#master_finger: ''
379
380###### Thread settings #####
381###########################################
382# Disable multiprocessing support, by default when a minion receives a
383# publication a new process is spawned and the command is executed therein.
384#multiprocessing: True
385
386##### Logging settings #####
387##########################################
388# The location of the minion log file
389# The minion log can be sent to a regular file, local path name, or network
390# location. Remote logging works best when configured to use rsyslogd(8) (e.g.:
391# ``file:///dev/log``), with rsyslogd(8) configured for network logging. The URI
392# format is: <file|udp|tcp>://<host|socketpath>:<port-if-required>/<log-facility>
393#log_file: /var/log/salt/minion
394#log_file: file:///dev/log
395#log_file: udp://loghost:10514
396#
397#log_file: /var/log/salt/minion
398#key_logfile: /var/log/salt/key
399#
400# The level of messages to send to the console.
401# One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
402# Default: 'warning'
403#log_level: warning
404#
405# The level of messages to send to the log file.
406# One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
407# Default: 'warning'
408#log_level_logfile:
409
410# The date and time format used in log messages. Allowed date/time formating
411# can be seen here: http://docs.python.org/library/time.html#time.strftime
412#log_datefmt: '%H:%M:%S'
413#log_datefmt_logfile: '%Y-%m-%d %H:%M:%S'
414#
415# The format of the console logging messages. Allowed formatting options can
416# be seen here: http://docs.python.org/library/logging.html#logrecord-attributes
417#log_fmt_console: '[%(levelname)-8s] %(message)s'
418#log_fmt_logfile: '%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'
419#
420# This can be used to control logging levels more specificically. This
421# example sets the main salt library at the 'warning' level, but sets
422# 'salt.modules' to log at the 'debug' level:
423# log_granular_levels:
424# 'salt': 'warning',
425# 'salt.modules': 'debug'
426#
427#log_granular_levels: {}
428
429###### Module configuration #####
430###########################################
431# Salt allows for modules to be passed arbitrary configuration data, any data
432# passed here in valid yaml format will be passed on to the salt minion modules
433# for use. It is STRONGLY recommended that a naming convention be used in which
434# the module name is followed by a . and then the value. Also, all top level
435# data must be applied via the yaml dict construct, some examples:
436#
437# You can specify that all modules should run in test mode:
438#test: True
439#
440# A simple value for the test module:
441#test.foo: foo
442#
443# A list for the test module:
444#test.bar: [baz,quo]
445#
446# A dict for the test module:
447#test.baz: {spam: sausage, cheese: bread}
448
449
450###### Update settings ######
451###########################################
452# Using the features in Esky, a salt minion can both run as a frozen app and
453# be updated on the fly. These options control how the update process
454# (saltutil.update()) behaves.
455#
456# The url for finding and downloading updates. Disabled by default.
457#update_url: False
458#
459# The list of services to restart after a successful update. Empty by default.
460#update_restart_services: []
461
462
463###### Keepalive settings ######
464############################################
465# ZeroMQ now includes support for configuring SO_KEEPALIVE if supported by
466# the OS. If connections between the minion and the master pass through
467# a state tracking device such as a firewall or VPN gateway, there is
468# the risk that it could tear down the connection the master and minion
469# without informing either party that their connection has been taken away.
470# Enabling TCP Keepalives prevents this from happening.
471#
472# Overall state of TCP Keepalives, enable (1 or True), disable (0 or False)
473# or leave to the OS defaults (-1), on Linux, typically disabled. Default True, enabled.
474#tcp_keepalive: True
475#
476# How long before the first keepalive should be sent in seconds. Default 300
477# to send the first keepalive after 5 minutes, OS default (-1) is typically 7200 seconds
478# on Linux see /proc/sys/net/ipv4/tcp_keepalive_time.
479#tcp_keepalive_idle: 300
480#
481# How many lost probes are needed to consider the connection lost. Default -1
482# to use OS defaults, typically 9 on Linux, see /proc/sys/net/ipv4/tcp_keepalive_probes.
483#tcp_keepalive_cnt: -1
484#
485# How often, in seconds, to send keepalives after the first one. Default -1 to
486# use OS defaults, typically 75 seconds on Linux, see
487# /proc/sys/net/ipv4/tcp_keepalive_intvl.
488#tcp_keepalive_intvl: -1
489
490
491###### Windows Software settings ######
492############################################
493# Location of the repository cache file on the master
494#win_repo_cachefile: 'salt://win/repo/winrepo.p'