Skip to content

Conversation

@bneradt
Copy link
Contributor

@bneradt bneradt commented Aug 1, 2025

In the 10.0.0 release, we renamed proxy.config.ssl.session_cache.enabled to proxy.config.ssl.session_cache.value because enabled seemed incorrect for a configuration that took a non-boolean enumeration of values. We accidentially left the documentation describing
proxy.config.ssl.session_cache.enabled, however. In discussion about this, we decided to rename such configurations to "mode" instead of value. Another issue (#12412) records making these renames for 11.0.0. This PR just addresses the current issues with
proxy.config.ssl.session_cache.enabled by:

  • Adding implementation support for proxy.config.ssl.session_cache.enabled since we documented that already but document it as deprecated.
  • Keep implementation support for proxy.config.ssl.session_cache.value since users might be using that.
  • Add proxy.config.ssl.session_cache.mode as the preferred new mode.

The user can set values for any of these via:

  • implicit default config values,
  • plugin default values via TSMgmtIntCreate,
  • explicit records.yaml values, or
  • override via environment variable.

It will probably be a very rare user that implements any of these across values, but in case they do, this patch implements a selection of the finally chosen config value based on a priority base of the above, with "mode" valued over "value" valued over "enabled".

Fixes: #11901

@bneradt bneradt added this to the 10.2.0 milestone Aug 1, 2025
@bneradt bneradt requested review from ezelkow1 and maskit August 1, 2025 23:53
@bneradt bneradt self-assigned this Aug 1, 2025
@bneradt bneradt force-pushed the fix_session_server_cache_config branch from 68a6345 to 5368a96 Compare August 1, 2025 23:53
@bneradt bneradt changed the title ssl.session_cache.mode proxy.config.ssl.session_cache.mode Aug 1, 2025
@bneradt bneradt force-pushed the fix_session_server_cache_config branch 2 times, most recently from 78b8ff8 to 8ce35de Compare August 2, 2025 00:11
In the 10.0.0 release, we renamed proxy.config.ssl.session_cache.enabled
to proxy.config.ssl.session_cache.value because enabled seemed incorrect
for a configuration that took a non-boolean enumeration of values. We
accidentially left the documentation describing
proxy.config.ssl.session_cache.enabled, however. In discussion about
this, we decided to rename such configurations to "mode" instead of
value. Another issue (apache#12412) records making these renames for 11.0.0.
This PR just addresses the current issues with
proxy.config.ssl.session_cache.enabled by:

* Adding implementation support for
  proxy.config.ssl.session_cache.enabled since we documented that
  already but document it as deprecated.
* Keep implementation support for proxy.config.ssl.session_cache.value
  since users might be using that.
* Add proxy.config.ssl.session_cache.mode as the preferred new mode.

The user can set values for any of these via:

* implicit default config values,
* plugin default values via TSMgmtIntCreate,
* explicit records.yaml values, or
* override via environment variable.

It will probably be a very rare user that implements any of these across
values, but in case they do, this patch implements a selection of the
finally chosen config value based on a priority base of the above, with
"mode" valued over "value" valued over "enabled".

Fixes: 11901
@bneradt bneradt force-pushed the fix_session_server_cache_config branch from 8ce35de to 60911a5 Compare August 2, 2025 02:59
@bneradt bneradt merged commit 87bb602 into apache:master Aug 4, 2025
15 checks passed
@bneradt bneradt deleted the fix_session_server_cache_config branch August 4, 2025 16:44
@github-project-automation github-project-automation bot moved this to For v10.1.0 in ATS v10.1.x Aug 4, 2025
bneradt added a commit to bneradt/trafficserver that referenced this pull request Aug 4, 2025
In the 10.0.0 release, we renamed proxy.config.ssl.session_cache.enabled
to proxy.config.ssl.session_cache.value because enabled seemed incorrect
for a configuration that took a non-boolean enumeration of values. We
accidentially left the documentation describing
proxy.config.ssl.session_cache.enabled, however. In discussion about
this, we decided to rename such configurations to "mode" instead of
value. Another issue (apache#12412) records making these renames for 11.0.0.
This PR just addresses the current issues with
proxy.config.ssl.session_cache.enabled by:

* Adding implementation support for
  proxy.config.ssl.session_cache.enabled since we documented that
  already but document it as deprecated.
* Keep implementation support for proxy.config.ssl.session_cache.value
  since users might be using that.
* Add proxy.config.ssl.session_cache.mode as the preferred new mode.

The user can set values for any of these via:

* implicit default config values,
* plugin default values via TSMgmtIntCreate,
* explicit records.yaml values, or
* override via environment variable.

It will probably be a very rare user that implements any of these across
values, but in case they do, this patch implements a selection of the
finally chosen config value based on a priority base of the above, with
"mode" valued over "value" valued over "enabled".

Fixes: apache#11901
(cherry picked from commit 87bb602)
cmcfarlen pushed a commit that referenced this pull request Aug 5, 2025
In the 10.0.0 release, we renamed proxy.config.ssl.session_cache.enabled
to proxy.config.ssl.session_cache.value because enabled seemed incorrect
for a configuration that took a non-boolean enumeration of values. We
accidentially left the documentation describing
proxy.config.ssl.session_cache.enabled, however. In discussion about
this, we decided to rename such configurations to "mode" instead of
value. Another issue (#12412) records making these renames for 11.0.0.
This PR just addresses the current issues with
proxy.config.ssl.session_cache.enabled by:

* Adding implementation support for
  proxy.config.ssl.session_cache.enabled since we documented that
  already but document it as deprecated.
* Keep implementation support for proxy.config.ssl.session_cache.value
  since users might be using that.
* Add proxy.config.ssl.session_cache.mode as the preferred new mode.

The user can set values for any of these via:

* implicit default config values,
* plugin default values via TSMgmtIntCreate,
* explicit records.yaml values, or
* override via environment variable.

It will probably be a very rare user that implements any of these across
values, but in case they do, this patch implements a selection of the
finally chosen config value based on a priority base of the above, with
"mode" valued over "value" valued over "enabled".

Fixes: #11901
(cherry picked from commit 87bb602)
@cmcfarlen cmcfarlen removed this from ATS v10.1.x Aug 5, 2025
@cmcfarlen cmcfarlen removed this from the 10.2.0 milestone Aug 5, 2025
@cmcfarlen
Copy link
Contributor

Milestone 10.1.0 via #12419

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ssl.session_cache.enabled unknown

4 participants