Merge "config: Document backends supporting specific options"

This commit is contained in:
Zuul 2024-02-14 13:19:29 +00:00 committed by Gerrit Code Review
commit 98e8de2ec9
2 changed files with 16 additions and 4 deletions

View File

@ -150,7 +150,12 @@ FILE_OPTIONS = {
cfg.BoolOpt('tls_enabled',
default=False,
help='Global toggle for TLS usage when communicating with'
' the caching servers.'),
' the caching servers. Currently supported by '
'``dogpile.cache.bmemcache``, '
'``dogpile.cache.pymemcache``, '
'``oslo_cache.memcache_pool``, '
'``dogpile.cache.redis`` and '
'``dogpile.cache.redis_sentinel``.'),
cfg.StrOpt('tls_cafile',
default=None,
help='Path to a file of concatenated CA certificates in PEM'
@ -176,7 +181,10 @@ FILE_OPTIONS = {
help='Set the available ciphers for sockets created with'
' the TLS context. It should be a string in the OpenSSL'
' cipher list format. If not specified, all OpenSSL enabled'
' ciphers will be available.'),
' ciphers will be available. Currently supported by '
'``dogpile.cache.bmemcache``, '
'``dogpile.cache.pymemcache`` and '
'``oslo_cache.memcache_pool``.'),
cfg.BoolOpt(
'enable_socket_keepalive',
default=False,
@ -244,7 +252,10 @@ FILE_OPTIONS = {
'environments and may have been backported to older '
'Python versions on select environments. If the Python '
'executable used does not support OpenSSL FIPS mode, '
'an exception will be raised.'),
'an exception will be raised. Currently supported by '
'``dogpile.cache.bmemcache``, '
'``dogpile.cache.pymemcache`` and '
'``oslo_cache.memcache_pool``.'),
],
}

View File

@ -299,7 +299,8 @@ def _build_cache_config(conf):
{}).update(conn_kwargs)
else:
msg = _(
"TLS setting via [cache] tls_enabled is not supported by this "
"TLS setting via [cache] tls_enabled is not supported by the "
"%s backend. Set [cache] tls_enabled=False or use a different "
"backend."
)
raise exception.ConfigurationError(msg)