|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985 |
- # This file managed by Salt, do not edit by hand!!
- # Based on salt version 2015.8.7 default config
- #
- {% set reserved_keys = ['master', 'minion', 'cloud', 'salt_cloud_certs'] -%}
- {% set cfg_salt = pillar.get('salt', {}) -%}
- {% set cfg_minion = cfg_salt.get('minion', {}) -%}
- {%- macro get_config(configname, default_value) -%}
- {%- if configname in cfg_minion -%}
- {{ configname }}: {{ cfg_minion[configname] }}
- {%- elif configname in cfg_salt and configname not in reserved_keys -%}
- {{ configname }}: {{ cfg_salt[configname] }}
- {%- else -%}
- #{{ configname }}: {{ default_value }}
- {%- endif -%}
- {%- endmacro -%}
- {%- from 'salt/formulas.jinja' import file_roots, formulas with context -%}
-
- ##### Primary configuration settings #####
- ##########################################
- # This configuration file is used to manage the behavior of the Salt Minion.
- # With the exception of the location of the Salt Master Server, values that are
- # commented out but have an empty line after the comment are defaults that need
- # not be set in the config. If there is no blank line after the comment, the
- # value is presented as an example and is not the default.
-
- # Per default the minion will automatically include all config files
- # from minion.d/*.conf (minion.d is a directory in the same directory
- # as the main minion config file).
- {{ get_config('default_include', 'minion.d/*.conf') }}
-
- # Set the location of the salt master server. If the master server cannot be
- # resolved, then the minion will fail to start.
- {%- if 'master' in cfg_minion and cfg_minion['master'] is not string %}
- master:
- {% for name in cfg_minion['master'] -%}
- - {{ name }}
- {% endfor -%}
- {%- else %}
- {{ get_config('master', 'salt') }}
- {%- endif %}
-
- # If multiple masters are specified in the 'master' setting, the default behavior
- # is to always try to connect to them in the order they are listed. If random_master is
- # set to True, the order will be randomized instead. This can be helpful in distributing
- # the load of many minions executing salt-call requests, for example, from a cron job.
- # If only one master is listed, this setting is ignored and a warning will be logged.
- # NOTE: If master_type is set to failover, use master_shuffle instead.
- {{ get_config('random_master', 'False') }}
-
- # Use if master_type is set to failover.
- {{ get_config('master_shuffle', 'False') }}
-
- # Minions can connect to multiple masters simultaneously (all masters
- # are "hot"), or can be configured to failover if a master becomes
- # unavailable. Multiple hot masters are configured by setting this
- # value to "str". Failover masters can be requested by setting
- # to "failover". MAKE SURE TO SET master_alive_interval if you are
- # using failover.
- {{ get_config('master_type', 'str') }}
-
- # verify_master_pubkey_sign
- {{ get_config('verify_master_pubkey_sign', 'False') }}
-
- # Poll interval in seconds for checking if the master is still there. Only
- # respected if master_type above is "failover". To disable the interval entirely,
- # set the value to -1. (This may be necessary on machines which have high numbers
- # of TCP connections, such as load balancers.)
- {{ get_config('master_alive_interval', '30') }}
-
- # Set whether the minion should connect to the master via IPv6:
- {{ get_config('ipv6', 'False') }}
-
- # Set the number of seconds to wait before attempting to resolve
- # the master hostname if name resolution fails. Defaults to 30 seconds.
- # Set to zero if the minion should shutdown and not retry.
- {{ get_config('retry_dns', '30') }}
-
- # Set the port used by the master reply and authentication server.
- {{ get_config('master_port', '4506') }}
-
- # The user to run salt.
- {{ get_config('user', 'root') }}
-
- # Setting sudo_user will cause salt to run all execution modules under an sudo
- # to the user given in sudo_user. The user under which the salt minion process
- # itself runs will still be that provided in the user config above, but all
- # execution modules run by the minion will be rerouted through sudo.
- {{ get_config('sudo_user', 'saltdev') }}
-
- # Specify the location of the daemon process ID file.
- {{ get_config('pidfile', '/var/run/salt-minion.pid') }}
-
- # The root directory prepended to these options: pki_dir, cachedir, log_file,
- # sock_dir, pidfile.
- {{ get_config('root_dir', '/') }}
-
- # The directory to store the pki information in
- {{ get_config('pki_dir', '/etc/salt/pki/minion') }}
-
- # Explicitly declare the id for this minion to use, if left commented the id
- # will be the hostname as returned by the python call: socket.getfqdn()
- # Since salt uses detached ids it is possible to run multiple minions on the
- # same machine but with different ids, this can be useful for salt compute
- # clusters.
- {% if 'id' in cfg_minion -%}
- id: {{ cfg_minion['id'] }}
- {% else -%}
- #id:
- {%- endif %}
-
- # Append a domain to a hostname in the event that it does not exist. This is
- # useful for systems where socket.getfqdn() does not actually result in a
- # FQDN (for instance, Solaris).
- {{ get_config('append_domain', '') }}
-
- # Custom static grains for this minion can be specified here and used in SLS
- # files just like all other grains. This example sets 4 custom grains, with
- # the 'roles' grain having two values that can be matched against.
- #grains:
- # roles:
- # - webserver
- # - memcache
- # deployment: datacenter4
- # cabinet: 13
- # cab_u: 14-15
- {{ get_config('grains', '{}') }}
-
- # Where cache data goes.
- # This data may contain sensitive data and should be protected accordingly.
- {{ get_config('cachedir', '/var/cache/salt/minion') }}
-
- # Verify and set permissions on configuration directories at startup.
- {{ get_config('verify_env', 'True') }}
-
- # The minion can locally cache the return data from jobs sent to it, this
- # can be a good way to keep track of jobs the minion has executed
- # (on the minion side). By default this feature is disabled, to enable, set
- # cache_jobs to True.
- {{ get_config('cache_jobs', 'False') }}
-
- # Set the directory used to hold unix sockets.
- {{ get_config('sock_dir', '/var/run/salt/minion') }}
-
- # Set the default outputter used by the salt-call command. The default is
- # "nested".
- {{ get_config('output', 'nested') }}
-
- # By default output is colored. To disable colored output, set the color value
- # to False.
- {{ get_config('color', 'True') }}
-
- # Do not strip off the colored output from nested results and state outputs
- # (true by default).
- {{ get_config('strip_colors', 'False') }}
-
- # Backup files that are replaced by file.managed and file.recurse under
- # 'cachedir'/file_backups relative to their original location and appended
- # with a timestamp. The only valid setting is "minion". Disabled by default.
- #
- # Alternatively this can be specified for each file in state files:
- # /etc/ssh/sshd_config:
- # file.managed:
- # - source: salt://ssh/sshd_config
- # - backup: minion
- #
- {{ get_config('backup_mode', 'minion') }}
-
- # When waiting for a master to accept the minion's public key, salt will
- # continuously attempt to reconnect until successful. This is the time, in
- # seconds, between those reconnection attempts.
- {{ get_config('acceptance_wait_time', '10') }}
-
- # If this is nonzero, the time between reconnection attempts will increase by
- # acceptance_wait_time seconds per iteration, up to this maximum. If this is
- # set to zero, the time between reconnection attempts will stay constant.
- {{ get_config('acceptance_wait_time_max', '0') }}
-
- # If the master rejects the minion's public key, retry instead of exiting.
- # Rejected keys will be handled the same as waiting on acceptance.
- {{ get_config('rejected_retry', 'False') }}
-
- # When the master key changes, the minion will try to re-auth itself to receive
- # the new master key. In larger environments this can cause a SYN flood on the
- # master because all minions try to re-auth immediately. To prevent this and
- # have a minion wait for a random amount of time, use this optional parameter.
- # The wait-time will be a random number of seconds between 0 and the defined value.
- {{ get_config('random_reauth_delay', '60') }}
-
- # When waiting for a master to accept the minion's public key, salt will
- # continuously attempt to reconnect until successful. This is the timeout value,
- # in seconds, for each individual attempt. After this timeout expires, the minion
- # will wait for acceptance_wait_time seconds before trying again. Unless your master
- # is under unusually heavy load, this should be left at the default.
- {{ get_config('auth_timeout', '60') }}
-
- # Number of consecutive SaltReqTimeoutError that are acceptable when trying to
- # authenticate.
- {{ get_config('auth_tries', '7') }}
-
- # If authentication fails due to SaltReqTimeoutError during a ping_interval,
- # cause sub minion process to restart.
- {{ get_config('auth_safemode', 'False') }}
-
- # Ping Master to ensure connection is alive (minutes).
- {{ get_config('ping_interval', '0') }}
-
- {%- if 'mine_functions' in cfg_minion %}
- mine_functions:
- {%- for func, args in cfg_minion['mine_functions'].items() %}
- {{ func }}: {{ args }}
- {%- endfor %}
- {%- endif %}
-
-
- # To auto recover minions if master changes IP address (DDNS)
- # auth_tries: 10
- # auth_safemode: False
- # ping_interval: 90
- #
- # Minions won't know master is missing until a ping fails. After the ping fail,
- # the minion will attempt authentication and likely fails out and cause a restart.
- # When the minion restarts it will resolve the masters IP and attempt to reconnect.
-
- # If you don't have any problems with syn-floods, don't bother with the
- # three recon_* settings described below, just leave the defaults!
- #
- # The ZeroMQ pull-socket that binds to the masters publishing interface tries
- # to reconnect immediately, if the socket is disconnected (for example if
- # the master processes are restarted). In large setups this will have all
- # minions reconnect immediately which might flood the master (the ZeroMQ-default
- # is usually a 100ms delay). To prevent this, these three recon_* settings
- # can be used.
- # recon_default: the interval in milliseconds that the socket should wait before
- # trying to reconnect to the master (1000ms = 1 second)
- #
- # recon_max: the maximum time a socket should wait. each interval the time to wait
- # is calculated by doubling the previous time. if recon_max is reached,
- # it starts again at recon_default. Short example:
- #
- # reconnect 1: the socket will wait 'recon_default' milliseconds
- # reconnect 2: 'recon_default' * 2
- # reconnect 3: ('recon_default' * 2) * 2
- # reconnect 4: value from previous interval * 2
- # reconnect 5: value from previous interval * 2
- # reconnect x: if value >= recon_max, it starts again with recon_default
- #
- # recon_randomize: generate a random wait time on minion start. The wait time will
- # be a random value between recon_default and recon_default +
- # recon_max. Having all minions reconnect with the same recon_default
- # and recon_max value kind of defeats the purpose of being able to
- # change these settings. If all minions have the same values and your
- # setup is quite large (several thousand minions), they will still
- # flood the master. The desired behavior is to have timeframe within
- # all minions try to reconnect.
- #
- # Example on how to use these settings. The goal: have all minions reconnect within a
- # 60 second timeframe on a disconnect.
- # recon_default: 1000
- # recon_max: 59000
- # recon_randomize: True
- #
- # Each minion will have a randomized reconnect value between 'recon_default'
- # and 'recon_default + recon_max', which in this example means between 1000ms
- # 60000ms (or between 1 and 60 seconds). The generated random-value will be
- # doubled after each attempt to reconnect. Lets say the generated random
- # value is 11 seconds (or 11000ms).
- # reconnect 1: wait 11 seconds
- # reconnect 2: wait 22 seconds
- # reconnect 3: wait 33 seconds
- # reconnect 4: wait 44 seconds
- # reconnect 5: wait 55 seconds
- # reconnect 6: wait time is bigger than 60 seconds (recon_default + recon_max)
- # reconnect 7: wait 11 seconds
- # reconnect 8: wait 22 seconds
- # reconnect 9: wait 33 seconds
- # reconnect x: etc.
- #
- # In a setup with ~6000 thousand hosts these settings would average the reconnects
- # to about 100 per second and all hosts would be reconnected within 60 seconds.
- {{ get_config('recon_default', '100') }}
- {{ get_config('recon_max', '5000') }}
- {{ get_config('recon_randomize', 'False') }}
-
- # The loop_interval sets how long in seconds the minion will wait between
- # evaluating the scheduler and running cleanup tasks. This defaults to a
- # sane 60 seconds, but if the minion scheduler needs to be evaluated more
- # often lower this value
- {{ get_config('loop_interval', '60') }}
-
- # The grains_refresh_every setting allows for a minion to periodically check
- # its grains to see if they have changed and, if so, to inform the master
- # of the new grains. This operation is moderately expensive, therefore
- # care should be taken not to set this value too low.
- #
- # Note: This value is expressed in __minutes__!
- #
- # A value of 10 minutes is a reasonable default.
- #
- # If the value is set to zero, this check is disabled.
- {{ get_config('grains_refresh_every', '1') }}
-
- # Cache grains on the minion. Default is False.
- {{ get_config('grains_cache', 'False') }}
-
- # Grains cache expiration, in seconds. If the cache file is older than this
- # number of seconds then the grains cache will be dumped and fully re-populated
- # with fresh data. Defaults to 5 minutes. Will have no effect if 'grains_cache'
- # is not enabled.
- {{ get_config('grains_cache_expiration', '300') }}
-
- # Windows platforms lack posix IPC and must rely on slower TCP based inter-
- # process communications. Set ipc_mode to 'tcp' on such systems
- {{ get_config('ipc_mode', 'ipc') }}
-
- # Overwrite the default tcp ports used by the minion when in tcp mode
- {{ get_config('tcp_pub_port', '4510') }}
- {{ get_config('tcp_pull_port', '4511') }}
-
- # Passing very large events can cause the minion to consume large amounts of
- # memory. This value tunes the maximum size of a message allowed onto the
- # minion event bus. The value is expressed in bytes.
- {{ get_config('max_event_size', '1048576') }}
-
- # To detect failed master(s) and fire events on connect/disconnect, set
- # master_alive_interval to the number of seconds to poll the masters for
- # connection events.
- #
- {{ get_config('master_alive_interval', '30') }}
-
- # The minion can include configuration from other files. To enable this,
- # pass a list of paths to this option. The paths can be either relative or
- # absolute; if relative, they are considered to be relative to the directory
- # the main minion configuration file lives in (this file). Paths can make use
- # of shell-style globbing. If no files are matched by a path passed to this
- # option then the minion will log a warning message.
- #
- # Include a config file from some other path:
- {% if 'include' in cfg_minion -%}
- {% if isinstance(cfg_minion['include'], list) -%}
- include:
- {% for include in cfg_minion['include'] -%}
- - {{ include }}
- {% endfor -%}
- {% else -%}
- include: cfg_minion['include']
- {% endif -%}
- {% elif 'include' in cfg_salt -%}
- {% if isinstance(cfg_salt['include'], list) -%}
- include:
- {% for include in cfg_salt['include'] -%}
- - {{ include }}
- {% endfor -%}
- {% else -%}
- include: cfg_salt['include']
- {% endif -%}
- {% endif -%}
-
- ##### Minion module management #####
- ##########################################
- # Disable specific modules. This allows the admin to limit the level of
- # access the master has to the minion.
- {{ get_config('disable_modules', '[cmd,test]') }}
- {{ get_config('disable_returners', '[]') }}
-
- # Modules can be loaded from arbitrary paths. This enables the easy deployment
- # of third party modules. Modules for returners and minions can be loaded.
- # Specify a list of extra directories to search for minion modules and
- # returners. These paths must be fully qualified!
- {{ get_config('module_dirs', '[]') }}
- {{ get_config('returner_dirs', '[]') }}
- {{ get_config('states_dirs', '[]') }}
- {{ get_config('render_dirs', '[]') }}
- {{ get_config('utils_dirs', '[]') }}
-
- # A module provider can be statically overwritten or extended for the minion
- # via the providers option, in this case the default module will be
- # overwritten by the specified module. In this example the pkg module will
- # be provided by the yumpkg5 module instead of the system default.
- #providers:
- # pkg: yumpkg5
- {{ get_config('providers', '{}') }}
-
- # Enable Cython modules searching and loading. (Default: False)
- {{ get_config('cython_enable', 'False') }}
-
- # Specify a max size (in bytes) for modules on import. This feature is currently
- # only supported on *nix operating systems and requires psutil.
- {{ get_config('modules_max_memory', '-1') }}
-
- ##### State Management Settings #####
- ###########################################
- # The state management system executes all of the state templates on the minion
- # to enable more granular control of system state management. The type of
- # template and serialization used for state management needs to be configured
- # on the minion, the default renderer is yaml_jinja. This is a yaml file
- # rendered from a jinja template, the available options are:
- # yaml_jinja
- # yaml_mako
- # yaml_wempy
- # json_jinja
- # json_mako
- # json_wempy
- #
- {{ get_config('renderer', 'yaml_jinja') }}
-
- # The failhard option tells the minions to stop immediately after the first
- # failure detected in the state execution. Defaults to False.
- {{ get_config('failhard', 'False') }}
-
- # Reload the modules prior to a highstate run.
- {{ get_config('autoload_dynamic_modules', 'True') }}
-
- # clean_dynamic_modules keeps the dynamic modules on the minion in sync with
- # the dynamic modules on the master, this means that if a dynamic module is
- # not on the master it will be deleted from the minion. By default, this is
- # enabled and can be disabled by changing this value to False.
- {{ get_config('clean_dynamic_modules', 'True') }}
-
- # Normally, the minion is not isolated to any single environment on the master
- # when running states, but the environment can be isolated on the minion side
- # by statically setting it. Remember that the recommended way to manage
- # environments is to isolate via the top file.
- {{ get_config('environment', 'None') }}
-
- # If using the local file directory, then the state top file name needs to be
- # defined, by default this is top.sls.
- {{ get_config('state_top', 'top.sls') }}
-
- # Run states when the minion daemon starts. To enable, set startup_states to:
- # 'highstate' -- Execute state.highstate
- # 'sls' -- Read in the sls_list option and execute the named sls files
- # 'top' -- Read top_file option and execute based on that file on the Master
- {{ get_config('startup_states', "''") }}
-
- # List of states to run when the minion starts up if startup_states is 'sls':
- #sls_list:
- # - edit.vim
- # - hyper
- {{ get_config('sls_list', '[]') }}
-
- # Top file to execute if startup_states is 'top':
- {{ get_config('top_file', "''") }}
-
- # Automatically aggregate all states that have support for mod_aggregate by
- # setting to True. Or pass a list of state module names to automatically
- # aggregate just those types.
- #
- # state_aggregate:
- # - pkg
- #
- #state_aggregate: False
- {{ get_config('state_aggregate', '{}') }}
-
- ##### File Directory Settings #####
- ##########################################
- # The Salt Minion can redirect all file server operations to a local directory,
- # this allows for the same state tree that is on the master to be used if
- # copied completely onto the minion. This is a literal copy of the settings on
- # the master but used to reference a local directory on the minion.
-
- # Set the file client. The client defaults to looking on the master server for
- # files, but can be directed to look at the local file directory setting
- # defined below by setting it to "local". Setting a local file_client runs the
- # minion in masterless mode.
- {%- if standalone %}
- file_client: local
- {%- else %}
- {{ get_config('file_client', 'remote') }}
- {%- endif %}
-
- # The file directory works on environments passed to the minion, each environment
- # can have multiple root directories, the subdirectories in the multiple file
- # roots cannot match, otherwise the downloaded files will not be able to be
- # reliably ensured. A base environment is required to house the top file.
- # Example:
- # file_roots:
- # base:
- # - /srv/salt/
- # dev:
- # - /srv/salt/dev/services
- # - /srv/salt/dev/states
- # prod:
- # - /srv/salt/prod/services
- # - /srv/salt/prod/states
- {% if 'file_roots' in cfg_minion -%}
- {{ file_roots(cfg_minion['file_roots']) }}
- {%- elif 'file_roots' in cfg_salt -%}
- {{ file_roots(cfg_salt['file_roots']) }}
- {%- elif formulas|length -%}
- {{ file_roots({'base': ['/srv/salt']}) }}
- {%- else -%}
- #file_roots:
- # base:
- # - /srv/salt
- {%- endif %}
-
-
- # File Server Backend
- #
- # Salt supports a modular fileserver backend system, this system allows
- # the salt minion to link directly to third party systems to gather and
- # manage the files available to minions. Multiple backends can be
- # configured and will be searched for the requested file in the order in which
- # they are defined here. The default setting only enables the standard backend
- # "roots" which uses the "file_roots" option.
- #fileserver_backend:
- # - roots
- #
- # To use multiple backends list them in the order they are searched:
- #fileserver_backend:
- # - git
- # - roots
- {% if 'fileserver_backend' in cfg_minion -%}
- fileserver_backend:
- {%- for backend in cfg_minion['fileserver_backend'] %}
- - {{ backend }}
- {%- endfor -%}
- {%- endif %}
-
- # By default, the Salt fileserver recurses fully into all defined environments
- # to attempt to find files. To limit this behavior so that the fileserver only
- # traverses directories with SLS files and special Salt directories like _modules,
- # enable the option below. This might be useful for installations where a file root
- # has a very large number of files and performance is negatively impacted. Default
- # is False.
- {{ get_config('fileserver_limit_traversal', 'False') }}
-
- # The hash_type is the hash to use when discovering the hash of a file in
- # the local fileserver. The default is md5, but sha1, sha224, sha256, sha384
- # and sha512 are also supported.
- #
- # Warning: Prior to changing this value, the minion should be stopped and all
- # Salt caches should be cleared.
- {{ get_config('hash_type', 'md5') }}
-
- # gitfs provider
- {{ get_config('gitfs_provider', 'pygit2') }}
-
- # Along with gitfs_password, is used to authenticate to HTTPS remotes.
- {{ get_config('gitfs_user', 'git') }}
-
- # Along with gitfs_user, is used to authenticate to HTTPS remotes.
- # This parameter is not required if the repository does not use authentication.
- {{ get_config('gitfs_password', '') }}
-
- # By default, Salt will not authenticate to an HTTP (non-HTTPS) remote.
- # This parameter enables authentication over HTTP. Enable this at your own risk.
- {{ get_config('gitfs_insecure_auth', 'False') }}
-
- # Along with gitfs_privkey (and optionally gitfs_passphrase), is used to
- # authenticate to SSH remotes. This parameter (or its per-remote counterpart)
- # is required for SSH remotes.
- {{ get_config('gitfs_pubkey', '') }}
-
- # Along with gitfs_pubkey (and optionally gitfs_passphrase), is used to
- # authenticate to SSH remotes. This parameter (or its per-remote counterpart)
- # is required for SSH remotes.
- {{ get_config('gitfs_privkey', '') }}
-
- # This parameter is optional, required only when the SSH key being used to
- # authenticate is protected by a passphrase.
- {{ get_config('gitfs_passphrase', '') }}
- # When using the git fileserver backend at least one git remote needs to be
- # defined. The user running the salt master will need read access to the repo.
- #
- # The repos will be searched in order to find the file requested by a client
- # and the first repo to have the file will return it.
- # When using the git backend branches and tags are translated into salt
- # environments.
- # Note: file:// repos will be treated as a remote, so refs you want used must
- # exist in that repo as *local* refs.
- {% if 'gitfs_remotes' in cfg_minion -%}
- gitfs_remotes:
- {%- for remote in cfg_minion['gitfs_remotes'] %}
- {%- if remote is iterable and remote is not string %}
- {%- for repo, children in remote.items() %}
- - {{ repo }}:
- {%- for child in children %}
- {%- for key, value in child.items() %}
- - {{ key }}: {{ value }}
- {%- endfor -%}
- {%- endfor -%}
- {%- endfor -%}
- {%- else %}
- - {{ remote }}
- {%- endif -%}
- {%- endfor -%}
- {%- endif %}
-
- # The gitfs_ssl_verify option specifies whether to ignore ssl certificate
- # errors when contacting the gitfs backend. You might want to set this to
- # false if you're using a git backend that uses a self-signed certificate but
- # keep in mind that setting this flag to anything other than the default of True
- # is a security concern, you may want to try using the ssh transport.
- {{ get_config('gitfs_ssl_verify', 'True') }}
-
- # The gitfs_root option gives the ability to serve files from a subdirectory
- # within the repository. The path is defined relative to the root of the
- # repository and defaults to the repository root.
- {{ get_config('gitfs_root', 'somefolder/otherfolder') }}
-
- # The gitfs_env_whitelist and gitfs_env_blacklist parameters allow for greater
- # control over which branches/tags are exposed as fileserver environments.
- {% if 'gitfs_env_whitelist' in cfg_minion -%}
- gitfs_env_whitelist:
- {%- for git_env in cfg_minion['gitfs_env_whitelist'] %}
- - {{ git_env }}
- {%- endfor -%}
- {% else -%}
- # gitfs_env_whitelist:
- # - base
- # - v1.*
- {% endif %}
-
- {% if 'gitfs_env_blacklist' in cfg_minion -%}
- gitfs_env_blacklist:
- {%- for git_env in cfg_minion['gitfs_env_blacklist'] %}
- - {{ git_env }}
- {%- endfor -%}
- {% else -%}
- # gitfs_env_blacklist:
- # - bug/*
- # - feature/*
- {% endif %}
-
- ##### Pillar settings #####
- ##########################################
- # The Salt pillar is searched for locally if file_client is set to local. If
- # this is the case, and pillar data is defined, then the pillar_roots need to
- # also be configured on the minion:
- {% if 'pillar_roots' in cfg_minion -%}
- pillar_roots:
- {%- for name, roots in cfg_minion['pillar_roots']|dictsort %}
- {{ name }}:
- {%- for dir in roots %}
- - {{ dir }}
- {%- endfor -%}
- {%- endfor -%}
- {% elif 'pillar_roots' in cfg_salt -%}
- pillar_roots:
- {%- for name, roots in cfg_salt['pillar_roots']|dictsort %}
- {{ name }}:
- {%- for dir in roots %}
- - {{ dir }}
- {%- endfor -%}
- {%- endfor -%}
- {%- else -%}
- #pillar_roots:
- # base:
- # - /srv/pillar
- {%- endif %}
-
- {% if 'ext_pillar' in cfg_minion %}
- ext_pillar:
- {%- for pillar in cfg_minion['ext_pillar'] -%}
- {%- for key in pillar -%}
- {%- if pillar[key] is string %}
- - {{ key }}: {{ pillar[key] }}
- {%- elif pillar[key] is iterable and pillar[key] is not mapping %}
- - {{ key }}:
- {%- for parameter in pillar[key] %}
- - {{ parameter }}
- {%- endfor -%}
- {%- elif pillar[key] is mapping and pillar[key] is not string %}
- - {{ key }}:
- {%- for parameter in pillar[key] %}
- {{ parameter }}: {{pillar[key][parameter]}}
- {%- endfor %}
- {%- else %}
- # Error in rendering {{ key }}, please read https://docs.saltstack.com/en/latest/topics/development/external_pillars.html#configuration
- {% endif %}
- {%- endfor -%}
- {%- endfor %}
- {% elif 'ext_pillar' in cfg_salt %}
- ext_pillar:
- {% for pillar in cfg_salt['ext_pillar'] %}
- - {{ pillar.items()[0][0] }}: {{ pillar.items()[0][1] }}
- {% endfor %}
- {% else %}
- #ext_pillar:
- # - hiera: /etc/hiera.yaml
- # - cmd_yaml: cat /etc/salt/yaml
- {% endif %}
-
- # The ext_pillar_first option allows for external pillar sources to populate
- # before file system pillar. This allows for targeting file system pillar from
- # ext_pillar.
- {{ get_config('ext_pillar_first', 'False') }}
-
- # The pillar_gitfs_ssl_verify option specifies whether to ignore ssl certificate
- # errors when contacting the pillar gitfs backend. You might want to set this to
- # false if you're using a git backend that uses a self-signed certificate but
- # keep in mind that setting this flag to anything other than the default of True
- # is a security concern, you may want to try using the ssh transport.
- {{ get_config('pillar_gitfs_ssl_verify', 'True') }}
-
- # The pillar_opts option adds the master configuration file data to a dict in
- # the pillar called "master". This is used to set simple configurations in the
- # master config file that can then be used on minions.
- {{ get_config('pillar_opts', 'True') }}
-
- # The pillar_safe_render_error option prevents the master from passing pillar
- # render errors to the minion. This is set on by default because the error could
- # contain templating data which would give that minion information it shouldn't
- # have, like a password! When set true the error message will only show:
- # Rendering SLS 'my.sls' failed. Please see master log for details.
- {{ get_config('pillar_safe_render_error', 'True') }}
-
- # The pillar_source_merging_strategy option allows you to configure merging strategy
- # between different sources. It accepts four values: recurse, aggregate, overwrite,
- # or smart. Recurse will merge recursively mapping of data. Aggregate instructs
- # aggregation of elements between sources that use the #!yamlex renderer. Overwrite
- # will verwrite elements according the order in which they are processed. This is
- # behavior of the 2014.1 branch and earlier. Smart guesses the best strategy based
- # on the "renderer" setting and is the default value.
- {{ get_config('pillar_source_merging_strategy', 'smart') }}
-
- # Recursively merge lists by aggregating them instead of replacing them.
- {{ get_config('pillar_merge_lists', False) }}
-
- # Git External Pillar (git_pillar) Configuration Options
- #
- # Specify the provider to be used for git_pillar. Must be either pygit2 or
- # gitpython. If unset, then both will be tried in that same order, and the
- # first one with a compatible version installed will be the provider that
- # is used.
- {{ get_config('git_pillar_provider', 'pygit2') }}
-
- # If the desired branch matches this value, and the environment is omitted
- # from the git_pillar configuration, then the environment for that git_pillar
- # remote will be base.
- {{ get_config('git_pillar_base', 'master') }}
-
- # If the branch is omitted from a git_pillar remote, then this branch will
- # be used instead.
- {{ get_config('git_pillar_branch', 'master') }}
-
- # Environment to use for git_pillar remotes. This is normally derived from
- # the branch/tag (or from a per-remote env parameter), but if set this will
- # override the process of deriving the env from the branch/tag name.
- {{ get_config('git_pillar_env', '') }}
-
- # Path relative to the root of the repository where the git_pillar top file
- # and SLS files are located.
- {{ get_config('git_pillar_root', 'pillar') }}
-
- # Specifies whether or not to ignore SSL certificate errors when contacting
- # the remote repository.
- {{ get_config('git_pillar_ssl_verify', True) }}
-
- # When set to False, if there is an update/checkout lock for a git_pillar
- # remote and the pid written to it is not running on the master, the lock
- # file will be automatically cleared and a new lock will be obtained.
- {{ get_config('git_pillar_global_lock', False) }}
-
- # Git External Pillar Authentication Options
- #
- # Along with git_pillar_password, is used to authenticate to HTTPS remotes.
- {{ get_config('git_pillar_user', '') }}
-
- # Along with git_pillar_user, is used to authenticate to HTTPS remotes.
- # This parameter is not required if the repository does not use authentication.
- {{ get_config('git_pillar_password', '') }}
-
- # By default, Salt will not authenticate to an HTTP (non-HTTPS) remote.
- # This parameter enables authentication over HTTP.
- {{ get_config('git_pillar_insecure_auth', False) }}
-
- # Along with git_pillar_privkey (and optionally git_pillar_passphrase),
- # is used to authenticate to SSH remotes.
- {{ get_config('git_pillar_pubkey', '') }}
-
- # Along with git_pillar_pubkey (and optionally git_pillar_passphrase),
- # is used to authenticate to SSH remotes.
- {{ get_config('git_pillar_privkey', '') }}
-
- # This parameter is optional, required only when the SSH key being used
- # to authenticate is protected by a passphrase.
- {{ get_config('git_pillar_passphrase', '') }}
-
-
- ###### Security settings #####
- ###########################################
- # Enable "open mode", this mode still maintains encryption, but turns off
- # authentication, this is only intended for highly secure environments or for
- # the situation where your keys end up in a bad state. If you run in open mode
- # you do so at your own risk!
- {{ get_config('open_mode', 'False') }}
-
- # Enable permissive access to the salt keys. This allows you to run the
- # master or minion as root, but have a non-root group be given access to
- # your pki_dir. To make the access explicit, root must belong to the group
- # you've given access to. This is potentially quite insecure.
- {{ get_config('permissive_pki_access', 'False') }}
-
- # The state_verbose and state_output settings can be used to change the way
- # state system data is printed to the display. By default all data is printed.
- # The state_verbose setting can be set to True or False, when set to False
- # all data that has a result of True and no changes will be suppressed.
- {{ get_config('state_verbose', 'True') }}
-
- # The state_output setting changes if the output is the full multi line
- # output for each changed state if set to 'full', but if set to 'terse'
- # the output will be shortened to a single line.
- {{ get_config('state_output', 'full') }}
-
- # The state_output_diff setting changes whether or not the output from
- # successful states is returned. Useful when even the terse output of these
- # states is cluttering the logs. Set it to True to ignore them.
- {{ get_config('state_output_diff', 'False') }}
-
- # The state_output_profile setting changes whether profile information
- # will be shown for each state run.
- {{ get_config('state_output_profile', 'True') }}
-
- # Fingerprint of the master public key to validate the identity of your Salt master
- # before the initial key exchange. The master fingerprint can be found by running
- # "salt-key -F master" on the Salt master.
- {{ get_config('master_finger', "''") }}
-
-
- ###### Thread settings #####
- ###########################################
- # Disable multiprocessing support, by default when a minion receives a
- # publication a new process is spawned and the command is executed therein.
- {{ get_config('multiprocessing', 'True') }}
-
-
- ##### Logging settings #####
- ##########################################
- # The location of the minion log file
- # The minion log can be sent to a regular file, local path name, or network
- # location. Remote logging works best when configured to use rsyslogd(8) (e.g.:
- # ``file:///dev/log``), with rsyslogd(8) configured for network logging. The URI
- # format is: <file|udp|tcp>://<host|socketpath>:<port-if-required>/<log-facility>
- #log_file: /var/log/salt/minion
- #log_file: file:///dev/log
- #log_file: udp://loghost:10514
- #
- {{ get_config('log_file', '/var/log/salt/minion') }}
- {{ get_config('key_logfile', ' /var/log/salt/key') }}
-
- # The level of messages to send to the console.
- # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
- #
- # The following log levels are considered INSECURE and may log sensitive data:
- # ['garbage', 'trace', 'debug']
- #
- # Default: 'warning'
- {{ get_config('log_level', 'warning') }}
-
- # The level of messages to send to the log file.
- # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
- # If using 'log_granular_levels' this must be set to the highest desired level.
- # Default: 'warning'
- {{ get_config('log_level_logfile', '') }}
-
- # The date and time format used in log messages. Allowed date/time formating
- # can be seen here: http://docs.python.org/library/time.html#time.strftime
- {{ get_config('log_datefmt', "'%H:%M:%S'") }}
- {{ get_config('log_datefmt_logfile', "'%Y-%m-%d %H:%M:%S'") }}
-
- # The format of the console logging messages. Allowed formatting options can
- # be seen here: http://docs.python.org/library/logging.html#logrecord-attributes
- #
- # Console log colors are specified by these additional formatters:
- #
- # %(colorlevel)s
- # %(colorname)s
- # %(colorprocess)s
- # %(colormsg)s
- #
- # Since it is desirable to include the surrounding brackets, '[' and ']', in
- # the coloring of the messages, these color formatters also include padding as
- # well. Color LogRecord attributes are only available for console logging.
- #
- {{ get_config('log_fmt_console', "'%(colorlevel)s %(colormsg)s'") }}
- {{ get_config('log_fmt_console', "'[%(levelname)-8s] %(message)s'") }}
- #
- {{ get_config('log_fmt_logfile', "'%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'") }}
-
- # This can be used to control logging levels more specificically. This
- # example sets the main salt library at the 'warning' level, but sets
- # 'salt.modules' to log at the 'debug' level:
- # log_granular_levels:
- # 'salt': 'warning'
- # 'salt.modules': 'debug'
- #
- {{ get_config('log_granular_levels', '{}') }}
-
- # To diagnose issues with minions disconnecting or missing returns, ZeroMQ
- # supports the use of monitor sockets to log connection events. This
- # feature requires ZeroMQ 4.0 or higher.
- #
- # To enable ZeroMQ monitor sockets, set 'zmq_monitor' to 'True' and log at a
- # debug level or higher.
- #
- # A sample log event is as follows:
- #
- # [DEBUG ] ZeroMQ event: {'endpoint': 'tcp://127.0.0.1:4505', 'event': 512,
- # 'value': 27, 'description': 'EVENT_DISCONNECTED'}
- #
- # All events logged will include the string 'ZeroMQ event'. A connection event
- # should be logged as the minion starts up and initially connects to the
- # master. If not, check for debug log level and that the necessary version of
- # ZeroMQ is installed.
- #
- {{ get_config('zmq_monitor', 'False') }}
-
- ###### Module configuration #####
- ###########################################
- # Salt allows for modules to be passed arbitrary configuration data, any data
- # passed here in valid yaml format will be passed on to the salt minion modules
- # for use. It is STRONGLY recommended that a naming convention be used in which
- # the module name is followed by a . and then the value. Also, all top level
- # data must be applied via the yaml dict construct, some examples:
- #
- # You can specify that all modules should run in test mode:
- {{ get_config('test', 'True') }}
-
- # A simple value for the test module:
- #test.foo: foo
- #
- # A list for the test module:
- #test.bar: [baz,quo]
- #
- # A dict for the test module:
- #test.baz: {spam: sausage, cheese: bread}
- #
- #
- ###### Update settings ######
- ###########################################
- # Using the features in Esky, a salt minion can both run as a frozen app and
- # be updated on the fly. These options control how the update process
- # (saltutil.update()) behaves.
- #
- # The url for finding and downloading updates. Disabled by default.
- {{ get_config('update_url', 'False') }}
- #
- # The list of services to restart after a successful update. Empty by default.
- {{ get_config('update_restart_services', '[]') }}
-
-
- ###### Keepalive settings ######
- ############################################
- # ZeroMQ now includes support for configuring SO_KEEPALIVE if supported by
- # the OS. If connections between the minion and the master pass through
- # a state tracking device such as a firewall or VPN gateway, there is
- # the risk that it could tear down the connection the master and minion
- # without informing either party that their connection has been taken away.
- # Enabling TCP Keepalives prevents this from happening.
-
- # Overall state of TCP Keepalives, enable (1 or True), disable (0 or False)
- # or leave to the OS defaults (-1), on Linux, typically disabled. Default True, enabled.
- {{ get_config('tcp_keepalive', 'True') }}
-
- # How long before the first keepalive should be sent in seconds. Default 300
- # to send the first keepalive after 5 minutes, OS default (-1) is typically 7200 seconds
- # on Linux see /proc/sys/net/ipv4/tcp_keepalive_time.
- {{ get_config('tcp_keepalive_idle', '300') }}
-
- # How many lost probes are needed to consider the connection lost. Default -1
- # to use OS defaults, typically 9 on Linux, see /proc/sys/net/ipv4/tcp_keepalive_probes.
- {{ get_config('tcp_keepalive_cnt', '-1') }}
-
- # How often, in seconds, to send keepalives after the first one. Default -1 to
- # use OS defaults, typically 75 seconds on Linux, see
- # /proc/sys/net/ipv4/tcp_keepalive_intvl.
- {{ get_config('tcp_keepalive_intvl', '-1') }}
-
- ###### Windows Software settings ######
- ############################################
- # Location of the repository cache file on the master:
- {{ get_config('win_repo_cachefile', 'salt://win/repo/winrepo.p') }}
-
- ###### Returner settings ######
- ############################################
- # Which returner(s) will be used for minion's result:
- {{ get_config('return', '') }}
-
- ###### Miscellaneous settings ######
- ############################################
- # Default match type for filtering events tags: startswith, endswith, find, regex, fnmatch
- #event_match_type: startswith
- {{ get_config('event_match_type', 'startswith') }}
|