openstack
/
oslo.cache
Code Issues Proposed changes

config: Document backends supporting specific options 

... and shows the backend actually picked up in logs.

Change-Id: Ib19fdd289444a8db5ebc682e7cb5723b994ae9dc
This commit is contained in:
Takashi Kajinami 2024-02-12 20:28:01 +09:00
parent 7bb43bbbd5
commit 76d414e58d
2 changed files with 16 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
oslo_cache/_opts.py
View File

@ -152,7 +152,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'
@ -178,7 +183,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,
@ -246,7 +254,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``.'),
],
}

3
oslo_cache/core.py
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)