diff options
Diffstat (limited to 'meta-openstack/recipes-support/salt/files/minion')
| -rw-r--r-- | meta-openstack/recipes-support/salt/files/minion | 366 |
1 files changed, 276 insertions, 90 deletions
diff --git a/meta-openstack/recipes-support/salt/files/minion b/meta-openstack/recipes-support/salt/files/minion index 8fdde14..bd97c43 100644 --- a/meta-openstack/recipes-support/salt/files/minion +++ b/meta-openstack/recipes-support/salt/files/minion | |||
| @@ -1,16 +1,52 @@ | |||
| 1 | ##### Primary configuration settings ##### | 1 | ##### Primary configuration settings ##### |
| 2 | ########################################## | 2 | ########################################## |
| 3 | # This configuration file is used to manage the behavior of the Salt Minion. | ||
| 4 | # With the exception of the location of the Salt Master Server, values that are | ||
| 5 | # commented out but have an empty line after the comment are defaults that need | ||
| 6 | # not be set in the config. If there is no blank line after the comment, the | ||
| 7 | # value is presented as an example and is not the default. | ||
| 3 | 8 | ||
| 4 | # Per default the minion will automatically include all config files | 9 | # Per default the minion will automatically include all config files |
| 5 | # from minion.d/*.conf (minion.d is a directory in the same directory | 10 | # from minion.d/*.conf (minion.d is a directory in the same directory |
| 6 | # as the main minion config file). | 11 | # as the main minion config file). |
| 7 | #default_include: minion.d/*.conf | 12 | #default_include: minion.d/*.conf |
| 8 | 13 | ||
| 9 | # Set the location of the salt master server, if the master server cannot be | 14 | # Set the location of the salt master server. If the master server cannot be |
| 10 | # resolved, then the minion will fail to start. | 15 | # resolved, then the minion will fail to start. |
| 11 | #master: salt | 16 | #master: salt |
| 12 | 17 | ||
| 13 | # Set whether the minion should connect to the master via IPv6 | 18 | # Set http proxy information for the minion when doing requests |
| 19 | #proxy_host: | ||
| 20 | #proxy_port: | ||
| 21 | #proxy_username: | ||
| 22 | #proxy_password: | ||
| 23 | |||
| 24 | # If multiple masters are specified in the 'master' setting, the default behavior | ||
| 25 | # is to always try to connect to them in the order they are listed. If random_master is | ||
| 26 | # set to True, the order will be randomized instead. This can be helpful in distributing | ||
| 27 | # the load of many minions executing salt-call requests, for example, from a cron job. | ||
| 28 | # If only one master is listed, this setting is ignored and a warning will be logged. | ||
| 29 | # NOTE: If master_type is set to failover, use master_shuffle instead. | ||
| 30 | #random_master: False | ||
| 31 | |||
| 32 | # Use if master_type is set to failover. | ||
| 33 | #master_shuffle: False | ||
| 34 | |||
| 35 | # Minions can connect to multiple masters simultaneously (all masters | ||
| 36 | # are "hot"), or can be configured to failover if a master becomes | ||
| 37 | # unavailable. Multiple hot masters are configured by setting this | ||
| 38 | # value to "str". Failover masters can be requested by setting | ||
| 39 | # to "failover". MAKE SURE TO SET master_alive_interval if you are | ||
| 40 | # using failover. | ||
| 41 | # master_type: str | ||
| 42 | |||
| 43 | # Poll interval in seconds for checking if the master is still there. Only | ||
| 44 | # respected if master_type above is "failover". To disable the interval entirely, | ||
| 45 | # set the value to -1. (This may be necessary on machines which have high numbers | ||
| 46 | # of TCP connections, such as load balancers.) | ||
| 47 | # master_alive_interval: 30 | ||
| 48 | |||
| 49 | # Set whether the minion should connect to the master via IPv6: | ||
| 14 | #ipv6: False | 50 | #ipv6: False |
| 15 | 51 | ||
| 16 | # Set the number of seconds to wait before attempting to resolve | 52 | # Set the number of seconds to wait before attempting to resolve |
| @@ -18,13 +54,19 @@ | |||
| 18 | # Set to zero if the minion should shutdown and not retry. | 54 | # Set to zero if the minion should shutdown and not retry. |
| 19 | # retry_dns: 30 | 55 | # retry_dns: 30 |
| 20 | 56 | ||
| 21 | # Set the port used by the master reply and authentication server | 57 | # Set the port used by the master reply and authentication server. |
| 22 | #master_port: 4506 | 58 | #master_port: 4506 |
| 23 | 59 | ||
| 24 | # The user to run salt | 60 | # The user to run salt. |
| 25 | #user: root | 61 | #user: root |
| 26 | 62 | ||
| 27 | # Specify the location of the daemon process ID file | 63 | # Setting sudo_user will cause salt to run all execution modules under an sudo |
| 64 | # to the user given in sudo_user. The user under which the salt minion process | ||
| 65 | # itself runs will still be that provided in the user config above, but all | ||
| 66 | # execution modules run by the minion will be rerouted through sudo. | ||
| 67 | #sudo_user: saltdev | ||
| 68 | |||
| 69 | # Specify the location of the daemon process ID file. | ||
| 28 | #pidfile: /var/run/salt-minion.pid | 70 | #pidfile: /var/run/salt-minion.pid |
| 29 | 71 | ||
| 30 | # The root directory prepended to these options: pki_dir, cachedir, log_file, | 72 | # The root directory prepended to these options: pki_dir, cachedir, log_file, |
| @@ -48,7 +90,7 @@ | |||
| 48 | 90 | ||
| 49 | # Custom static grains for this minion can be specified here and used in SLS | 91 | # Custom static grains for this minion can be specified here and used in SLS |
| 50 | # files just like all other grains. This example sets 4 custom grains, with | 92 | # files just like all other grains. This example sets 4 custom grains, with |
| 51 | # the 'roles' grain having two values that can be matched against: | 93 | # the 'roles' grain having two values that can be matched against. |
| 52 | #grains: | 94 | #grains: |
| 53 | # roles: | 95 | # roles: |
| 54 | # - webserver | 96 | # - webserver |
| @@ -56,36 +98,40 @@ | |||
| 56 | # deployment: datacenter4 | 98 | # deployment: datacenter4 |
| 57 | # cabinet: 13 | 99 | # cabinet: 13 |
| 58 | # cab_u: 14-15 | 100 | # cab_u: 14-15 |
| 59 | 101 | # | |
| 60 | # Where cache data goes | 102 | # Where cache data goes. |
| 103 | # This data may contain sensitive data and should be protected accordingly. | ||
| 61 | #cachedir: /var/cache/salt/minion | 104 | #cachedir: /var/cache/salt/minion |
| 62 | 105 | ||
| 63 | # Verify and set permissions on configuration directories at startup | 106 | # Verify and set permissions on configuration directories at startup. |
| 64 | #verify_env: True | 107 | #verify_env: True |
| 65 | 108 | ||
| 66 | # The minion can locally cache the return data from jobs sent to it, this | 109 | # The minion can locally cache the return data from jobs sent to it, this |
| 67 | # can be a good way to keep track of jobs the minion has executed | 110 | # can be a good way to keep track of jobs the minion has executed |
| 68 | # (on the minion side). By default this feature is disabled, to enable | 111 | # (on the minion side). By default this feature is disabled, to enable, set |
| 69 | # set cache_jobs to True | 112 | # cache_jobs to True. |
| 70 | #cache_jobs: False | 113 | #cache_jobs: False |
| 71 | 114 | ||
| 72 | # set the directory used to hold unix sockets | 115 | # Set the directory used to hold unix sockets. |
| 73 | #sock_dir: /var/run/salt/minion | 116 | #sock_dir: /var/run/salt/minion |
| 74 | 117 | ||
| 75 | # Set the default outputter used by the salt-call command. The default is | 118 | # Set the default outputter used by the salt-call command. The default is |
| 76 | # "nested" | 119 | # "nested". |
| 77 | #output: nested | 120 | #output: nested |
| 78 | # | 121 | # |
| 79 | # By default output is colored, to disable colored output set the color value | 122 | # By default output is colored. To disable colored output, set the color value |
| 80 | # to False | 123 | # to False. |
| 81 | #color: True | 124 | #color: True |
| 82 | 125 | ||
| 126 | # Do not strip off the colored output from nested results and state outputs | ||
| 127 | # (true by default). | ||
| 128 | # strip_colors: False | ||
| 129 | |||
| 83 | # Backup files that are replaced by file.managed and file.recurse under | 130 | # Backup files that are replaced by file.managed and file.recurse under |
| 84 | # 'cachedir'/file_backups relative to their original location and appended | 131 | # 'cachedir'/file_backups relative to their original location and appended |
| 85 | # with a timestamp. The only valid setting is "minion". Disabled by default. | 132 | # with a timestamp. The only valid setting is "minion". Disabled by default. |
| 86 | # | 133 | # |
| 87 | # Alternatively this can be specified for each file in state files: | 134 | # Alternatively this can be specified for each file in state files: |
| 88 | # | ||
| 89 | # /etc/ssh/sshd_config: | 135 | # /etc/ssh/sshd_config: |
| 90 | # file.managed: | 136 | # file.managed: |
| 91 | # - source: salt://ssh/sshd_config | 137 | # - source: salt://ssh/sshd_config |
| @@ -103,27 +149,55 @@ | |||
| 103 | # set to zero, the time between reconnection attempts will stay constant. | 149 | # set to zero, the time between reconnection attempts will stay constant. |
| 104 | #acceptance_wait_time_max: 0 | 150 | #acceptance_wait_time_max: 0 |
| 105 | 151 | ||
| 152 | # If the master rejects the minion's public key, retry instead of exiting. | ||
| 153 | # Rejected keys will be handled the same as waiting on acceptance. | ||
| 154 | #rejected_retry: False | ||
| 155 | |||
| 106 | # When the master key changes, the minion will try to re-auth itself to receive | 156 | # When the master key changes, the minion will try to re-auth itself to receive |
| 107 | # the new master key. In larger environments this can cause a SYN flood on the | 157 | # the new master key. In larger environments this can cause a SYN flood on the |
| 108 | # master because all minions try to re-auth immediately. To prevent this and | 158 | # master because all minions try to re-auth immediately. To prevent this and |
| 109 | # have a minion wait for a random amount of time, use this optional parameter. | 159 | # have a minion wait for a random amount of time, use this optional parameter. |
| 110 | # The wait-time will be a random number of seconds between | 160 | # The wait-time will be a random number of seconds between 0 and the defined value. |
| 111 | # 0 and the defined value. | ||
| 112 | #random_reauth_delay: 60 | 161 | #random_reauth_delay: 60 |
| 113 | 162 | ||
| 163 | # When waiting for a master to accept the minion's public key, salt will | ||
| 164 | # continuously attempt to reconnect until successful. This is the timeout value, | ||
| 165 | # in seconds, for each individual attempt. After this timeout expires, the minion | ||
| 166 | # will wait for acceptance_wait_time seconds before trying again. Unless your master | ||
| 167 | # is under unusually heavy load, this should be left at the default. | ||
| 168 | #auth_timeout: 60 | ||
| 169 | |||
| 170 | # Number of consecutive SaltReqTimeoutError that are acceptable when trying to | ||
| 171 | # authenticate. | ||
| 172 | #auth_tries: 7 | ||
| 173 | |||
| 174 | # If authentication fails due to SaltReqTimeoutError during a ping_interval, | ||
| 175 | # cause sub minion process to restart. | ||
| 176 | #auth_safemode: False | ||
| 177 | |||
| 178 | # Ping Master to ensure connection is alive (minutes). | ||
| 179 | #ping_interval: 0 | ||
| 180 | |||
| 181 | # To auto recover minions if master changes IP address (DDNS) | ||
| 182 | # auth_tries: 10 | ||
| 183 | # auth_safemode: False | ||
| 184 | # ping_interval: 90 | ||
| 185 | # | ||
| 186 | # Minions won't know master is missing until a ping fails. After the ping fail, | ||
| 187 | # the minion will attempt authentication and likely fails out and cause a restart. | ||
| 188 | # When the minion restarts it will resolve the masters IP and attempt to reconnect. | ||
| 114 | 189 | ||
| 115 | # If you don't have any problems with syn-floods, dont bother with the | 190 | # If you don't have any problems with syn-floods, don't bother with the |
| 116 | # three recon_* settings described below, just leave the defaults! | 191 | # three recon_* settings described below, just leave the defaults! |
| 117 | # | 192 | # |
| 118 | # The ZeroMQ pull-socket that binds to the masters publishing interface tries | 193 | # The ZeroMQ pull-socket that binds to the masters publishing interface tries |
| 119 | # to reconnect immediately, if the socket is disconnected (for example if | 194 | # to reconnect immediately, if the socket is disconnected (for example if |
| 120 | # the master processes are restarted). In large setups this will have all | 195 | # the master processes are restarted). In large setups this will have all |
| 121 | # minions reconnect immediately which might flood the master (the ZeroMQ-default | 196 | # minions reconnect immediately which might flood the master (the ZeroMQ-default |
| 122 | # is usually a 100ms delay). To prevent this, these three recon_* settings | 197 | # is usually a 100ms delay). To prevent this, these three recon_* settings |
| 123 | # can be used. | 198 | # can be used. |
| 124 | # | 199 | # recon_default: the interval in milliseconds that the socket should wait before |
| 125 | # recon_default: the interval in milliseconds that the socket should wait before | 200 | # trying to reconnect to the master (1000ms = 1 second) |
| 126 | # trying to reconnect to the master (100ms = 1 second) | ||
| 127 | # | 201 | # |
| 128 | # recon_max: the maximum time a socket should wait. each interval the time to wait | 202 | # recon_max: the maximum time a socket should wait. each interval the time to wait |
| 129 | # is calculated by doubling the previous time. if recon_max is reached, | 203 | # is calculated by doubling the previous time. if recon_max is reached, |
| @@ -136,29 +210,26 @@ | |||
| 136 | # reconnect 5: value from previous interval * 2 | 210 | # reconnect 5: value from previous interval * 2 |
| 137 | # reconnect x: if value >= recon_max, it starts again with recon_default | 211 | # reconnect x: if value >= recon_max, it starts again with recon_default |
| 138 | # | 212 | # |
| 139 | # recon_randomize: generate a random wait time on minion start. The wait time will | 213 | # recon_randomize: generate a random wait time on minion start. The wait time will |
| 140 | # be a random value between recon_default and recon_default + | 214 | # be a random value between recon_default and recon_default + |
| 141 | # recon_max. Having all minions reconnect with the same recon_default | 215 | # recon_max. Having all minions reconnect with the same recon_default |
| 142 | # and recon_max value kind of defeats the purpose of being able to | 216 | # and recon_max value kind of defeats the purpose of being able to |
| 143 | # change these settings. If all minions have the same values and your | 217 | # change these settings. If all minions have the same values and your |
| 144 | # setup is quite large (several thousand minions), they will still | 218 | # setup is quite large (several thousand minions), they will still |
| 145 | # flood the master. The desired behaviour is to have timeframe within | 219 | # flood the master. The desired behavior is to have timeframe within |
| 146 | # all minions try to reconnect. | 220 | # all minions try to reconnect. |
| 147 | 221 | # | |
| 148 | # Example on how to use these settings: | 222 | # Example on how to use these settings. The goal: have all minions reconnect within a |
| 149 | # The goal: have all minions reconnect within a 60 second timeframe on a disconnect | 223 | # 60 second timeframe on a disconnect. |
| 150 | # | 224 | # recon_default: 1000 |
| 151 | # The settings: | 225 | # recon_max: 59000 |
| 152 | #recon_default: 1000 | 226 | # recon_randomize: True |
| 153 | #recon_max: 59000 | ||
| 154 | #recon_randomize: True | ||
| 155 | # | 227 | # |
| 156 | # Each minion will have a randomized reconnect value between 'recon_default' | 228 | # Each minion will have a randomized reconnect value between 'recon_default' |
| 157 | # and 'recon_default + recon_max', which in this example means between 1000ms | 229 | # and 'recon_default + recon_max', which in this example means between 1000ms |
| 158 | # 60000ms (or between 1 and 60 seconds). The generated random-value will be | 230 | # 60000ms (or between 1 and 60 seconds). The generated random-value will be |
| 159 | # doubled after each attempt to reconnect. Lets say the generated random | 231 | # doubled after each attempt to reconnect. Lets say the generated random |
| 160 | # value is 11 seconds (or 11000ms). | 232 | # value is 11 seconds (or 11000ms). |
| 161 | # | ||
| 162 | # reconnect 1: wait 11 seconds | 233 | # reconnect 1: wait 11 seconds |
| 163 | # reconnect 2: wait 22 seconds | 234 | # reconnect 2: wait 22 seconds |
| 164 | # reconnect 3: wait 33 seconds | 235 | # reconnect 3: wait 33 seconds |
| @@ -172,29 +243,68 @@ | |||
| 172 | # | 243 | # |
| 173 | # In a setup with ~6000 thousand hosts these settings would average the reconnects | 244 | # In a setup with ~6000 thousand hosts these settings would average the reconnects |
| 174 | # to about 100 per second and all hosts would be reconnected within 60 seconds. | 245 | # to about 100 per second and all hosts would be reconnected within 60 seconds. |
| 175 | #recon_default: 100 | 246 | # recon_default: 100 |
| 176 | #recon_max: 5000 | 247 | # recon_max: 5000 |
| 177 | #recon_randomize: False | 248 | # recon_randomize: False |
| 178 | 249 | # | |
| 250 | # | ||
| 179 | # The loop_interval sets how long in seconds the minion will wait between | 251 | # The loop_interval sets how long in seconds the minion will wait between |
| 180 | # evaluating the scheduler and running cleanup tasks. This defaults to a | 252 | # evaluating the scheduler and running cleanup tasks. This defaults to a |
| 181 | # sane 60 seconds, but if the minion scheduler needs to be evaluated more | 253 | # sane 60 seconds, but if the minion scheduler needs to be evaluated more |
| 182 | # often lower this value | 254 | # often lower this value |
| 183 | #loop_interval: 60 | 255 | #loop_interval: 60 |
| 184 | 256 | ||
| 185 | # When healing, a dns_check is run. This is to make sure that the originally | 257 | # The grains can be merged, instead of overridden, using this option. |
| 186 | # resolved dns has not changed. If this is something that does not happen in | 258 | # This allows custom grains to defined different subvalues of a dictionary |
| 187 | # your environment, set this value to False. | 259 | # grain. By default this feature is disabled, to enable set grains_deep_merge |
| 188 | #dns_check: True | 260 | # to ``True``. |
| 261 | #grains_deep_merge: False | ||
| 262 | |||
| 263 | # The grains_refresh_every setting allows for a minion to periodically check | ||
| 264 | # its grains to see if they have changed and, if so, to inform the master | ||
| 265 | # of the new grains. This operation is moderately expensive, therefore | ||
| 266 | # care should be taken not to set this value too low. | ||
| 267 | # | ||
| 268 | # Note: This value is expressed in __minutes__! | ||
| 269 | # | ||
| 270 | # A value of 10 minutes is a reasonable default. | ||
| 271 | # | ||
| 272 | # If the value is set to zero, this check is disabled. | ||
| 273 | #grains_refresh_every: 1 | ||
| 274 | |||
| 275 | # Cache grains on the minion. Default is False. | ||
| 276 | #grains_cache: False | ||
| 277 | |||
| 278 | # Cache rendered pillar data on the minion. Default is False. | ||
| 279 | # This may cause 'cachedir'/pillar to contain sensitive data that should be | ||
| 280 | # protected accordingly. | ||
| 281 | #minion_pillar_cache: False | ||
| 282 | |||
| 283 | # Grains cache expiration, in seconds. If the cache file is older than this | ||
| 284 | # number of seconds then the grains cache will be dumped and fully re-populated | ||
| 285 | # with fresh data. Defaults to 5 minutes. Will have no effect if 'grains_cache' | ||
| 286 | # is not enabled. | ||
| 287 | # grains_cache_expiration: 300 | ||
| 189 | 288 | ||
| 190 | # Windows platforms lack posix IPC and must rely on slower TCP based inter- | 289 | # Windows platforms lack posix IPC and must rely on slower TCP based inter- |
| 191 | # process communications. Set ipc_mode to 'tcp' on such systems | 290 | # process communications. Set ipc_mode to 'tcp' on such systems |
| 192 | #ipc_mode: ipc | 291 | #ipc_mode: ipc |
| 193 | # | 292 | |
| 194 | # Overwrite the default tcp ports used by the minion when in tcp mode | 293 | # Overwrite the default tcp ports used by the minion when in tcp mode |
| 195 | #tcp_pub_port: 4510 | 294 | #tcp_pub_port: 4510 |
| 196 | #tcp_pull_port: 4511 | 295 | #tcp_pull_port: 4511 |
| 197 | 296 | ||
| 297 | # Passing very large events can cause the minion to consume large amounts of | ||
| 298 | # memory. This value tunes the maximum size of a message allowed onto the | ||
| 299 | # minion event bus. The value is expressed in bytes. | ||
| 300 | #max_event_size: 1048576 | ||
| 301 | |||
| 302 | # To detect failed master(s) and fire events on connect/disconnect, set | ||
| 303 | # master_alive_interval to the number of seconds to poll the masters for | ||
| 304 | # connection events. | ||
| 305 | # | ||
| 306 | #master_alive_interval: 30 | ||
| 307 | |||
| 198 | # The minion can include configuration from other files. To enable this, | 308 | # The minion can include configuration from other files. To enable this, |
| 199 | # pass a list of paths to this option. The paths can be either relative or | 309 | # pass a list of paths to this option. The paths can be either relative or |
| 200 | # absolute; if relative, they are considered to be relative to the directory | 310 | # absolute; if relative, they are considered to be relative to the directory |
| @@ -202,7 +312,6 @@ | |||
| 202 | # of shell-style globbing. If no files are matched by a path passed to this | 312 | # of shell-style globbing. If no files are matched by a path passed to this |
| 203 | # option then the minion will log a warning message. | 313 | # option then the minion will log a warning message. |
| 204 | # | 314 | # |
| 205 | # | ||
| 206 | # Include a config file from some other path: | 315 | # Include a config file from some other path: |
| 207 | # include: /etc/salt/extra_config | 316 | # include: /etc/salt/extra_config |
| 208 | # | 317 | # |
| @@ -210,11 +319,13 @@ | |||
| 210 | #include: | 319 | #include: |
| 211 | # - /etc/salt/extra_config | 320 | # - /etc/salt/extra_config |
| 212 | # - /etc/roles/webserver | 321 | # - /etc/roles/webserver |
| 213 | 322 | # | |
| 323 | # | ||
| 324 | # | ||
| 214 | ##### Minion module management ##### | 325 | ##### Minion module management ##### |
| 215 | ########################################## | 326 | ########################################## |
| 216 | # Disable specific modules. This allows the admin to limit the level of | 327 | # Disable specific modules. This allows the admin to limit the level of |
| 217 | # access the master has to the minion | 328 | # access the master has to the minion. |
| 218 | #disable_modules: [cmd,test] | 329 | #disable_modules: [cmd,test] |
| 219 | #disable_returners: [] | 330 | #disable_returners: [] |
| 220 | # | 331 | # |
| @@ -226,18 +337,22 @@ | |||
| 226 | #returner_dirs: [] | 337 | #returner_dirs: [] |
| 227 | #states_dirs: [] | 338 | #states_dirs: [] |
| 228 | #render_dirs: [] | 339 | #render_dirs: [] |
| 340 | #utils_dirs: [] | ||
| 229 | # | 341 | # |
| 230 | # A module provider can be statically overwritten or extended for the minion | 342 | # A module provider can be statically overwritten or extended for the minion |
| 231 | # via the providers option, in this case the default module will be | 343 | # via the providers option, in this case the default module will be |
| 232 | # overwritten by the specified module. In this example the pkg module will | 344 | # overwritten by the specified module. In this example the pkg module will |
| 233 | # be provided by the yumpkg5 module instead of the system default. | 345 | # be provided by the yumpkg5 module instead of the system default. |
| 234 | # | ||
| 235 | #providers: | 346 | #providers: |
| 236 | # pkg: yumpkg5 | 347 | # pkg: yumpkg5 |
| 237 | # | 348 | # |
| 238 | # Enable Cython modules searching and loading. (Default: False) | 349 | # Enable Cython modules searching and loading. (Default: False) |
| 239 | #cython_enable: False | 350 | #cython_enable: False |
| 240 | # | 351 | # |
| 352 | # Specify a max size (in bytes) for modules on import. This feature is currently | ||
| 353 | # only supported on *nix operating systems and requires psutil. | ||
| 354 | # modules_max_memory: -1 | ||
| 355 | |||
| 241 | 356 | ||
| 242 | ##### State Management Settings ##### | 357 | ##### State Management Settings ##### |
| 243 | ########################################### | 358 | ########################################### |
| @@ -256,21 +371,19 @@ | |||
| 256 | #renderer: yaml_jinja | 371 | #renderer: yaml_jinja |
| 257 | # | 372 | # |
| 258 | # The failhard option tells the minions to stop immediately after the first | 373 | # The failhard option tells the minions to stop immediately after the first |
| 259 | # failure detected in the state execution, defaults to False | 374 | # failure detected in the state execution. Defaults to False. |
| 260 | #failhard: False | 375 | #failhard: False |
| 261 | # | 376 | # |
| 262 | # autoload_dynamic_modules Turns on automatic loading of modules found in the | 377 | # Reload the modules prior to a highstate run. |
| 263 | # environments on the master. This is turned on by default, to turn of | ||
| 264 | # autoloading modules when states run set this value to False | ||
| 265 | #autoload_dynamic_modules: True | 378 | #autoload_dynamic_modules: True |
| 266 | # | 379 | # |
| 267 | # clean_dynamic_modules keeps the dynamic modules on the minion in sync with | 380 | # clean_dynamic_modules keeps the dynamic modules on the minion in sync with |
| 268 | # the dynamic modules on the master, this means that if a dynamic module is | 381 | # the dynamic modules on the master, this means that if a dynamic module is |
| 269 | # not on the master it will be deleted from the minion. By default this is | 382 | # not on the master it will be deleted from the minion. By default, this is |
| 270 | # enabled and can be disabled by changing this value to False | 383 | # enabled and can be disabled by changing this value to False. |
| 271 | #clean_dynamic_modules: True | 384 | #clean_dynamic_modules: True |
| 272 | # | 385 | # |
| 273 | # Normally the minion is not isolated to any single environment on the master | 386 | # Normally, the minion is not isolated to any single environment on the master |
| 274 | # when running states, but the environment can be isolated on the minion side | 387 | # when running states, but the environment can be isolated on the minion side |
| 275 | # by statically setting it. Remember that the recommended way to manage | 388 | # by statically setting it. Remember that the recommended way to manage |
| 276 | # environments is to isolate via the top file. | 389 | # environments is to isolate via the top file. |
| @@ -286,14 +399,23 @@ | |||
| 286 | # 'top' -- Read top_file option and execute based on that file on the Master | 399 | # 'top' -- Read top_file option and execute based on that file on the Master |
| 287 | #startup_states: '' | 400 | #startup_states: '' |
| 288 | # | 401 | # |
| 289 | # list of states to run when the minion starts up if startup_states is 'sls' | 402 | # List of states to run when the minion starts up if startup_states is 'sls': |
| 290 | #sls_list: | 403 | #sls_list: |
| 291 | # - edit.vim | 404 | # - edit.vim |
| 292 | # - hyper | 405 | # - hyper |
| 293 | # | 406 | # |
| 294 | # top file to execute if startup_states is 'top' | 407 | # Top file to execute if startup_states is 'top': |
| 295 | #top_file: '' | 408 | #top_file: '' |
| 296 | 409 | ||
| 410 | # Automatically aggregate all states that have support for mod_aggregate by | ||
| 411 | # setting to True. Or pass a list of state module names to automatically | ||
| 412 | # aggregate just those types. | ||
| 413 | # | ||
| 414 | # state_aggregate: | ||
| 415 | # - pkg | ||
| 416 | # | ||
| 417 | #state_aggregate: False | ||
| 418 | |||
| 297 | ##### File Directory Settings ##### | 419 | ##### File Directory Settings ##### |
| 298 | ########################################## | 420 | ########################################## |
| 299 | # The Salt Minion can redirect all file server operations to a local directory, | 421 | # The Salt Minion can redirect all file server operations to a local directory, |
| @@ -303,7 +425,8 @@ | |||
| 303 | 425 | ||
| 304 | # Set the file client. The client defaults to looking on the master server for | 426 | # Set the file client. The client defaults to looking on the master server for |
| 305 | # files, but can be directed to look at the local file directory setting | 427 | # files, but can be directed to look at the local file directory setting |
| 306 | # defined below by setting it to local. | 428 | # defined below by setting it to "local". Setting a local file_client runs the |
| 429 | # minion in masterless mode. | ||
| 307 | #file_client: remote | 430 | #file_client: remote |
| 308 | 431 | ||
| 309 | # The file directory works on environments passed to the minion, each environment | 432 | # The file directory works on environments passed to the minion, each environment |
| @@ -329,15 +452,16 @@ | |||
| 329 | # to attempt to find files. To limit this behavior so that the fileserver only | 452 | # to attempt to find files. To limit this behavior so that the fileserver only |
| 330 | # traverses directories with SLS files and special Salt directories like _modules, | 453 | # traverses directories with SLS files and special Salt directories like _modules, |
| 331 | # enable the option below. This might be useful for installations where a file root | 454 | # enable the option below. This might be useful for installations where a file root |
| 332 | # has a very large number of files and performance is negatively impacted. | 455 | # has a very large number of files and performance is negatively impacted. Default |
| 333 | # | 456 | # is False. |
| 334 | # Default is False. | 457 | #fileserver_limit_traversal: False |
| 335 | # | ||
| 336 | # fileserver_limit_traversal: False | ||
| 337 | 458 | ||
| 338 | # The hash_type is the hash to use when discovering the hash of a file in | 459 | # The hash_type is the hash to use when discovering the hash of a file in |
| 339 | # the local fileserver. The default is md5, but sha1, sha224, sha256, sha384 | 460 | # the local fileserver. The default is md5, but sha1, sha224, sha256, sha384 |
| 340 | # and sha512 are also supported. | 461 | # and sha512 are also supported. |
| 462 | # | ||
| 463 | # Warning: Prior to changing this value, the minion should be stopped and all | ||
| 464 | # Salt caches should be cleared. | ||
| 341 | #hash_type: md5 | 465 | #hash_type: md5 |
| 342 | 466 | ||
| 343 | # The Salt pillar is searched for locally if file_client is set to local. If | 467 | # The Salt pillar is searched for locally if file_client is set to local. If |
| @@ -346,7 +470,8 @@ | |||
| 346 | #pillar_roots: | 470 | #pillar_roots: |
| 347 | # base: | 471 | # base: |
| 348 | # - /srv/pillar | 472 | # - /srv/pillar |
| 349 | 473 | # | |
| 474 | # | ||
| 350 | ###### Security settings ##### | 475 | ###### Security settings ##### |
| 351 | ########################################### | 476 | ########################################### |
| 352 | # Enable "open mode", this mode still maintains encryption, but turns off | 477 | # Enable "open mode", this mode still maintains encryption, but turns off |
| @@ -366,23 +491,34 @@ | |||
| 366 | # The state_verbose setting can be set to True or False, when set to False | 491 | # The state_verbose setting can be set to True or False, when set to False |
| 367 | # all data that has a result of True and no changes will be suppressed. | 492 | # all data that has a result of True and no changes will be suppressed. |
| 368 | #state_verbose: True | 493 | #state_verbose: True |
| 369 | # | 494 | |
| 370 | # The state_output setting changes if the output is the full multi line | 495 | # The state_output setting changes if the output is the full multi line |
| 371 | # output for each changed state if set to 'full', but if set to 'terse' | 496 | # output for each changed state if set to 'full', but if set to 'terse' |
| 372 | # the output will be shortened to a single line. | 497 | # the output will be shortened to a single line. |
| 373 | #state_output: full | 498 | #state_output: full |
| 374 | # | 499 | |
| 375 | # Fingerprint of the master public key to double verify the master is valid, | 500 | # The state_output_diff setting changes whether or not the output from |
| 376 | # the master fingerprint can be found by running "salt-key -F master" on the | 501 | # successful states is returned. Useful when even the terse output of these |
| 377 | # salt master. | 502 | # states is cluttering the logs. Set it to True to ignore them. |
| 503 | #state_output_diff: False | ||
| 504 | |||
| 505 | # The state_output_profile setting changes whether profile information | ||
| 506 | # will be shown for each state run. | ||
| 507 | #state_output_profile: True | ||
| 508 | |||
| 509 | # Fingerprint of the master public key to validate the identity of your Salt master | ||
| 510 | # before the initial key exchange. The master fingerprint can be found by running | ||
| 511 | # "salt-key -F master" on the Salt master. | ||
| 378 | #master_finger: '' | 512 | #master_finger: '' |
| 379 | 513 | ||
| 514 | |||
| 380 | ###### Thread settings ##### | 515 | ###### Thread settings ##### |
| 381 | ########################################### | 516 | ########################################### |
| 382 | # Disable multiprocessing support, by default when a minion receives a | 517 | # Disable multiprocessing support, by default when a minion receives a |
| 383 | # publication a new process is spawned and the command is executed therein. | 518 | # publication a new process is spawned and the command is executed therein. |
| 384 | #multiprocessing: True | 519 | #multiprocessing: True |
| 385 | 520 | ||
| 521 | |||
| 386 | ##### Logging settings ##### | 522 | ##### Logging settings ##### |
| 387 | ########################################## | 523 | ########################################## |
| 388 | # The location of the minion log file | 524 | # The location of the minion log file |
| @@ -396,14 +532,19 @@ | |||
| 396 | # | 532 | # |
| 397 | #log_file: /var/log/salt/minion | 533 | #log_file: /var/log/salt/minion |
| 398 | #key_logfile: /var/log/salt/key | 534 | #key_logfile: /var/log/salt/key |
| 399 | # | 535 | |
| 400 | # The level of messages to send to the console. | 536 | # The level of messages to send to the console. |
| 401 | # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'. | 537 | # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'. |
| 538 | # | ||
| 539 | # The following log levels are considered INSECURE and may log sensitive data: | ||
| 540 | # ['garbage', 'trace', 'debug'] | ||
| 541 | # | ||
| 402 | # Default: 'warning' | 542 | # Default: 'warning' |
| 403 | #log_level: warning | 543 | #log_level: warning |
| 404 | # | 544 | |
| 405 | # The level of messages to send to the log file. | 545 | # The level of messages to send to the log file. |
| 406 | # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'. | 546 | # One of 'garbage', 'trace', 'debug', info', 'warning', 'error', 'critical'. |
| 547 | # If using 'log_granular_levels' this must be set to the highest desired level. | ||
| 407 | # Default: 'warning' | 548 | # Default: 'warning' |
| 408 | #log_level_logfile: | 549 | #log_level_logfile: |
| 409 | 550 | ||
| @@ -411,21 +552,54 @@ | |||
| 411 | # can be seen here: http://docs.python.org/library/time.html#time.strftime | 552 | # can be seen here: http://docs.python.org/library/time.html#time.strftime |
| 412 | #log_datefmt: '%H:%M:%S' | 553 | #log_datefmt: '%H:%M:%S' |
| 413 | #log_datefmt_logfile: '%Y-%m-%d %H:%M:%S' | 554 | #log_datefmt_logfile: '%Y-%m-%d %H:%M:%S' |
| 414 | # | 555 | |
| 415 | # The format of the console logging messages. Allowed formatting options can | 556 | # The format of the console logging messages. Allowed formatting options can |
| 416 | # be seen here: http://docs.python.org/library/logging.html#logrecord-attributes | 557 | # be seen here: http://docs.python.org/library/logging.html#logrecord-attributes |
| 558 | # | ||
| 559 | # Console log colors are specified by these additional formatters: | ||
| 560 | # | ||
| 561 | # %(colorlevel)s | ||
| 562 | # %(colorname)s | ||
| 563 | # %(colorprocess)s | ||
| 564 | # %(colormsg)s | ||
| 565 | # | ||
| 566 | # Since it is desirable to include the surrounding brackets, '[' and ']', in | ||
| 567 | # the coloring of the messages, these color formatters also include padding as | ||
| 568 | # well. Color LogRecord attributes are only available for console logging. | ||
| 569 | # | ||
| 570 | #log_fmt_console: '%(colorlevel)s %(colormsg)s' | ||
| 417 | #log_fmt_console: '[%(levelname)-8s] %(message)s' | 571 | #log_fmt_console: '[%(levelname)-8s] %(message)s' |
| 418 | #log_fmt_logfile: '%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s' | ||
| 419 | # | 572 | # |
| 573 | #log_fmt_logfile: '%(asctime)s,%(msecs)03.0f [%(name)-17s][%(levelname)-8s] %(message)s' | ||
| 574 | |||
| 420 | # This can be used to control logging levels more specificically. This | 575 | # This can be used to control logging levels more specificically. This |
| 421 | # example sets the main salt library at the 'warning' level, but sets | 576 | # example sets the main salt library at the 'warning' level, but sets |
| 422 | # 'salt.modules' to log at the 'debug' level: | 577 | # 'salt.modules' to log at the 'debug' level: |
| 423 | # log_granular_levels: | 578 | # log_granular_levels: |
| 424 | # 'salt': 'warning', | 579 | # 'salt': 'warning' |
| 425 | # 'salt.modules': 'debug' | 580 | # 'salt.modules': 'debug' |
| 426 | # | 581 | # |
| 427 | #log_granular_levels: {} | 582 | #log_granular_levels: {} |
| 428 | 583 | ||
| 584 | # To diagnose issues with minions disconnecting or missing returns, ZeroMQ | ||
| 585 | # supports the use of monitor sockets to log connection events. This | ||
| 586 | # feature requires ZeroMQ 4.0 or higher. | ||
| 587 | # | ||
| 588 | # To enable ZeroMQ monitor sockets, set 'zmq_monitor' to 'True' and log at a | ||
| 589 | # debug level or higher. | ||
| 590 | # | ||
| 591 | # A sample log event is as follows: | ||
| 592 | # | ||
| 593 | # [DEBUG ] ZeroMQ event: {'endpoint': 'tcp://127.0.0.1:4505', 'event': 512, | ||
| 594 | # 'value': 27, 'description': 'EVENT_DISCONNECTED'} | ||
| 595 | # | ||
| 596 | # All events logged will include the string 'ZeroMQ event'. A connection event | ||
| 597 | # should be logged as the minion starts up and initially connects to the | ||
| 598 | # master. If not, check for debug log level and that the necessary version of | ||
| 599 | # ZeroMQ is installed. | ||
| 600 | # | ||
| 601 | #zmq_monitor: False | ||
| 602 | |||
| 429 | ###### Module configuration ##### | 603 | ###### Module configuration ##### |
| 430 | ########################################### | 604 | ########################################### |
| 431 | # Salt allows for modules to be passed arbitrary configuration data, any data | 605 | # Salt allows for modules to be passed arbitrary configuration data, any data |
| @@ -445,8 +619,8 @@ | |||
| 445 | # | 619 | # |
| 446 | # A dict for the test module: | 620 | # A dict for the test module: |
| 447 | #test.baz: {spam: sausage, cheese: bread} | 621 | #test.baz: {spam: sausage, cheese: bread} |
| 448 | 622 | # | |
| 449 | 623 | # | |
| 450 | ###### Update settings ###### | 624 | ###### Update settings ###### |
| 451 | ########################################### | 625 | ########################################### |
| 452 | # Using the features in Esky, a salt minion can both run as a frozen app and | 626 | # Using the features in Esky, a salt minion can both run as a frozen app and |
| @@ -468,27 +642,39 @@ | |||
| 468 | # the risk that it could tear down the connection the master and minion | 642 | # the risk that it could tear down the connection the master and minion |
| 469 | # without informing either party that their connection has been taken away. | 643 | # without informing either party that their connection has been taken away. |
| 470 | # Enabling TCP Keepalives prevents this from happening. | 644 | # Enabling TCP Keepalives prevents this from happening. |
| 471 | # | 645 | |
| 472 | # Overall state of TCP Keepalives, enable (1 or True), disable (0 or False) | 646 | # Overall state of TCP Keepalives, enable (1 or True), disable (0 or False) |
| 473 | # or leave to the OS defaults (-1), on Linux, typically disabled. Default True, enabled. | 647 | # or leave to the OS defaults (-1), on Linux, typically disabled. Default True, enabled. |
| 474 | #tcp_keepalive: True | 648 | #tcp_keepalive: True |
| 475 | # | 649 | |
| 476 | # How long before the first keepalive should be sent in seconds. Default 300 | 650 | # How long before the first keepalive should be sent in seconds. Default 300 |
| 477 | # to send the first keepalive after 5 minutes, OS default (-1) is typically 7200 seconds | 651 | # to send the first keepalive after 5 minutes, OS default (-1) is typically 7200 seconds |
| 478 | # on Linux see /proc/sys/net/ipv4/tcp_keepalive_time. | 652 | # on Linux see /proc/sys/net/ipv4/tcp_keepalive_time. |
| 479 | #tcp_keepalive_idle: 300 | 653 | #tcp_keepalive_idle: 300 |
| 480 | # | 654 | |
| 481 | # How many lost probes are needed to consider the connection lost. Default -1 | 655 | # How many lost probes are needed to consider the connection lost. Default -1 |
| 482 | # to use OS defaults, typically 9 on Linux, see /proc/sys/net/ipv4/tcp_keepalive_probes. | 656 | # to use OS defaults, typically 9 on Linux, see /proc/sys/net/ipv4/tcp_keepalive_probes. |
| 483 | #tcp_keepalive_cnt: -1 | 657 | #tcp_keepalive_cnt: -1 |
| 484 | # | 658 | |
| 485 | # How often, in seconds, to send keepalives after the first one. Default -1 to | 659 | # How often, in seconds, to send keepalives after the first one. Default -1 to |
| 486 | # use OS defaults, typically 75 seconds on Linux, see | 660 | # use OS defaults, typically 75 seconds on Linux, see |
| 487 | # /proc/sys/net/ipv4/tcp_keepalive_intvl. | 661 | # /proc/sys/net/ipv4/tcp_keepalive_intvl. |
| 488 | #tcp_keepalive_intvl: -1 | 662 | #tcp_keepalive_intvl: -1 |
| 489 | 663 | ||
| 490 | 664 | ||
| 491 | ###### Windows Software settings ###### | 665 | ###### Windows Software settings ###### |
| 492 | ############################################ | 666 | ############################################ |
| 493 | # Location of the repository cache file on the master | 667 | # Location of the repository cache file on the master: |
| 494 | #win_repo_cachefile: 'salt://win/repo/winrepo.p' | 668 | #win_repo_cachefile: 'salt://win/repo/winrepo.p' |
| 669 | |||
| 670 | |||
| 671 | ###### Returner settings ###### | ||
| 672 | ############################################ | ||
| 673 | # Which returner(s) will be used for minion's result: | ||
| 674 | #return: mysql | ||
| 675 | |||
| 676 | |||
| 677 | ###### Miscellaneous settings ###### | ||
| 678 | ############################################ | ||
| 679 | # Default match type for filtering events tags: startswith, endswith, find, regex, fnmatch | ||
| 680 | #event_match_type: startswith | ||
