2011-03-29 04:59:54 +00:00
|
|
|
##### Primary configuration settings #####
|
|
|
|
##########################################
|
2014-09-26 21:15:40 +00:00
|
|
|
# This configuration file is used to manage the behavior of the Salt Master.
|
2015-03-24 18:10:01 +00:00
|
|
|
# Values that are commented out but have an empty line after the comment are
|
2015-03-24 20:53:18 +00:00
|
|
|
# defaults that do not need to be set in the config. If there is no blank line
|
|
|
|
# after the comment then the value is presented as an example and is not the
|
|
|
|
# default.
|
2013-02-12 02:40:00 +00:00
|
|
|
|
|
|
|
# Per default, the master will automatically include all config files
|
2012-07-26 01:42:20 +00:00
|
|
|
# from master.d/*.conf (master.d is a directory in the same directory
|
2014-09-26 21:15:40 +00:00
|
|
|
# as the main master config file).
|
2012-07-26 01:42:20 +00:00
|
|
|
#default_include: master.d/*.conf
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# The address of the interface to bind to:
|
2011-03-05 03:27:32 +00:00
|
|
|
#interface: 0.0.0.0
|
2011-03-29 05:34:54 +00:00
|
|
|
|
2013-06-17 23:33:06 +00:00
|
|
|
# Whether the master should listen for IPv6 connections. If this is set to True,
|
2014-09-26 21:15:40 +00:00
|
|
|
# the interface option must be adjusted, too. (For example: "interface: '::'")
|
2013-06-17 23:33:06 +00:00
|
|
|
#ipv6: False
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# The tcp port used by the publisher:
|
2011-03-05 03:27:32 +00:00
|
|
|
#publish_port: 4505
|
2011-03-29 05:34:54 +00:00
|
|
|
|
2014-02-14 21:52:19 +00:00
|
|
|
# The user under which the salt master will run. Salt will update all
|
|
|
|
# permissions to allow the specified user to run the master. The exception is
|
2014-09-26 21:15:40 +00:00
|
|
|
# the job cache, which must be deleted if this user is changed. If the
|
|
|
|
# modified files cause conflicts, set verify_env to False.
|
2012-01-18 20:29:38 +00:00
|
|
|
#user: root
|
|
|
|
|
2012-09-24 17:43:33 +00:00
|
|
|
# The port used by the communication interface. The ret (return) port is the
|
2014-09-26 21:15:40 +00:00
|
|
|
# interface used for the file server, authentication, job returns, etc.
|
2011-03-05 03:27:32 +00:00
|
|
|
#ret_port: 4506
|
2011-03-29 05:34:54 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Specify the location of the daemon process ID file:
|
2012-09-24 00:05:45 +00:00
|
|
|
#pidfile: /var/run/salt-master.pid
|
|
|
|
|
2012-01-13 04:09:12 +00:00
|
|
|
# The root directory prepended to these options: pki_dir, cachedir,
|
2013-11-21 23:12:10 +00:00
|
|
|
# sock_dir, log_file, autosign_file, autoreject_file, extension_modules,
|
2014-09-26 21:15:40 +00:00
|
|
|
# key_logfile, pidfile:
|
2011-06-21 01:29:26 +00:00
|
|
|
#root_dir: /
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Directory used to store public key data:
|
2012-11-19 21:37:15 +00:00
|
|
|
#pki_dir: /etc/salt/pki/master
|
2011-03-29 05:34:54 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Directory to store job and cache data:
|
2015-04-03 23:17:06 +00:00
|
|
|
# This directory may contain sensitive data and should be protected accordingly.
|
2016-03-01 15:35:34 +00:00
|
|
|
#
|
2012-11-19 21:37:15 +00:00
|
|
|
#cachedir: /var/cache/salt/master
|
2011-03-29 05:34:54 +00:00
|
|
|
|
2014-03-07 23:11:00 +00:00
|
|
|
# Directory for custom modules. This directory can contain subdirectories for
|
|
|
|
# each of Salt's module types such as "runners", "output", "wheel", "modules",
|
|
|
|
# "states", "returners", etc.
|
|
|
|
#extension_modules: <no default>
|
|
|
|
|
2015-05-04 16:53:50 +00:00
|
|
|
# Directory for custom modules. This directory can contain subdirectories for
|
|
|
|
# each of Salt's module types such as "runners", "output", "wheel", "modules",
|
|
|
|
# "states", "returners", etc.
|
|
|
|
# Like 'extension_modules' but can take an array of paths
|
|
|
|
#module_dirs: <no default>
|
|
|
|
# - /var/cache/salt/minion/extmods
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Verify and set permissions on configuration directories at startup:
|
2012-09-24 00:28:49 +00:00
|
|
|
#verify_env: True
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Set the number of hours to keep old job information in the job cache:
|
2011-03-25 03:59:01 +00:00
|
|
|
#keep_jobs: 24
|
2011-03-29 04:59:54 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Set the default timeout for the salt command and api. The default is 5
|
|
|
|
# seconds.
|
2012-02-06 05:54:24 +00:00
|
|
|
#timeout: 5
|
|
|
|
|
2014-02-03 20:12:21 +00:00
|
|
|
# The loop_interval option controls the seconds for the master's maintenance
|
2013-01-14 08:21:28 +00:00
|
|
|
# process check cycle. This process updates file server backends, cleans the
|
|
|
|
# job cache and executes the scheduler.
|
|
|
|
#loop_interval: 60
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Set the default outputter used by the salt command. The default is "nested".
|
2013-01-11 01:12:11 +00:00
|
|
|
#output: nested
|
|
|
|
|
2014-08-07 14:12:47 +00:00
|
|
|
# Return minions that timeout when running commands like test.ping
|
|
|
|
#show_timeout: True
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# By default, output is colored. To disable colored output, set the color value
|
|
|
|
# to False.
|
2013-01-11 01:15:05 +00:00
|
|
|
#color: True
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Do not strip off the colored output from nested results and state outputs
|
|
|
|
# (true by default).
|
2014-09-26 21:38:49 +00:00
|
|
|
# strip_colors: False
|
2014-06-20 07:48:20 +00:00
|
|
|
|
[develop] Merge forward from 2016.3 to develop (#32494)
* fix sorting by latest version when called with an attribute
* remove reference to master_alive_check
* Fixes saltstack/salt#28262
* Resolve memory leak in authentication
* outputter virt_list does not exist anymore
* Update proxmox documentation
* Fix documentation on boto_asg and boto_elb modules and states
* modules.win_timezone: don't list all zones in debug log
* Correcty index glusterfs bricks
Fixes issue #32311
* Cleaner deprecation process with decorators
* Add deprecation decorator scaffold
* Capture type error and unhandled exceptions while function calls
* Aware of the current and future version of deprecation
* Implement initially is_deprecated decorator
* Add an alias for the capitalization
* Fix capitalization easier way
* Remove an extra line
* Add successor name to the deprecation decorator.
* Granulate logging and error messages.
* Implement function swapper
* Raise later the caught exception
* Clarify exception message
* Save function original name
* Remove an extra line
* Hide an alternative hidden function name in the error message, preserving the error itself
* Rename variable as private
* Add a method to detect if a function is using its previous version
* Message to the log and/or raise an exception accordingly to the status of used function
* Log an error along with the exception
* Add internal method documentation
* Add documentation and usage process for decorator "is_deprecated"
* Add documentation and process usage for the decorator "with_deprecated"
* Hide private method name
* Fix PEP8, re-word the error message
* Deprecate basic uptime function
* Add initial decorator unit test
* Rename old/new functions, mock versions
* Move frequent data to the test setup
* Add logging on EOL exception
* Rename and document high to low version test on is_deprecated
* Implement a test on low to high version of is_deprecated decorator
* Add a correction to the test description
* Remove a dead code
* Implement a test for high to low version on is_deprecated, using with_successor param
* Correct typso adn mistaeks
* Implement high to low version with successor param on is_deprecated
* Setup a virtual name for the module
* Implement test for with_deprecated should raise an exception if same deprecated function not found
* Implement test for with_deprecated an old function is picked up if configured
* Correct test description purpose
* Implement test with_deprecated when no deprecation is requested
* Add logging test to the configured deprecation request
* Add logging testing when deprecated version wasn't requested
* Implement test EOL for with_deprecated decorator
* Correct test explanation
* Rename the test
* Implement with_deprecated no EOL, deprecated other function name
* Implement with_deprecated, deprecated other function name, EOL reached
* Add test description for the with_deprecated + with_name + EOL
* Fix confusing test names
* Add logging test to the is_deprecated decorator when function as not found.
* Add more test point to each test, remove empty lines
* Bugfix: at certain conditions a wrong alias name is reported to the log
* Fix a typo in a comment
* Add test for the logging
* Disable a pylint: None will _never_ be raised
* Fix test for the deprecated "status.uptime" version
* Bugfix: Do not yank raised exceptions
* Remove unnecessary decorator
* Add test for the new uptime
* Add test for the new uptime fails when /proc/uptime does not exists
* Rename old test case
* Skip test for the UTC time, unless freeze time is used.
* Fix pylint
* Fix documentation
* Bugfix: proxy-pass the docstring of the decorated function
* Lint fix
* Fixes saltstack/salt#28262 for 2015.5 branch
* Update master config docs
* Improve git_pillar documentation/logging
* Add note about different behavior of top file in git_pillar
* Make log entry for a missing pillar SLS file more accurate for git_pillar
* FreeBSD supports packages in format java/openjdk7 so the prior commit broke that functionality. Check freebsd/pkg#1409 for more info.
* FreeBSD supports packages in format java/openjdk7 so the prior commit broke that functionality. Check freebsd/pkg#1409 for more info.
* Update glusterfs_test to be inline with #32312
* Fix salt-cloud paralell provisioning
Closes #31632
* Ignore Raspbian in service.py __virtual__ (#32421)
* Ignore Raspbian in service.py __virtual__
This prevents more than one execution module from trying to load as the
service virtual module.
Refs: #32413
* pack __salt__ before loading provider overrides
We can (and should) pack here since we're just packing a reference to the
object. __salt__ needs to be available when we're loading our provider
overrides
* Fix broken __salt__ dict in provider override
Using ret.items() here sets ``__salt__`` to its items (tuple containing
function name and reference), breaking usage of ``__salt__`` inside
overridden functions.
* Merge #32293 with test fixes (#32418)
* Fix issue #11497
* Remove check for working directory presence in tests
* Fix Domainname introspection
Default value needs to be extracted from the container itself,
because dockerd set Domainname value when network_mode=host.
* Add pgjsonb_queue to queue doc index
* Pylint fixes
* Pass parser options into batch mode
Resolves #31738
* Changed the target file in file.symlink test (#32443)
* Argument name in docs should match actual arg name (#32445)
Fixes #31851
* tests.integration: bypass MacOS TMPDIR, gettempdir (#32447)
Updates 0edd532, 8f558a5.
When logging in as root over `ssh root@host`, `$TMPDIR` and
`tempfile.gettempdir()` are both set to a variation of:
```
/private/var/folders/zz/zyxvpxvq6csfxvn_n0000000000000/T/
```
When logging in as root over `sudo -i`, `$TMPDIR` is unset and
`tempfile.gettempdir()` is set to `/tmp`.
My guess is that the second case is an unintended or uncorrected omision
by Apple as they have introduced the longer, randomized temp path in a
recent version of MacOS.
* Issue #28706: Fix state user.present behavior. (#32448)
- As mentionned in issue #28706, state user.present no longer remove
user from groups if the keyword 'groups' with empty value '[]' is not
explicitly set, salt will assume current groups are still wanted.
* tests.integration: fix 4230c8a
* Move the tables of virtual modules to individual documentation pages
* Add new doc pages to toctree
* Add external ref to windows package manager docs
* Improve docstrings
* Add documentation on virtual module provider overrides to the module docs
* Clarify the scope of the provider param in states.
* Add link to provider override docs to all package providers
* Add link to provider override docs to all service providers
* Add link to provider override docs to all user providers
* dd link to provider override docs to all shadow providers
* Add link to provider override docs to all group providers
* Backport 31164 and 31364 (#32474)
* Don't send REQ while another one is waiting for response.
The message has to be removed from the queue the only *after* it's
already processed to don't confuse send() functionality that expects
empty queue means: there's no active sendings.
* Fixed zeromq ReqMessageClient destroy
* Add link to provider override docs to opkg.py
This is a companion to https://github.com/saltstack/salt/pull/32458, but
this module was not added until the 2016.3 branch, so the documentation
is being updated there for this module.
* Add documentation for some master/minion configs (#32454)
Refs #32400
Adds docs for:
- cli_summary
- event_return_queue
- event_return_whitelist
- event_return_blacklist
- file_recv_max_size
- fileserver_followsymlinks
- fileserver_ignoresymlinks
- fileserver_limit_traversal
* Automatically detect correct MySQL password column for 5.7 and fix setting passwords (#32440)
* Automatically detect MySQL password column
* Fix changing password in MySQL 5.7
* Fix lint test
* Fix unit tests (?)
They will still fail if "authentication_string" is legitimately the right column name, but I don't know what to do about that.
* Additional unit test fix
* Only unsub if we have a jid
Closes #32479
2016-04-11 23:07:15 +00:00
|
|
|
# To display a summary of the number of minions targeted, the number of
|
|
|
|
# minions returned, and the number of minions that did not return, set the
|
|
|
|
# cli_summary value to True. (False by default.)
|
|
|
|
#
|
|
|
|
#cli_summary: False
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Set the directory used to hold unix sockets:
|
2012-11-19 21:37:15 +00:00
|
|
|
#sock_dir: /var/run/salt/master
|
2011-03-29 04:59:54 +00:00
|
|
|
|
2013-10-21 21:20:47 +00:00
|
|
|
# The master can take a while to start up when lspci and/or dmidecode is used
|
|
|
|
# to populate the grains for the master. Enable if you want to see GPU hardware
|
|
|
|
# data for your master.
|
|
|
|
# enable_gpu_grains: False
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# The master maintains a job cache. While this is a great addition, it can be
|
2012-06-13 21:42:26 +00:00
|
|
|
# a burden on the master for larger deployments (over 5000 minions).
|
|
|
|
# Disabling the job cache will make previously executed jobs unavailable to
|
|
|
|
# the jobs system and is not generally recommended.
|
|
|
|
#job_cache: True
|
|
|
|
|
2012-09-24 00:05:45 +00:00
|
|
|
# Cache minion grains and pillar data in the cachedir.
|
|
|
|
#minion_data_cache: True
|
|
|
|
|
2014-11-26 22:30:47 +00:00
|
|
|
# Store all returns in the given returner.
|
2016-03-01 15:35:34 +00:00
|
|
|
# Setting this option requires that any returner-specific configuration also
|
2014-11-26 22:30:47 +00:00
|
|
|
# be set. See various returners in salt/returners for details on required
|
2014-12-01 18:46:27 +00:00
|
|
|
# configuration values. (See also, event_return_queue below.)
|
2014-11-26 22:30:47 +00:00
|
|
|
#
|
2014-11-26 23:31:44 +00:00
|
|
|
#event_return: mysql
|
2014-11-26 22:30:47 +00:00
|
|
|
|
2014-12-01 18:46:27 +00:00
|
|
|
# On busy systems, enabling event_returns can cause a considerable load on
|
|
|
|
# the storage system for returners. Events can be queued on the master and
|
|
|
|
# stored in a batched fashion using a single transaction for multiple events.
|
|
|
|
# By default, events are not queued.
|
|
|
|
#event_return_queue: 0
|
|
|
|
|
[develop] Merge forward from 2016.3 to develop (#32494)
* fix sorting by latest version when called with an attribute
* remove reference to master_alive_check
* Fixes saltstack/salt#28262
* Resolve memory leak in authentication
* outputter virt_list does not exist anymore
* Update proxmox documentation
* Fix documentation on boto_asg and boto_elb modules and states
* modules.win_timezone: don't list all zones in debug log
* Correcty index glusterfs bricks
Fixes issue #32311
* Cleaner deprecation process with decorators
* Add deprecation decorator scaffold
* Capture type error and unhandled exceptions while function calls
* Aware of the current and future version of deprecation
* Implement initially is_deprecated decorator
* Add an alias for the capitalization
* Fix capitalization easier way
* Remove an extra line
* Add successor name to the deprecation decorator.
* Granulate logging and error messages.
* Implement function swapper
* Raise later the caught exception
* Clarify exception message
* Save function original name
* Remove an extra line
* Hide an alternative hidden function name in the error message, preserving the error itself
* Rename variable as private
* Add a method to detect if a function is using its previous version
* Message to the log and/or raise an exception accordingly to the status of used function
* Log an error along with the exception
* Add internal method documentation
* Add documentation and usage process for decorator "is_deprecated"
* Add documentation and process usage for the decorator "with_deprecated"
* Hide private method name
* Fix PEP8, re-word the error message
* Deprecate basic uptime function
* Add initial decorator unit test
* Rename old/new functions, mock versions
* Move frequent data to the test setup
* Add logging on EOL exception
* Rename and document high to low version test on is_deprecated
* Implement a test on low to high version of is_deprecated decorator
* Add a correction to the test description
* Remove a dead code
* Implement a test for high to low version on is_deprecated, using with_successor param
* Correct typso adn mistaeks
* Implement high to low version with successor param on is_deprecated
* Setup a virtual name for the module
* Implement test for with_deprecated should raise an exception if same deprecated function not found
* Implement test for with_deprecated an old function is picked up if configured
* Correct test description purpose
* Implement test with_deprecated when no deprecation is requested
* Add logging test to the configured deprecation request
* Add logging testing when deprecated version wasn't requested
* Implement test EOL for with_deprecated decorator
* Correct test explanation
* Rename the test
* Implement with_deprecated no EOL, deprecated other function name
* Implement with_deprecated, deprecated other function name, EOL reached
* Add test description for the with_deprecated + with_name + EOL
* Fix confusing test names
* Add logging test to the is_deprecated decorator when function as not found.
* Add more test point to each test, remove empty lines
* Bugfix: at certain conditions a wrong alias name is reported to the log
* Fix a typo in a comment
* Add test for the logging
* Disable a pylint: None will _never_ be raised
* Fix test for the deprecated "status.uptime" version
* Bugfix: Do not yank raised exceptions
* Remove unnecessary decorator
* Add test for the new uptime
* Add test for the new uptime fails when /proc/uptime does not exists
* Rename old test case
* Skip test for the UTC time, unless freeze time is used.
* Fix pylint
* Fix documentation
* Bugfix: proxy-pass the docstring of the decorated function
* Lint fix
* Fixes saltstack/salt#28262 for 2015.5 branch
* Update master config docs
* Improve git_pillar documentation/logging
* Add note about different behavior of top file in git_pillar
* Make log entry for a missing pillar SLS file more accurate for git_pillar
* FreeBSD supports packages in format java/openjdk7 so the prior commit broke that functionality. Check freebsd/pkg#1409 for more info.
* FreeBSD supports packages in format java/openjdk7 so the prior commit broke that functionality. Check freebsd/pkg#1409 for more info.
* Update glusterfs_test to be inline with #32312
* Fix salt-cloud paralell provisioning
Closes #31632
* Ignore Raspbian in service.py __virtual__ (#32421)
* Ignore Raspbian in service.py __virtual__
This prevents more than one execution module from trying to load as the
service virtual module.
Refs: #32413
* pack __salt__ before loading provider overrides
We can (and should) pack here since we're just packing a reference to the
object. __salt__ needs to be available when we're loading our provider
overrides
* Fix broken __salt__ dict in provider override
Using ret.items() here sets ``__salt__`` to its items (tuple containing
function name and reference), breaking usage of ``__salt__`` inside
overridden functions.
* Merge #32293 with test fixes (#32418)
* Fix issue #11497
* Remove check for working directory presence in tests
* Fix Domainname introspection
Default value needs to be extracted from the container itself,
because dockerd set Domainname value when network_mode=host.
* Add pgjsonb_queue to queue doc index
* Pylint fixes
* Pass parser options into batch mode
Resolves #31738
* Changed the target file in file.symlink test (#32443)
* Argument name in docs should match actual arg name (#32445)
Fixes #31851
* tests.integration: bypass MacOS TMPDIR, gettempdir (#32447)
Updates 0edd532, 8f558a5.
When logging in as root over `ssh root@host`, `$TMPDIR` and
`tempfile.gettempdir()` are both set to a variation of:
```
/private/var/folders/zz/zyxvpxvq6csfxvn_n0000000000000/T/
```
When logging in as root over `sudo -i`, `$TMPDIR` is unset and
`tempfile.gettempdir()` is set to `/tmp`.
My guess is that the second case is an unintended or uncorrected omision
by Apple as they have introduced the longer, randomized temp path in a
recent version of MacOS.
* Issue #28706: Fix state user.present behavior. (#32448)
- As mentionned in issue #28706, state user.present no longer remove
user from groups if the keyword 'groups' with empty value '[]' is not
explicitly set, salt will assume current groups are still wanted.
* tests.integration: fix 4230c8a
* Move the tables of virtual modules to individual documentation pages
* Add new doc pages to toctree
* Add external ref to windows package manager docs
* Improve docstrings
* Add documentation on virtual module provider overrides to the module docs
* Clarify the scope of the provider param in states.
* Add link to provider override docs to all package providers
* Add link to provider override docs to all service providers
* Add link to provider override docs to all user providers
* dd link to provider override docs to all shadow providers
* Add link to provider override docs to all group providers
* Backport 31164 and 31364 (#32474)
* Don't send REQ while another one is waiting for response.
The message has to be removed from the queue the only *after* it's
already processed to don't confuse send() functionality that expects
empty queue means: there's no active sendings.
* Fixed zeromq ReqMessageClient destroy
* Add link to provider override docs to opkg.py
This is a companion to https://github.com/saltstack/salt/pull/32458, but
this module was not added until the 2016.3 branch, so the documentation
is being updated there for this module.
* Add documentation for some master/minion configs (#32454)
Refs #32400
Adds docs for:
- cli_summary
- event_return_queue
- event_return_whitelist
- event_return_blacklist
- file_recv_max_size
- fileserver_followsymlinks
- fileserver_ignoresymlinks
- fileserver_limit_traversal
* Automatically detect correct MySQL password column for 5.7 and fix setting passwords (#32440)
* Automatically detect MySQL password column
* Fix changing password in MySQL 5.7
* Fix lint test
* Fix unit tests (?)
They will still fail if "authentication_string" is legitimately the right column name, but I don't know what to do about that.
* Additional unit test fix
* Only unsub if we have a jid
Closes #32479
2016-04-11 23:07:15 +00:00
|
|
|
# Only return events matching tags in a whitelist,
|
2014-12-01 20:05:21 +00:00
|
|
|
# event_return_whitelist:
|
|
|
|
# - salt/master/a_tag
|
|
|
|
# - salt/master/another_tag
|
|
|
|
|
[develop] Merge forward from 2016.3 to develop (#32494)
* fix sorting by latest version when called with an attribute
* remove reference to master_alive_check
* Fixes saltstack/salt#28262
* Resolve memory leak in authentication
* outputter virt_list does not exist anymore
* Update proxmox documentation
* Fix documentation on boto_asg and boto_elb modules and states
* modules.win_timezone: don't list all zones in debug log
* Correcty index glusterfs bricks
Fixes issue #32311
* Cleaner deprecation process with decorators
* Add deprecation decorator scaffold
* Capture type error and unhandled exceptions while function calls
* Aware of the current and future version of deprecation
* Implement initially is_deprecated decorator
* Add an alias for the capitalization
* Fix capitalization easier way
* Remove an extra line
* Add successor name to the deprecation decorator.
* Granulate logging and error messages.
* Implement function swapper
* Raise later the caught exception
* Clarify exception message
* Save function original name
* Remove an extra line
* Hide an alternative hidden function name in the error message, preserving the error itself
* Rename variable as private
* Add a method to detect if a function is using its previous version
* Message to the log and/or raise an exception accordingly to the status of used function
* Log an error along with the exception
* Add internal method documentation
* Add documentation and usage process for decorator "is_deprecated"
* Add documentation and process usage for the decorator "with_deprecated"
* Hide private method name
* Fix PEP8, re-word the error message
* Deprecate basic uptime function
* Add initial decorator unit test
* Rename old/new functions, mock versions
* Move frequent data to the test setup
* Add logging on EOL exception
* Rename and document high to low version test on is_deprecated
* Implement a test on low to high version of is_deprecated decorator
* Add a correction to the test description
* Remove a dead code
* Implement a test for high to low version on is_deprecated, using with_successor param
* Correct typso adn mistaeks
* Implement high to low version with successor param on is_deprecated
* Setup a virtual name for the module
* Implement test for with_deprecated should raise an exception if same deprecated function not found
* Implement test for with_deprecated an old function is picked up if configured
* Correct test description purpose
* Implement test with_deprecated when no deprecation is requested
* Add logging test to the configured deprecation request
* Add logging testing when deprecated version wasn't requested
* Implement test EOL for with_deprecated decorator
* Correct test explanation
* Rename the test
* Implement with_deprecated no EOL, deprecated other function name
* Implement with_deprecated, deprecated other function name, EOL reached
* Add test description for the with_deprecated + with_name + EOL
* Fix confusing test names
* Add logging test to the is_deprecated decorator when function as not found.
* Add more test point to each test, remove empty lines
* Bugfix: at certain conditions a wrong alias name is reported to the log
* Fix a typo in a comment
* Add test for the logging
* Disable a pylint: None will _never_ be raised
* Fix test for the deprecated "status.uptime" version
* Bugfix: Do not yank raised exceptions
* Remove unnecessary decorator
* Add test for the new uptime
* Add test for the new uptime fails when /proc/uptime does not exists
* Rename old test case
* Skip test for the UTC time, unless freeze time is used.
* Fix pylint
* Fix documentation
* Bugfix: proxy-pass the docstring of the decorated function
* Lint fix
* Fixes saltstack/salt#28262 for 2015.5 branch
* Update master config docs
* Improve git_pillar documentation/logging
* Add note about different behavior of top file in git_pillar
* Make log entry for a missing pillar SLS file more accurate for git_pillar
* FreeBSD supports packages in format java/openjdk7 so the prior commit broke that functionality. Check freebsd/pkg#1409 for more info.
* FreeBSD supports packages in format java/openjdk7 so the prior commit broke that functionality. Check freebsd/pkg#1409 for more info.
* Update glusterfs_test to be inline with #32312
* Fix salt-cloud paralell provisioning
Closes #31632
* Ignore Raspbian in service.py __virtual__ (#32421)
* Ignore Raspbian in service.py __virtual__
This prevents more than one execution module from trying to load as the
service virtual module.
Refs: #32413
* pack __salt__ before loading provider overrides
We can (and should) pack here since we're just packing a reference to the
object. __salt__ needs to be available when we're loading our provider
overrides
* Fix broken __salt__ dict in provider override
Using ret.items() here sets ``__salt__`` to its items (tuple containing
function name and reference), breaking usage of ``__salt__`` inside
overridden functions.
* Merge #32293 with test fixes (#32418)
* Fix issue #11497
* Remove check for working directory presence in tests
* Fix Domainname introspection
Default value needs to be extracted from the container itself,
because dockerd set Domainname value when network_mode=host.
* Add pgjsonb_queue to queue doc index
* Pylint fixes
* Pass parser options into batch mode
Resolves #31738
* Changed the target file in file.symlink test (#32443)
* Argument name in docs should match actual arg name (#32445)
Fixes #31851
* tests.integration: bypass MacOS TMPDIR, gettempdir (#32447)
Updates 0edd532, 8f558a5.
When logging in as root over `ssh root@host`, `$TMPDIR` and
`tempfile.gettempdir()` are both set to a variation of:
```
/private/var/folders/zz/zyxvpxvq6csfxvn_n0000000000000/T/
```
When logging in as root over `sudo -i`, `$TMPDIR` is unset and
`tempfile.gettempdir()` is set to `/tmp`.
My guess is that the second case is an unintended or uncorrected omision
by Apple as they have introduced the longer, randomized temp path in a
recent version of MacOS.
* Issue #28706: Fix state user.present behavior. (#32448)
- As mentionned in issue #28706, state user.present no longer remove
user from groups if the keyword 'groups' with empty value '[]' is not
explicitly set, salt will assume current groups are still wanted.
* tests.integration: fix 4230c8a
* Move the tables of virtual modules to individual documentation pages
* Add new doc pages to toctree
* Add external ref to windows package manager docs
* Improve docstrings
* Add documentation on virtual module provider overrides to the module docs
* Clarify the scope of the provider param in states.
* Add link to provider override docs to all package providers
* Add link to provider override docs to all service providers
* Add link to provider override docs to all user providers
* dd link to provider override docs to all shadow providers
* Add link to provider override docs to all group providers
* Backport 31164 and 31364 (#32474)
* Don't send REQ while another one is waiting for response.
The message has to be removed from the queue the only *after* it's
already processed to don't confuse send() functionality that expects
empty queue means: there's no active sendings.
* Fixed zeromq ReqMessageClient destroy
* Add link to provider override docs to opkg.py
This is a companion to https://github.com/saltstack/salt/pull/32458, but
this module was not added until the 2016.3 branch, so the documentation
is being updated there for this module.
* Add documentation for some master/minion configs (#32454)
Refs #32400
Adds docs for:
- cli_summary
- event_return_queue
- event_return_whitelist
- event_return_blacklist
- file_recv_max_size
- fileserver_followsymlinks
- fileserver_ignoresymlinks
- fileserver_limit_traversal
* Automatically detect correct MySQL password column for 5.7 and fix setting passwords (#32440)
* Automatically detect MySQL password column
* Fix changing password in MySQL 5.7
* Fix lint test
* Fix unit tests (?)
They will still fail if "authentication_string" is legitimately the right column name, but I don't know what to do about that.
* Additional unit test fix
* Only unsub if we have a jid
Closes #32479
2016-04-11 23:07:15 +00:00
|
|
|
# Store all event returns _except_ the tags in a blacklist.
|
2014-12-01 20:05:21 +00:00
|
|
|
# event_return_blacklist:
|
|
|
|
# - salt/master/not_this_tag
|
|
|
|
# - salt/master/or_this_one
|
|
|
|
|
2014-04-22 22:13:45 +00:00
|
|
|
# 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
|
|
|
|
# master event bus. The value is expressed in bytes.
|
2014-04-29 21:37:25 +00:00
|
|
|
#max_event_size: 1048576
|
2014-04-22 22:13:45 +00:00
|
|
|
|
2014-09-17 20:38:42 +00:00
|
|
|
# By default, the master AES key rotates every 24 hours. The next command
|
|
|
|
# following a key rotation will trigger a key refresh from the minion which may
|
|
|
|
# result in minions which do not respond to the first command after a key refresh.
|
|
|
|
#
|
|
|
|
# To tell the master to ping all minions immediately after an AES key refresh, set
|
|
|
|
# ping_on_rotate to True. This should mitigate the issue where a minion does not
|
|
|
|
# appear to initially respond after a key is rotated.
|
2014-09-15 17:39:58 +00:00
|
|
|
#
|
2014-09-15 18:42:59 +00:00
|
|
|
# Note that ping_on_rotate may cause high load on the master immediately after
|
|
|
|
# the key rotation event as minions reconnect. Consider this carefully if this
|
|
|
|
# salt master is managing a large number of minions.
|
|
|
|
#
|
2016-03-01 15:35:34 +00:00
|
|
|
# If disabled, it is recommended to handle this event by listening for the
|
2014-09-15 17:39:58 +00:00
|
|
|
# 'aes_key_rotate' event with the 'key' tag and acting appropriately.
|
2014-09-17 20:38:42 +00:00
|
|
|
# ping_on_rotate: False
|
2014-09-26 21:15:40 +00:00
|
|
|
|
2014-10-03 17:43:33 +00:00
|
|
|
# By default, the master deletes its cache of minion data when the key for that
|
2016-03-01 15:35:34 +00:00
|
|
|
# minion is removed. To preserve the cache after key deletion, set
|
2014-10-03 17:43:33 +00:00
|
|
|
# 'preserve_minion_cache' to True.
|
|
|
|
#
|
|
|
|
# WARNING: This may have security implications if compromised minions auth with
|
|
|
|
# a previous deleted minion ID.
|
|
|
|
#preserve_minion_cache: False
|
|
|
|
|
2014-09-18 15:23:27 +00:00
|
|
|
# If max_minions is used in large installations, the master might experience
|
|
|
|
# high-load situations because of having to check the number of connected
|
|
|
|
# minions for every authentication. This cache provides the minion-ids of
|
|
|
|
# all connected minions to all MWorker-processes and greatly improves the
|
|
|
|
# performance of max_minions.
|
|
|
|
# con_cache: False
|
2014-09-26 21:15:40 +00:00
|
|
|
|
2012-07-26 01:42:20 +00:00
|
|
|
# The master 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 master 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
|
2014-09-26 21:15:40 +00:00
|
|
|
# option, then the master will log a warning message.
|
2012-07-26 01:42:20 +00:00
|
|
|
#
|
|
|
|
# Include a config file from some other path:
|
2014-12-04 03:12:13 +00:00
|
|
|
# include: /etc/salt/extra_config
|
2012-07-26 01:42:20 +00:00
|
|
|
#
|
|
|
|
# Include config from several files and directories:
|
2014-12-04 03:12:13 +00:00
|
|
|
# include:
|
|
|
|
# - /etc/salt/extra_config
|
2012-07-26 01:42:20 +00:00
|
|
|
|
|
|
|
|
2015-10-01 20:52:18 +00:00
|
|
|
##### Large-scale tuning settings #####
|
|
|
|
##########################################
|
|
|
|
# Max open files
|
|
|
|
#
|
|
|
|
# Each minion connecting to the master uses AT LEAST one file descriptor, the
|
|
|
|
# master subscription connection. If enough minions connect you might start
|
|
|
|
# seeing on the console (and then salt-master crashes):
|
|
|
|
# Too many open files (tcp_listener.cpp:335)
|
|
|
|
# Aborted (core dumped)
|
|
|
|
#
|
|
|
|
# By default this value will be the one of `ulimit -Hn`, ie, the hard limit for
|
|
|
|
# max open files.
|
|
|
|
#
|
|
|
|
# If you wish to set a different value than the default one, uncomment and
|
|
|
|
# configure this setting. Remember that this value CANNOT be higher than the
|
|
|
|
# hard limit. Raising the hard limit depends on your OS and/or distribution,
|
|
|
|
# a good way to find the limit is to search the internet. For example:
|
|
|
|
# raise max open files hard limit debian
|
|
|
|
#
|
|
|
|
#max_open_files: 100000
|
|
|
|
|
|
|
|
# The number of worker threads to start. These threads are used to manage
|
|
|
|
# return calls made from minions to the master. If the master seems to be
|
|
|
|
# running slowly, increase the number of threads. This setting can not be
|
|
|
|
# set lower than 3.
|
|
|
|
#worker_threads: 5
|
|
|
|
|
|
|
|
# Set the ZeroMQ high water marks
|
|
|
|
# http://api.zeromq.org/3-2:zmq-setsockopt
|
|
|
|
|
|
|
|
# The publisher interface ZeroMQPubServerChannel
|
|
|
|
#pub_hwm: 1000
|
|
|
|
|
|
|
|
# These two ZMQ HWM settings, salt_event_pub_hwm and event_publisher_pub_hwm
|
|
|
|
# are significant for masters with thousands of minions. When these are
|
|
|
|
# insufficiently high it will manifest in random responses missing in the CLI
|
|
|
|
# and even missing from the job cache. Masters that have fast CPUs and many
|
|
|
|
# cores with appropriate worker_threads will not need these set as high.
|
|
|
|
|
|
|
|
# On deployment with 8,000 minions, 2.4GHz CPUs, 24 cores, 32GiB memory has
|
|
|
|
# these settings:
|
|
|
|
#
|
|
|
|
# salt_event_pub_hwm: 128000
|
|
|
|
# event_publisher_pub_hwm: 64000
|
|
|
|
|
|
|
|
# ZMQ high-water-mark for SaltEvent pub socket
|
|
|
|
#salt_event_pub_hwm: 20000
|
|
|
|
|
|
|
|
# ZMQ high-water-mark for EventPublisher pub socket
|
|
|
|
#event_publisher_pub_hwm: 10000
|
|
|
|
|
|
|
|
|
|
|
|
|
2011-03-29 04:59:54 +00:00
|
|
|
##### Security settings #####
|
|
|
|
##########################################
|
2011-03-10 15:55:48 +00:00
|
|
|
# Enable "open mode", this mode still maintains encryption, but turns off
|
|
|
|
# authentication, this is only intended for highly secure environments or for
|
2011-11-27 00:15:43 +00:00
|
|
|
# the situation where your keys end up in a bad state. If you run in open mode
|
2011-03-10 15:55:48 +00:00
|
|
|
# you do so at your own risk!
|
|
|
|
#open_mode: False
|
2011-03-29 05:34:54 +00:00
|
|
|
|
2011-03-25 01:19:10 +00:00
|
|
|
# Enable auto_accept, this setting will automatically accept all incoming
|
2011-11-27 00:15:43 +00:00
|
|
|
# public keys from the minions. Note that this is insecure.
|
2011-03-25 01:19:10 +00:00
|
|
|
#auto_accept: False
|
2011-03-29 04:59:54 +00:00
|
|
|
|
2016-03-18 00:02:50 +00:00
|
|
|
# Time in minutes that an incoming public key with a matching name found in
|
2014-05-10 17:46:03 +00:00
|
|
|
# pki_dir/minion_autosign/keyid is automatically accepted. Expired autosign keys
|
|
|
|
# are removed when the master checks the minion_autosign directory.
|
|
|
|
# 0 equals no timeout
|
|
|
|
# autosign_timeout: 120
|
|
|
|
|
2013-11-21 23:12:10 +00:00
|
|
|
# If the autosign_file is specified, incoming keys specified in the
|
|
|
|
# autosign_file will be automatically accepted. This is insecure. Regular
|
|
|
|
# expressions as well as globing lines are supported.
|
|
|
|
#autosign_file: /etc/salt/autosign.conf
|
|
|
|
|
|
|
|
# Works like autosign_file, but instead allows you to specify minion IDs for
|
|
|
|
# which keys will automatically be rejected. Will override both membership in
|
|
|
|
# the autosign_file and the auto_accept setting.
|
2014-06-17 11:01:31 +00:00
|
|
|
#autoreject_file: /etc/salt/autoreject.conf
|
2012-07-26 06:31:20 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Enable permissive access to the salt keys. This allows you to run the
|
2012-07-24 21:55:15 +00:00
|
|
|
# master or minion as root, but have a non-root group be given access to
|
2014-09-26 21:15:40 +00:00
|
|
|
# your pki_dir. To make the access explicit, root must belong to the group
|
|
|
|
# you've given access to. This is potentially quite insecure. If an autosign_file
|
|
|
|
# is specified, enabling permissive_pki_access will allow group access to that
|
|
|
|
# specific file.
|
2012-07-24 21:55:15 +00:00
|
|
|
#permissive_pki_access: False
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-08-18 06:39:17 +00:00
|
|
|
# Allow users on the master access to execute specific commands on minions.
|
|
|
|
# This setting should be treated with care since it opens up execution
|
|
|
|
# capabilities to non root users. By default this capability is completely
|
|
|
|
# disabled.
|
2015-10-22 10:04:49 +00:00
|
|
|
#pulisher_acl:
|
2013-09-13 21:32:21 +00:00
|
|
|
# larry:
|
|
|
|
# - test.ping
|
|
|
|
# - network.*
|
2015-03-24 18:10:01 +00:00
|
|
|
#
|
2013-02-07 18:46:19 +00:00
|
|
|
# Blacklist any of the following users or modules
|
2013-02-11 23:41:27 +00:00
|
|
|
#
|
|
|
|
# This example would blacklist all non sudo users, including root from
|
|
|
|
# running any commands. It would also blacklist any use of the "cmd"
|
2014-09-26 21:15:40 +00:00
|
|
|
# module. This is completely disabled by default.
|
2013-02-11 23:41:27 +00:00
|
|
|
#
|
2015-10-22 10:04:49 +00:00
|
|
|
#publisher_acl_blacklist:
|
2013-09-13 21:32:21 +00:00
|
|
|
# users:
|
|
|
|
# - root
|
|
|
|
# - '^(?!sudo_).*$' # all non sudo users
|
|
|
|
# modules:
|
|
|
|
# - cmd
|
2015-10-22 10:04:49 +00:00
|
|
|
#
|
|
|
|
# WARNING: client_acl and client_acl_blacklist options are deprecated and will
|
|
|
|
# be removed in the future releases. Use publisher_acl and
|
|
|
|
# publisher_acl_blacklist instead.
|
2013-02-07 18:46:19 +00:00
|
|
|
|
2015-10-22 10:04:49 +00:00
|
|
|
# Enforce publisher_acl & publisher_acl_blacklist when users have sudo
|
2014-11-17 22:13:06 +00:00
|
|
|
# access to the salt command.
|
|
|
|
#
|
|
|
|
#sudo_acl: False
|
|
|
|
|
2012-10-02 21:03:30 +00:00
|
|
|
# The external auth system uses the Salt auth modules to authenticate and
|
2013-08-08 20:10:11 +00:00
|
|
|
# validate users to access areas of the Salt system.
|
2013-09-13 21:32:21 +00:00
|
|
|
#external_auth:
|
|
|
|
# pam:
|
|
|
|
# fred:
|
|
|
|
# - test.*
|
2015-03-24 18:10:01 +00:00
|
|
|
#
|
2012-12-27 19:57:25 +00:00
|
|
|
# Time (in seconds) for a newly generated token to live. Default: 12 hours
|
2013-09-13 21:32:21 +00:00
|
|
|
#token_expire: 43200
|
2012-07-24 21:55:15 +00:00
|
|
|
|
2013-08-08 20:10:11 +00:00
|
|
|
# Allow minions to push files to the master. This is disabled by default, for
|
|
|
|
# security purposes.
|
2013-12-02 08:40:11 +00:00
|
|
|
#file_recv: False
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2013-12-08 20:01:20 +00:00
|
|
|
# Set a hard-limit on the size of the files that can be pushed to the master.
|
2014-09-26 21:15:40 +00:00
|
|
|
# It will be interpreted as megabytes. Default: 100
|
2013-12-09 15:50:52 +00:00
|
|
|
#file_recv_max_size: 100
|
2013-12-08 20:01:20 +00:00
|
|
|
|
2013-12-11 20:47:47 +00:00
|
|
|
# Signature verification on messages published from the master.
|
|
|
|
# This causes the master to cryptographically sign all messages published to its event
|
|
|
|
# bus, and minions then verify that signature before acting on the message.
|
|
|
|
#
|
|
|
|
# This is False by default.
|
|
|
|
#
|
|
|
|
# Note that to facilitate interoperability with masters and minions that are different
|
|
|
|
# versions, if sign_pub_messages is True but a message is received by a minion with
|
|
|
|
# no signature, it will still be accepted, and a warning message will be logged.
|
|
|
|
# Conversely, if sign_pub_messages is False, but a minion receives a signed
|
|
|
|
# message it will be accepted, the signature will not be checked, and a warning message
|
2014-07-01 21:01:12 +00:00
|
|
|
# will be logged. This behavior went away in Salt 2014.1.0 and these two situations
|
|
|
|
# will cause minion to throw an exception and drop the message.
|
2013-12-11 20:47:47 +00:00
|
|
|
# sign_pub_messages: False
|
|
|
|
|
2015-05-04 21:05:12 +00:00
|
|
|
##### Salt-SSH Configuration #####
|
|
|
|
##########################################
|
|
|
|
|
|
|
|
# Pass in an alternative location for the salt-ssh roster file
|
|
|
|
#roster_file: /etc/salt/roster
|
|
|
|
|
|
|
|
# Pass in minion option overrides that will be inserted into the SHIM for
|
|
|
|
# salt-ssh calls. The local minion config is not used for salt-ssh. Can be
|
|
|
|
# overridden on a per-minion basis in the roster (`minion_opts`)
|
|
|
|
#ssh_minion_opts:
|
|
|
|
# gpg_keydir: /root/gpg
|
2014-09-26 21:15:40 +00:00
|
|
|
|
2016-04-26 19:52:09 +00:00
|
|
|
# Set this to True to default to using ~/.ssh/id_rsa for salt-ssh
|
|
|
|
# authentication with minions
|
|
|
|
#ssh_use_home_key: False
|
|
|
|
|
2012-05-19 00:31:55 +00:00
|
|
|
##### Master Module Management #####
|
|
|
|
##########################################
|
2014-09-26 21:15:40 +00:00
|
|
|
# Manage how master side modules are loaded.
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Add any additional locations to look for master runners:
|
2012-05-19 00:31:55 +00:00
|
|
|
#runner_dirs: []
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# Enable Cython for master side modules:
|
2012-05-21 20:33:42 +00:00
|
|
|
#cython_enable: False
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-05-19 00:31:55 +00:00
|
|
|
|
2011-05-27 04:30:38 +00:00
|
|
|
##### State System settings #####
|
|
|
|
##########################################
|
|
|
|
# The state system uses a "top" file to tell the minions what environment to
|
|
|
|
# use and what modules to use. The state_top file is defined relative to the
|
2012-06-05 20:54:21 +00:00
|
|
|
# root of the base environment as defined in "File Server settings" below.
|
2012-01-13 18:40:32 +00:00
|
|
|
#state_top: top.sls
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-10-01 05:18:05 +00:00
|
|
|
# The master_tops option replaces the external_nodes option by creating
|
|
|
|
# a plugable system for the generation of external top data. The external_nodes
|
|
|
|
# option is deprecated by the master_tops option.
|
2014-09-26 21:15:40 +00:00
|
|
|
#
|
2013-02-12 02:40:00 +00:00
|
|
|
# To gain the capabilities of the classic external_nodes system, use the
|
|
|
|
# following configuration:
|
2012-10-01 05:18:05 +00:00
|
|
|
# master_tops:
|
2012-10-01 05:55:49 +00:00
|
|
|
# ext_nodes: <Shell command which returns yaml>
|
2012-10-01 05:18:05 +00:00
|
|
|
#
|
|
|
|
#master_tops: {}
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-01-26 00:01:02 +00:00
|
|
|
# The external_nodes option allows Salt to gather data that would normally be
|
|
|
|
# placed in a top file. The external_nodes option is the executable that will
|
|
|
|
# return the ENC data. Remember that Salt will look for external nodes AND top
|
|
|
|
# files and combine the results if both are enabled!
|
|
|
|
#external_nodes: None
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2011-05-28 19:40:37 +00:00
|
|
|
# The renderer to use on the minions to render the state data
|
|
|
|
#renderer: yaml_jinja
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2013-11-08 20:29:47 +00:00
|
|
|
# The Jinja renderer can strip extra carriage returns and whitespace
|
|
|
|
# See http://jinja.pocoo.org/docs/api/#high-level-api
|
|
|
|
#
|
|
|
|
# If this is set to True the first newline after a Jinja block is removed
|
|
|
|
# (block, not variable tag!). Defaults to False, corresponds to the Jinja
|
2013-12-02 08:40:11 +00:00
|
|
|
# environment init variable "trim_blocks".
|
2015-07-30 20:39:15 +00:00
|
|
|
#jinja_trim_blocks: False
|
2013-11-08 20:29:47 +00:00
|
|
|
#
|
|
|
|
# If this is set to True leading spaces and tabs are stripped from the start
|
|
|
|
# of a line to a block. Defaults to False, corresponds to the Jinja
|
|
|
|
# environment init variable "lstrip_blocks".
|
2015-07-30 20:39:15 +00:00
|
|
|
#jinja_lstrip_blocks: False
|
2013-11-08 20:29:47 +00:00
|
|
|
|
2011-11-24 07:22:31 +00:00
|
|
|
# The failhard option tells the minions to stop immediately after the first
|
|
|
|
# failure detected in the state execution, defaults to False
|
|
|
|
#failhard: False
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-08-18 06:47:03 +00:00
|
|
|
# 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.
|
|
|
|
#state_verbose: True
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-08-18 06:47:03 +00:00
|
|
|
# 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'
|
2013-05-06 21:40:13 +00:00
|
|
|
# the output will be shortened to a single line. If set to 'mixed', the output
|
|
|
|
# will be terse unless a state failed, in which case that output will be full.
|
2014-04-07 15:26:07 +00:00
|
|
|
# If set to 'changes', the output will be full unless the state didn't change.
|
2012-08-18 06:47:03 +00:00
|
|
|
#state_output: full
|
2011-03-29 04:59:54 +00:00
|
|
|
|
2014-12-02 22:22:41 +00:00
|
|
|
# Automatically aggregate all states that have support for mod_aggregate by
|
2015-07-30 20:39:15 +00:00
|
|
|
# setting to 'True'. Or pass a list of state module names to automatically
|
2014-12-02 22:22:41 +00:00
|
|
|
# aggregate just those types.
|
|
|
|
#
|
|
|
|
# state_aggregate:
|
|
|
|
# - pkg
|
|
|
|
#
|
|
|
|
#state_aggregate: False
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2015-07-30 20:39:15 +00:00
|
|
|
# Send progress events as each function in a state run completes execution
|
|
|
|
# by setting to 'True'. Progress events are in the format
|
2015-07-30 21:43:21 +00:00
|
|
|
# 'salt/job/<JID>/prog/<MID>/<RUN NUM>'.
|
2015-07-30 20:39:15 +00:00
|
|
|
#state_events: False
|
|
|
|
|
2011-05-21 23:11:21 +00:00
|
|
|
##### File Server settings #####
|
|
|
|
##########################################
|
2011-05-26 10:22:37 +00:00
|
|
|
# Salt runs a lightweight file server written in zeromq to deliver files to
|
2011-05-21 23:11:21 +00:00
|
|
|
# minions. This file server is built into the master daemon and does not
|
2011-05-26 10:22:37 +00:00
|
|
|
# require a dedicated port.
|
2011-05-21 23:11:21 +00:00
|
|
|
|
2011-05-27 04:30:38 +00:00
|
|
|
# The file server works on environments passed to the master, 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
|
2012-02-04 05:10:29 +00:00
|
|
|
# reliably ensured. A base environment is required to house the top file.
|
2011-05-27 04:30:38 +00:00
|
|
|
# Example:
|
2011-05-27 05:35:45 +00:00
|
|
|
# file_roots:
|
2011-05-28 18:12:05 +00:00
|
|
|
# base:
|
2011-05-27 04:30:38 +00:00
|
|
|
# - /srv/salt/
|
2011-05-28 18:12:05 +00:00
|
|
|
# dev:
|
2011-05-27 04:30:38 +00:00
|
|
|
# - /srv/salt/dev/services
|
|
|
|
# - /srv/salt/dev/states
|
2011-05-28 18:12:05 +00:00
|
|
|
# prod:
|
2011-05-27 04:30:38 +00:00
|
|
|
# - /srv/salt/prod/services
|
|
|
|
# - /srv/salt/prod/states
|
2015-03-24 18:10:01 +00:00
|
|
|
#
|
2012-01-16 19:36:39 +00:00
|
|
|
#file_roots:
|
2011-05-28 18:12:05 +00:00
|
|
|
# base:
|
2011-05-27 04:30:38 +00:00
|
|
|
# - /srv/salt
|
2015-06-15 17:30:14 +00:00
|
|
|
#
|
|
|
|
|
|
|
|
# When using multiple environments, each with their own top file, the
|
|
|
|
# default behaviour is an unordered merge. To prevent top files from
|
|
|
|
# being merged together and instead to only use the top file from the
|
2016-03-01 15:35:34 +00:00
|
|
|
# requested environment, set this value to 'same'.
|
2015-08-24 19:50:13 +00:00
|
|
|
#top_file_merging_strategy: merge
|
2015-06-15 17:30:14 +00:00
|
|
|
|
|
|
|
# To specify the order in which environments are merged, set the ordering
|
|
|
|
# in the env_order option. Given a conflict, the last matching value will
|
|
|
|
# win.
|
2015-08-24 19:50:13 +00:00
|
|
|
#env_order: ['base', 'dev', 'prod']
|
|
|
|
|
|
|
|
# If top_file_merging_strategy is set to 'same' and an environment does not
|
|
|
|
# contain a top file, the top file in the environment specified by default_top
|
|
|
|
# will be used instead.
|
|
|
|
#default_top: base
|
2011-05-21 23:11:21 +00:00
|
|
|
|
|
|
|
# The hash_type is the hash to use when discovering the hash of a file on
|
2016-02-12 15:21:12 +00:00
|
|
|
# the master server. The default is md5 but sha1, sha224, sha256, sha384
|
2011-05-21 23:11:21 +00:00
|
|
|
# and sha512 are also supported.
|
2014-04-07 20:14:19 +00:00
|
|
|
#
|
2016-03-01 14:58:58 +00:00
|
|
|
# WARNING: While md5 is also supported, do not use it due to the high chance
|
|
|
|
# of possible collisions and thus security breach.
|
|
|
|
#
|
|
|
|
# Prior to changing this value, the master should be stopped and all Salt
|
2014-04-07 20:14:19 +00:00
|
|
|
# caches should be cleared.
|
2016-03-01 14:58:58 +00:00
|
|
|
#hash_type: sha256
|
2011-05-21 23:11:21 +00:00
|
|
|
|
|
|
|
# The buffer size in the file server can be adjusted here:
|
|
|
|
#file_buffer_size: 1048576
|
|
|
|
|
2012-12-05 18:58:43 +00:00
|
|
|
# A regular expression (or a list of expressions) that will be matched
|
|
|
|
# against the file path before syncing the modules and states to the minions.
|
|
|
|
# This includes files affected by the file.recurse state.
|
|
|
|
# For example, if you manage your custom modules and states in subversion
|
|
|
|
# and don't want all the '.svn' folders and content synced to your minions,
|
|
|
|
# you could set this to '/\.svn($|/)'. By default nothing is ignored.
|
2013-09-13 21:32:21 +00:00
|
|
|
#file_ignore_regex:
|
|
|
|
# - '/\.svn($|/)'
|
|
|
|
# - '/\.git($|/)'
|
2012-12-05 18:58:43 +00:00
|
|
|
|
|
|
|
# A file glob (or list of file globs) that will be matched against the file
|
|
|
|
# path before syncing the modules and states to the minions. This is similar
|
|
|
|
# to file_ignore_regex above, but works on globs instead of regex. By default
|
|
|
|
# nothing is ignored.
|
2013-02-12 02:40:00 +00:00
|
|
|
# file_ignore_glob:
|
2013-09-13 21:32:21 +00:00
|
|
|
# - '*.pyc'
|
|
|
|
# - '*/somefolder/*.bak'
|
|
|
|
# - '*.swp'
|
2012-12-05 18:58:43 +00:00
|
|
|
|
2012-12-27 21:21:56 +00:00
|
|
|
# File Server Backend
|
2014-09-26 21:15:40 +00:00
|
|
|
#
|
2012-12-27 21:21:56 +00:00
|
|
|
# Salt supports a modular fileserver backend system, this system allows
|
|
|
|
# the salt master to link directly to third party systems to gather and
|
2013-01-01 21:56:26 +00:00
|
|
|
# manage the files available to minions. Multiple backends can be
|
|
|
|
# configured and will be searched for the requested file in the order in which
|
2013-02-12 02:40:00 +00:00
|
|
|
# they are defined here. The default setting only enables the standard backend
|
2013-01-01 21:56:26 +00:00
|
|
|
# "roots" which uses the "file_roots" option.
|
2013-02-12 02:40:00 +00:00
|
|
|
#fileserver_backend:
|
|
|
|
# - roots
|
2013-09-13 21:32:21 +00:00
|
|
|
#
|
2013-01-01 21:56:26 +00:00
|
|
|
# To use multiple backends list them in the order they are searched:
|
2013-09-13 21:32:21 +00:00
|
|
|
#fileserver_backend:
|
|
|
|
# - git
|
|
|
|
# - roots
|
2013-09-20 17:47:05 +00:00
|
|
|
#
|
|
|
|
# Uncomment the line below if you do not want the file_server to follow
|
2013-09-26 03:21:27 +00:00
|
|
|
# symlinks when walking the filesystem tree. This is set to True
|
2013-12-02 08:40:11 +00:00
|
|
|
# by default. Currently this only applies to the default roots
|
2013-09-26 03:21:27 +00:00
|
|
|
# fileserver_backend.
|
2013-09-20 17:47:05 +00:00
|
|
|
#fileserver_followsymlinks: False
|
2013-09-21 01:25:48 +00:00
|
|
|
#
|
|
|
|
# Uncomment the line below if you do not want symlinks to be
|
2013-09-25 02:36:16 +00:00
|
|
|
# treated as the files they are pointing to. By default this is set to
|
2013-09-21 01:25:48 +00:00
|
|
|
# False. By uncommenting the line below, any detected symlink while listing
|
|
|
|
# files on the Master will not be returned to the Minion.
|
|
|
|
#fileserver_ignoresymlinks: True
|
|
|
|
#
|
2013-10-31 23:07:02 +00:00
|
|
|
# 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 impacted. Default is False.
|
|
|
|
# fileserver_limit_traversal: False
|
|
|
|
#
|
2013-12-09 05:46:36 +00:00
|
|
|
# The fileserver can fire events off every time the fileserver is updated,
|
|
|
|
# these are disabled by default, but can be easily turned on by setting this
|
|
|
|
# flag to True
|
|
|
|
#fileserver_events: False
|
2014-09-26 21:15:40 +00:00
|
|
|
|
|
|
|
# Git File Server Backend Configuration
|
2014-01-04 01:20:59 +00:00
|
|
|
#
|
2016-04-20 19:06:44 +00:00
|
|
|
# Optional parameter used to specify the provider to be used for gitfs. Must
|
|
|
|
# be one of the following: pygit2, gitpython, or dulwich. If unset, then each
|
|
|
|
# will be tried in that same order, and the first one with a compatible
|
|
|
|
# version installed will be the provider that is used.
|
|
|
|
#gitfs_provider: pygit2
|
|
|
|
|
|
|
|
# Along with gitfs_password, is used to authenticate to HTTPS remotes.
|
|
|
|
# gitfs_user: ''
|
|
|
|
|
|
|
|
# Along with gitfs_user, is used to authenticate to HTTPS remotes.
|
|
|
|
# This parameter is not required if the repository does not use authentication.
|
|
|
|
#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.
|
|
|
|
#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.
|
|
|
|
#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.
|
|
|
|
#gitfs_privkey: ''
|
|
|
|
|
|
|
|
# This parameter is optional, required only when the SSH key being used to
|
|
|
|
# authenticate is protected by a passphrase.
|
|
|
|
#gitfs_passphrase: ''
|
|
|
|
|
2013-01-01 21:56:26 +00:00
|
|
|
# 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.
|
2013-09-13 21:32:21 +00:00
|
|
|
#
|
2014-01-04 01:20:59 +00:00
|
|
|
# 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.
|
2016-04-25 21:26:09 +00:00
|
|
|
# Note: file:// repos will be treated as a remote, so refs you want used must
|
2014-01-04 01:20:59 +00:00
|
|
|
# exist in that repo as *local* refs.
|
2013-09-13 21:32:21 +00:00
|
|
|
#gitfs_remotes:
|
|
|
|
# - git://github.com/saltstack/salt-states.git
|
|
|
|
# - file:///var/git/saltmaster
|
|
|
|
#
|
2013-12-03 07:54:47 +00:00
|
|
|
# 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.
|
|
|
|
#gitfs_ssl_verify: True
|
|
|
|
#
|
2013-08-18 01:14:57 +00:00
|
|
|
# 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.
|
|
|
|
#gitfs_root: somefolder/otherfolder
|
2015-03-24 18:10:01 +00:00
|
|
|
#
|
|
|
|
#
|
2013-02-12 02:40:00 +00:00
|
|
|
##### Pillar settings #####
|
|
|
|
##########################################
|
|
|
|
# Salt Pillars allow for the building of global data that can be made selectively
|
2013-02-25 18:46:27 +00:00
|
|
|
# available to different minions based on minion grain filtering. The Salt
|
|
|
|
# Pillar is laid out in the same fashion as the file server, with environments,
|
|
|
|
# a top file and sls files. However, pillar data does not need to be in the
|
2013-02-12 02:40:00 +00:00
|
|
|
# highstate format, and is generally just key/value pairs.
|
2012-03-08 22:26:44 +00:00
|
|
|
#pillar_roots:
|
|
|
|
# base:
|
|
|
|
# - /srv/pillar
|
2014-09-26 21:15:40 +00:00
|
|
|
#
|
2013-09-13 21:32:21 +00:00
|
|
|
#ext_pillar:
|
|
|
|
# - hiera: /etc/hiera.yaml
|
|
|
|
# - cmd_yaml: cat /etc/salt/yaml
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2014-08-31 21:46:22 +00:00
|
|
|
# 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.
|
|
|
|
#ext_pillar_first: False
|
|
|
|
|
2013-12-02 08:40:11 +00:00
|
|
|
# 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
|
2013-12-03 07:54:47 +00:00
|
|
|
# is a security concern, you may want to try using the ssh transport.
|
2013-12-02 08:40:11 +00:00
|
|
|
#pillar_gitfs_ssl_verify: True
|
|
|
|
|
2012-10-11 05:53:01 +00:00
|
|
|
# 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.
|
2014-10-17 16:18:59 +00:00
|
|
|
#pillar_opts: False
|
2012-03-08 22:26:44 +00:00
|
|
|
|
2015-09-09 17:16:55 +00:00
|
|
|
# The pillar_safe_render_error option prevents the master from passing pillar
|
2015-03-04 01:53:36 +00:00
|
|
|
# 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.
|
|
|
|
#pillar_safe_render_error: True
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2015-03-24 20:53:18 +00:00
|
|
|
# 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
|
2016-03-18 00:02:50 +00:00
|
|
|
# will overwrite elements according the order in which they are processed. This is
|
2015-03-24 20:53:18 +00:00
|
|
|
# behavior of the 2014.1 branch and earlier. Smart guesses the best strategy based
|
|
|
|
# on the "renderer" setting and is the default value.
|
|
|
|
#pillar_source_merging_strategy: smart
|
|
|
|
|
2015-12-29 17:22:54 +00:00
|
|
|
# Recursively merge lists by aggregating them instead of replacing them.
|
2016-01-06 16:55:20 +00:00
|
|
|
#pillar_merge_lists: False
|
2015-12-29 17:22:54 +00:00
|
|
|
|
2016-04-20 19:06:44 +00:00
|
|
|
# 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.
|
|
|
|
#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.
|
|
|
|
#git_pillar_base: master
|
|
|
|
|
|
|
|
# If the branch is omitted from a git_pillar remote, then this branch will
|
|
|
|
# be used instead
|
|
|
|
#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.
|
|
|
|
#git_pillar_env: ''
|
|
|
|
|
|
|
|
# Path relative to the root of the repository where the git_pillar top file
|
|
|
|
# and SLS files are located.
|
|
|
|
#git_pillar_root: ''
|
|
|
|
|
|
|
|
# Specifies whether or not to ignore SSL certificate errors when contacting
|
|
|
|
# the remote repository.
|
|
|
|
#git_pillar_ssl_verify: False
|
|
|
|
|
|
|
|
# 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.
|
|
|
|
#git_pillar_global_lock: True
|
|
|
|
|
|
|
|
# Git External Pillar Authentication Options
|
|
|
|
#
|
|
|
|
# Along with git_pillar_password, is used to authenticate to HTTPS remotes.
|
|
|
|
#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.
|
|
|
|
#git_pillar_password: ''
|
|
|
|
|
|
|
|
# By default, Salt will not authenticate to an HTTP (non-HTTPS) remote.
|
|
|
|
# This parameter enables authentication over HTTP.
|
|
|
|
#git_pillar_insecure_auth: False
|
|
|
|
|
|
|
|
# Along with git_pillar_privkey (and optionally git_pillar_passphrase),
|
|
|
|
# is used to authenticate to SSH remotes.
|
|
|
|
#git_pillar_pubkey: ''
|
|
|
|
|
|
|
|
# Along with git_pillar_pubkey (and optionally git_pillar_passphrase),
|
|
|
|
# is used to authenticate to SSH remotes.
|
|
|
|
#git_pillar_privkey: ''
|
|
|
|
|
|
|
|
# This parameter is optional, required only when the SSH key being used
|
|
|
|
# to authenticate is protected by a passphrase.
|
|
|
|
#git_pillar_passphrase: ''
|
|
|
|
|
2016-01-25 17:43:16 +00:00
|
|
|
# A master can cache pillars locally to bypass the expense of having to render them
|
|
|
|
# for each minion on every request. This feature should only be enabled in cases
|
2016-04-25 21:26:09 +00:00
|
|
|
# where pillar rendering time is known to be unsatisfactory and any attendant security
|
2016-01-25 17:43:16 +00:00
|
|
|
# concerns about storing pillars in a master cache have been addressed.
|
|
|
|
#
|
2016-04-25 21:26:09 +00:00
|
|
|
# When enabling this feature, be certain to read through the additional ``pillar_cache_*``
|
|
|
|
# configuration options to fully understand the tunable parameters and their implications.
|
2016-01-25 17:43:16 +00:00
|
|
|
#
|
2016-04-25 21:26:09 +00:00
|
|
|
# Note: setting ``pillar_cache: True`` has no effect on targeting Minions with Pillars.
|
|
|
|
# See https://docs.saltstack.com/en/latest/topics/targeting/pillar.html
|
2016-01-25 17:43:16 +00:00
|
|
|
#pillar_cache: False
|
|
|
|
|
2016-04-25 21:26:09 +00:00
|
|
|
# If and only if a master has set ``pillar_cache: True``, the cache TTL controls the amount
|
2016-01-25 17:43:16 +00:00
|
|
|
# of time, in seconds, before the cache is considered invalid by a master and a fresh
|
|
|
|
# pillar is recompiled and stored.
|
2016-04-25 21:26:09 +00:00
|
|
|
#pillar_cache_ttl: 3600
|
2016-01-25 17:43:16 +00:00
|
|
|
|
2016-03-18 00:02:50 +00:00
|
|
|
# If and only if a master has set `pillar_cache: True`, one of several storage providers
|
2016-01-25 17:43:16 +00:00
|
|
|
# can be utililzed.
|
|
|
|
#
|
|
|
|
# `disk`: The default storage backend. This caches rendered pillars to the master cache.
|
|
|
|
# Rendered pillars are serialized and deserialized as msgpack structures for speed.
|
|
|
|
# Note that pillars are stored UNENCRYPTED. Ensure that the master cache
|
2016-03-18 00:02:50 +00:00
|
|
|
# has permissions set appropriately. (Same defaults are provided.)
|
2016-01-25 17:43:16 +00:00
|
|
|
#
|
2016-04-25 21:26:09 +00:00
|
|
|
# memory: [EXPERIMENTAL] An optional backend for pillar caches which uses a pure-Python
|
|
|
|
# in-memory data structure for maximal performance. There are several caveats,
|
|
|
|
# however. First, because each master worker contains its own in-memory cache,
|
|
|
|
# there is no guarantee of cache consistency between minion requests. This
|
|
|
|
# works best in situations where the pillar rarely if ever changes. Secondly,
|
|
|
|
# and perhaps more importantly, this means that unencrypted pillars will
|
|
|
|
# be accessible to any process which can examine the memory of the ``salt-master``!
|
|
|
|
# This may represent a substantial security risk.
|
2016-01-25 17:43:16 +00:00
|
|
|
#
|
|
|
|
#pillar_cache_backend: disk
|
|
|
|
|
|
|
|
|
2011-08-27 17:08:59 +00:00
|
|
|
##### Syndic settings #####
|
|
|
|
##########################################
|
|
|
|
# The Salt syndic is used to pass commands through a master from a higher
|
2015-04-03 23:17:06 +00:00
|
|
|
# master. Using the syndic is simple. If this is a master that will have
|
|
|
|
# syndic servers(s) below it, then set the "order_masters" setting to True.
|
|
|
|
#
|
|
|
|
# If this is a master that will be running a syndic daemon for passthrough, then
|
|
|
|
# the "syndic_master" setting needs to be set to the location of the master server
|
2012-06-09 16:35:29 +00:00
|
|
|
# to receive commands from.
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2011-08-27 17:08:59 +00:00
|
|
|
# Set the order_masters setting to True if this master will command lower
|
2012-02-04 05:10:29 +00:00
|
|
|
# masters' syndic interfaces.
|
2011-08-27 17:08:59 +00:00
|
|
|
#order_masters: False
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-02-04 05:10:29 +00:00
|
|
|
# If this master will be running a salt syndic daemon, syndic_master tells
|
2012-03-08 22:26:44 +00:00
|
|
|
# this master where to receive commands from.
|
2011-08-27 17:08:59 +00:00
|
|
|
#syndic_master: masterofmaster
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# This is the 'ret_port' of the MasterOfMaster:
|
2013-07-13 19:53:11 +00:00
|
|
|
#syndic_master_port: 4506
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# PID file of the syndic daemon:
|
2013-07-13 19:53:11 +00:00
|
|
|
#syndic_pidfile: /var/run/salt-syndic.pid
|
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
# LOG file of the syndic daemon:
|
2013-07-13 19:53:11 +00:00
|
|
|
#syndic_log_file: syndic.log
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
|
2011-07-30 04:50:17 +00:00
|
|
|
##### Peer Publish settings #####
|
|
|
|
##########################################
|
|
|
|
# Salt minions can send commands to other minions, but only if the minion is
|
|
|
|
# allowed to. By default "Peer Publication" is disabled, and when enabled it
|
|
|
|
# is enabled for specific minions and specific commands. This allows secure
|
|
|
|
# compartmentalization of commands based on individual minions.
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2011-07-30 04:50:17 +00:00
|
|
|
# The configuration uses regular expressions to match minions and then a list
|
2012-02-04 05:10:29 +00:00
|
|
|
# of regular expressions to match functions. The following will allow the
|
2011-07-30 04:50:17 +00:00
|
|
|
# minion authenticated as foo.example.com to execute functions from the test
|
2012-02-04 05:10:29 +00:00
|
|
|
# and pkg modules.
|
2013-09-13 21:32:21 +00:00
|
|
|
#peer:
|
|
|
|
# foo.example.com:
|
|
|
|
# - test.*
|
|
|
|
# - pkg.*
|
2011-07-30 04:50:17 +00:00
|
|
|
#
|
|
|
|
# This will allow all minions to execute all commands:
|
2013-09-13 21:32:21 +00:00
|
|
|
#peer:
|
|
|
|
# .*:
|
|
|
|
# - .*
|
|
|
|
#
|
2012-05-24 16:48:58 +00:00
|
|
|
# This is not recommended, since it would allow anyone who gets root on any
|
2011-07-30 04:50:17 +00:00
|
|
|
# single minion to instantly have root on all of the minions!
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-06-03 02:50:20 +00:00
|
|
|
# Minions can also be allowed to execute runners from the salt master.
|
|
|
|
# Since executing a runner from the minion could be considered a security risk,
|
2012-06-09 16:35:29 +00:00
|
|
|
# it needs to be enabled. This setting functions just like the peer setting
|
2012-06-03 02:50:20 +00:00
|
|
|
# except that it opens up runners instead of module functions.
|
|
|
|
#
|
|
|
|
# All peer runner support is turned off by default and must be enabled before
|
|
|
|
# using. This will enable all peer runners for all minions:
|
2013-09-13 21:32:21 +00:00
|
|
|
#peer_run:
|
|
|
|
# .*:
|
|
|
|
# - .*
|
2012-06-03 02:50:20 +00:00
|
|
|
#
|
|
|
|
# To enable just the manage.up runner for the minion foo.example.com:
|
2013-09-13 21:32:21 +00:00
|
|
|
#peer_run:
|
|
|
|
# foo.example.com:
|
|
|
|
# - manage.up
|
2015-03-24 18:10:01 +00:00
|
|
|
#
|
|
|
|
#
|
2013-09-23 16:00:19 +00:00
|
|
|
##### Mine settings #####
|
2015-10-05 20:22:59 +00:00
|
|
|
#####################################
|
2013-09-23 16:00:19 +00:00
|
|
|
# Restrict mine.get access from minions. By default any minion has a full access
|
|
|
|
# to get all mine data from master cache. In acl definion below, only pcre matches
|
|
|
|
# are allowed.
|
|
|
|
# mine_get:
|
|
|
|
# .*:
|
|
|
|
# - .*
|
|
|
|
#
|
2014-09-26 21:15:40 +00:00
|
|
|
# The example below enables minion foo.example.com to get 'network.interfaces' mine
|
|
|
|
# data only, minions web* to get all network.* and disk.* mine data and all other
|
|
|
|
# minions won't get any mine data.
|
2013-09-23 16:00:19 +00:00
|
|
|
# mine_get:
|
|
|
|
# foo.example.com:
|
2014-03-14 10:15:35 +00:00
|
|
|
# - network.interfaces
|
2013-09-23 16:00:19 +00:00
|
|
|
# web.*:
|
|
|
|
# - network.*
|
|
|
|
# - disk.*
|
2011-07-30 04:50:17 +00:00
|
|
|
|
2014-09-26 21:15:40 +00:00
|
|
|
|
2011-03-29 04:59:54 +00:00
|
|
|
##### Logging settings #####
|
|
|
|
##########################################
|
|
|
|
# The location of the master log file
|
2013-01-11 00:51:44 +00:00
|
|
|
# The master 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>
|
2013-02-25 18:46:27 +00:00
|
|
|
#log_file: /var/log/salt/master
|
|
|
|
#log_file: file:///dev/log
|
|
|
|
#log_file: udp://loghost:10514
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2011-03-25 03:53:47 +00:00
|
|
|
#log_file: /var/log/salt/master
|
2012-09-07 16:48:06 +00:00
|
|
|
#key_logfile: /var/log/salt/key
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-10-23 16:06:12 +00:00
|
|
|
# The level of messages to send to the console.
|
2012-06-30 22:40:03 +00:00
|
|
|
# One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
|
2015-09-14 21:39:17 +00:00
|
|
|
#
|
|
|
|
# The following log levels are considered INSECURE and may log sensitive data:
|
|
|
|
# ['garbage', 'trace', 'debug']
|
|
|
|
#
|
2011-05-26 10:22:37 +00:00
|
|
|
#log_level: warning
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-10-23 16:06:12 +00:00
|
|
|
# The level of messages to send to the log file.
|
|
|
|
# One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'.
|
2014-12-17 01:18:21 +00:00
|
|
|
# If using 'log_granular_levels' this must be set to the highest desired level.
|
2013-02-12 02:40:00 +00:00
|
|
|
#log_level_logfile: warning
|
2012-10-23 16:06:12 +00:00
|
|
|
|
2016-02-04 11:45:19 +00:00
|
|
|
# The date and time format used in log messages. Allowed date/time formatting
|
2013-01-11 00:51:44 +00:00
|
|
|
# can be seen here: http://docs.python.org/library/time.html#time.strftime
|
2012-12-18 13:35:13 +00:00
|
|
|
#log_datefmt: '%H:%M:%S'
|
|
|
|
#log_datefmt_logfile: '%Y-%m-%d %H:%M:%S'
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-06-30 22:40:03 +00:00
|
|
|
# The format of the console logging messages. Allowed formatting options can
|
2013-02-25 18:46:27 +00:00
|
|
|
# be seen here: http://docs.python.org/library/logging.html#logrecord-attributes
|
2014-12-27 18:34:15 +00:00
|
|
|
#
|
2015-03-26 06:10:55 +00:00
|
|
|
# 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.
|
|
|
|
#
|
2015-07-28 21:54:10 +00:00
|
|
|
#log_fmt_console: '%(colorlevel)s %(colormsg)s'
|
2012-06-30 22:40:03 +00:00
|
|
|
#log_fmt_console: '[%(levelname)-8s] %(message)s'
|
2015-07-28 21:54:10 +00:00
|
|
|
#
|
2012-06-30 22:40:03 +00:00
|
|
|
#log_fmt_logfile: '%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s'
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2013-01-11 00:51:44 +00:00
|
|
|
# This can be used to control logging levels more specificically. This
|
2013-02-07 18:46:19 +00:00
|
|
|
# example sets the main salt library at the 'warning' level, but sets
|
2013-01-11 00:51:44 +00:00
|
|
|
# 'salt.modules' to log at the 'debug' level:
|
2012-01-13 19:31:20 +00:00
|
|
|
# log_granular_levels:
|
2014-12-17 01:11:04 +00:00
|
|
|
# 'salt': 'warning'
|
2011-05-26 10:22:37 +00:00
|
|
|
# 'salt.modules': 'debug'
|
|
|
|
#
|
|
|
|
#log_granular_levels: {}
|
2011-12-07 18:43:21 +00:00
|
|
|
|
|
|
|
|
2015-10-05 20:22:59 +00:00
|
|
|
##### Node Groups ######
|
2011-12-07 18:43:21 +00:00
|
|
|
##########################################
|
2016-02-04 10:29:49 +00:00
|
|
|
# Node groups allow for logical groupings of minion nodes. A group consists of
|
|
|
|
# a group name and a compound target. Nodgroups can reference other nodegroups
|
|
|
|
# with 'N@' classifier. Ensure that you do not have circular references.
|
|
|
|
#
|
2013-09-13 21:32:21 +00:00
|
|
|
#nodegroups:
|
2016-02-04 10:29:49 +00:00
|
|
|
# group1: 'L@foo.domain.com,bar.domain.com,baz.domain.com or bl*.domain.com'
|
2013-09-13 21:32:21 +00:00
|
|
|
# group2: 'G@os:Debian and foo.domain.com'
|
2016-02-04 10:29:49 +00:00
|
|
|
# group3: 'G@os:Debian and N@group1'
|
|
|
|
# group4:
|
|
|
|
# - 'G@foo:bar'
|
|
|
|
# - 'or'
|
|
|
|
# - 'G@foo:baz'
|
2011-12-16 15:16:44 +00:00
|
|
|
|
2013-02-12 02:40:00 +00:00
|
|
|
|
2012-03-07 02:26:23 +00:00
|
|
|
##### Range Cluster settings #####
|
|
|
|
##########################################
|
2012-10-05 15:22:20 +00:00
|
|
|
# The range server (and optional port) that serves your cluster information
|
2014-08-20 17:54:29 +00:00
|
|
|
# https://github.com/ytoolshed/range/wiki/%22yamlfile%22-module-file-spec
|
2012-11-07 18:47:56 +00:00
|
|
|
#
|
2013-09-13 21:32:21 +00:00
|
|
|
#range_server: range:80
|
2012-12-31 18:23:37 +00:00
|
|
|
|
|
|
|
|
2015-10-05 20:22:59 +00:00
|
|
|
##### Windows Software Repo settings #####
|
|
|
|
###########################################
|
|
|
|
# Location of the repo on the master:
|
|
|
|
#winrepo_dir_ng: '/srv/salt/win/repo-ng'
|
|
|
|
#
|
|
|
|
# List of git repositories to include with the local repo:
|
|
|
|
#winrepo_remotes_ng:
|
|
|
|
# - 'https://github.com/saltstack/salt-winrepo-ng.git'
|
|
|
|
|
|
|
|
|
|
|
|
##### Windows Software Repo settings - Pre 2015.8 #####
|
|
|
|
########################################################
|
|
|
|
# Legacy repo settings for pre-2015.8 Windows minions.
|
|
|
|
#
|
2014-09-26 21:15:40 +00:00
|
|
|
# Location of the repo on the master:
|
2015-10-05 20:22:59 +00:00
|
|
|
#winrepo_dir: '/srv/salt/win/repo'
|
2015-03-24 18:10:01 +00:00
|
|
|
#
|
2014-09-26 21:15:40 +00:00
|
|
|
# Location of the master's repo cache file:
|
2015-10-05 20:22:59 +00:00
|
|
|
#winrepo_mastercachefile: '/srv/salt/win/repo/winrepo.p'
|
2015-03-24 18:10:01 +00:00
|
|
|
#
|
2014-09-26 21:15:40 +00:00
|
|
|
# List of git repositories to include with the local repo:
|
2015-10-05 20:22:59 +00:00
|
|
|
#winrepo_remotes:
|
2013-09-13 21:32:21 +00:00
|
|
|
# - 'https://github.com/saltstack/salt-winrepo.git'
|
2014-12-03 16:12:37 +00:00
|
|
|
|
2015-10-05 20:22:59 +00:00
|
|
|
|
2014-12-03 16:12:37 +00:00
|
|
|
##### Returner settings ######
|
|
|
|
############################################
|
|
|
|
# Which returner(s) will be used for minion's result:
|
|
|
|
#return: mysql
|
2015-10-22 04:15:13 +00:00
|
|
|
|
|
|
|
|
|
|
|
###### Miscellaneous settings ######
|
|
|
|
############################################
|
|
|
|
# Default match type for filtering events tags: startswith, endswith, find, regex, fnmatch
|
|
|
|
#event_match_type: startswith
|