Proxy Caching Advanced

Overview Get started Configuration reference Changelog API reference

Changelog

Added the Redis config.redis.cluster_max_redirections configuration option.
Fixed an issue where the Age header was not being updated correctly when serving cached requests.
The following parameters have been deprecated:
- config.redis.cluster_addresses has been deprecated and replaced by config.redis.cluster_nodes.
- config.redis.sentinel_addresses has been deprecated and replaced by config.redis.sentinel_nodes.
- The config.timeout config field in Redis configuration has been deprecated and replaced with config.connect_timeout, config.send_timeout, and config.read_timeout. The deprecated config.timeout field will be removed in an upcoming major version.

This plugin can now be scoped to Consumer Groups.
Removed the undesired proxy-cache-advanced/migrations/001_035_to_050.lua file, which blocked migration from OSS to Enterprise. This is a breaking change only if you are upgrading from a Kong Gateway version between 0.3.5 and 0.5.0.

Added support for integrating with Redis clusters using the config.redis.cluster_addresses configuration parameter.
The plugin now catches the error when Kong Gateway connects to Redis SSL port 6379 with config.ssl=false.

This plugin doesn’t store response data in ngx.ctx.proxy_cache_hit anymore. Logging plugins that need the response data must now read it from kong.ctx.shared.proxy_cache_hit.

Added Redis ACL support (Redis v6.0.0+ and Redis Sentinel v6.2.0+).
Added the config.redis.sentinel_username and config.redis.sentinel_password configuration parameters.
The config.redis.password, config.redis.sentinel_username, and config.redis.sentinel_password configuration fields are now marked as referenceable, which means they can be securely stored as secrets in a Vault. References must follow a specific format.
Fixed the error function cannot be called in access phase (only in: log), which was preventing the plugin from working consistently.
Fixed a X-Cache-Status:Miss error that occurred when caching large files.
Fixed plugin versions in the documentation. Previously, the plugin versions were labelled as 1.3-x and 2.2.x. They are now updated to align with the plugin’s actual versions, 0.4.x and 0.5.x.