doc: specify seconds in proxy-server.conf-sample

Most of swift's timing configuration values should accept units in
seconds; make this explicit in the sample config for values that did not
already do so.

Related-Change-Id: I38c11b7aae8c4112bb3d671fa96012ab0c44d5a2
Change-Id: I5b25b7e830a31f03d11f371adf12289222222eb2
Signed-off-by: Clay Gerrard <clay.gerrard@gmail.com>
This commit is contained in:
Clay Gerrard
2025-09-30 12:32:18 -05:00
parent d9883d0834
commit 389747a8b2

View File

@@ -1,7 +1,9 @@
[DEFAULT] [DEFAULT]
# bind_ip = 0.0.0.0 # bind_ip = 0.0.0.0
bind_port = 8080 bind_port = 8080
# Connection idle timeout (in seconds)
# keep_idle = 600 # keep_idle = 600
# Socket bind timeout (in seconds)
# bind_timeout = 30 # bind_timeout = 30
# backlog = 4096 # backlog = 4096
# swift_dir = /etc/swift # swift_dir = /etc/swift
@@ -180,7 +182,9 @@ use = egg:swift#proxy
# require_proxy_protocol = false # require_proxy_protocol = false
# #
# log_handoffs = true # log_handoffs = true
# How long (in seconds) to cache account existence information
# recheck_account_existence = 60 # recheck_account_existence = 60
# How long (in seconds) to cache container existence information
# recheck_container_existence = 60 # recheck_container_existence = 60
# #
# How long the proxy should cache a set of shard ranges for a container when # How long the proxy should cache a set of shard ranges for a container when
@@ -213,23 +217,24 @@ use = egg:swift#proxy
# usage of cooperative token and directly talk to the backend and memcache. # usage of cooperative token and directly talk to the backend and memcache.
# namespace_cache_tokens_per_session = 3 # namespace_cache_tokens_per_session = 3
# #
# The average time spent on getting updating namespaces from the container # The average time spent (in seconds) on getting updating namespaces from the
# servers, this will be used as basic unit for cooperative token to figure out # container servers, this will be used as basic unit for cooperative token to
# intervals for the retries when requests didn't acquire a token and are # figure out intervals for the retries when requests didn't acquire a token and
# waiting for other requests to fill in the cache; and a cooperative token # are waiting for other requests to fill in the cache; and a cooperative token
# session (`token_ttl`) will be 10 times of this value. # session (`token_ttl`) will be 10 times of this value.
# namespace_avg_backend_fetch_time = 0.3 # namespace_avg_backend_fetch_time = 0.3
# #
# object_chunk_size = 65536 # object_chunk_size = 65536
# client_chunk_size = 65536 # client_chunk_size = 65536
# #
# How long the proxy server will wait on responses from the a/c/o servers. # How long (in seconds) the proxy server will wait on responses from the a/c/o
# servers.
# node_timeout = 10 # node_timeout = 10
# #
# How long the proxy server will wait for an initial response and to read a # How long (in seconds) the proxy server will wait for an initial response and
# chunk of data from the object servers while serving GET / HEAD requests. # to read a chunk of data from the object servers while serving GET / HEAD
# Timeouts from these requests can be recovered from so setting this to # requests. Timeouts from these requests can be recovered from so setting this
# something lower than node_timeout would provide quicker error recovery # to something lower than node_timeout would provide quicker error recovery
# while allowing for a longer timeout for non-recoverable requests (PUTs). # while allowing for a longer timeout for non-recoverable requests (PUTs).
# Does not apply to requests with a truthy X-Newest header value. # Does not apply to requests with a truthy X-Newest header value.
# Defaults to node_timeout, should be overridden if node_timeout is set to a # Defaults to node_timeout, should be overridden if node_timeout is set to a
@@ -237,13 +242,16 @@ use = egg:swift#proxy
# has a chance to retry. # has a chance to retry.
# recoverable_node_timeout = node_timeout # recoverable_node_timeout = node_timeout
# #
# Connection timeout (in seconds)
# conn_timeout = 0.5 # conn_timeout = 0.5
# #
# How long to wait for requests to finish after a quorum has been established. # How long (in seconds) to wait for requests to finish after a quorum has been
# established.
# post_quorum_timeout = 0.5 # post_quorum_timeout = 0.5
# #
# How long without an error before a node's error count is reset. This will # How long (in seconds) without an error before a node's error count is reset.
# also be how long before a node is reenabled after suppression is triggered. # This will also be how long before a node is reenabled after suppression is
# triggered.
# Set to 0 to disable error-limiting. # Set to 0 to disable error-limiting.
# error_suppression_interval = 60.0 # error_suppression_interval = 60.0
# #
@@ -301,11 +309,11 @@ use = egg:swift#proxy
# contexts this will be the first backend replica to respond. # contexts this will be the first backend replica to respond.
# concurrent_gets = off # concurrent_gets = off
# #
# This parameter controls how long to wait before firing off the next # This parameter controls how long (in seconds) to wait before firing off the
# concurrent_get thread. A value of 0 would be fully concurrent, any other # next concurrent_get thread. A value of 0 would be fully concurrent, any other
# number will stagger the firing of the threads. This number should be # number will stagger the firing of the threads. This number should be between
# between 0 and node_timeout. The default is what ever you set for the # 0 and node_timeout. The default is what ever you set for the conn_timeout
# conn_timeout parameter. # parameter.
# concurrency_timeout = 0.5 # concurrency_timeout = 0.5
# #
# By default on a EC GET request swift will connect to a minimum number of # By default on a EC GET request swift will connect to a minimum number of
@@ -459,6 +467,7 @@ use = egg:swift#tempauth
# The auth prefix will cause requests beginning with this prefix to be routed # The auth prefix will cause requests beginning with this prefix to be routed
# to the auth subsystem, for granting tokens, etc. # to the auth subsystem, for granting tokens, etc.
# auth_prefix = /auth/ # auth_prefix = /auth/
# Token lifetime (in seconds)
# token_life = 86400 # token_life = 86400
# #
# This allows middleware higher in the WSGI pipeline to override auth # This allows middleware higher in the WSGI pipeline to override auth
@@ -771,7 +780,7 @@ delay_auth_decision = False
# configured: in particular, the Keystone API version must be included. # configured: in particular, the Keystone API version must be included.
auth_uri = http://keystonehost:5000/v3 auth_uri = http://keystonehost:5000/v3
# Connect/read timeout to use when communicating with Keystone # Connect/read timeout (in seconds) to use when communicating with Keystone
http_timeout = 10.0 http_timeout = 10.0
# Number of seconds to cache the S3 secret. By setting this to a positive # Number of seconds to cache the S3 secret. By setting this to a positive
@@ -835,9 +844,9 @@ use = egg:swift#memcache
# Sets the maximum number of connections to each memcached server per worker # Sets the maximum number of connections to each memcached server per worker
# memcache_max_connections = 2 # memcache_max_connections = 2
# #
# How long without an error before a server's error count is reset. This will # How long (in seconds) without an error before a server's error count is
# also be how long before a server is reenabled after suppression is triggered. # reset. This will also be how long before a server is reenabled after
# Set to 0 to disable error-limiting. # suppression is triggered. Set to 0 to disable error-limiting.
# error_suppression_interval = 60.0 # error_suppression_interval = 60.0
# #
# How many errors can accumulate before a server is temporarily ignored. # How many errors can accumulate before a server is temporarily ignored.
@@ -1260,7 +1269,7 @@ use = egg:swift#xprofile
# log_filename_prefix = /tmp/log/swift/profile/default.profile # log_filename_prefix = /tmp/log/swift/profile/default.profile
# #
# the profile data will be dumped to local disk based on above naming rule # the profile data will be dumped to local disk based on above naming rule
# in this interval. # in this interval (in seconds).
# dump_interval = 5.0 # dump_interval = 5.0
# #
# Be careful, this option will enable profiler to dump data into the file with # Be careful, this option will enable profiler to dump data into the file with