[PATCH] Add $upstream_cache_key

[Maxim Dounin]

Hello!

On Thu, May 23, 2024 at 06:08:32PM +0100, Kirill A. Korinsky wrote:

> Greetings,
> 
> On Thu, 23 May 2024 17:59:17 +0100,
> Maxim Dounin <mdounin at mdounin.ru> wrote:
> > 
> > Patch with the above comments incorporated, please take a look:
> > 
> > # HG changeset patch
> > # User Kirill A. Korinsky <kirill at korins.ky>
> > # Date 1716479312 -10800
> > #      Thu May 23 18:48:32 2024 +0300
> > # Node ID bd920ccd6f1aa43fcb40507ba463e44548ca4676
> > # Parent  46ecad404a296042c0088e699f275a92758e5ab9
> > Upstream: $upstream_cache_key variable.
> >
> 
> I'm absolutley fine with new version, thanks!

Committed.

Please check docs patch below.

> Do you mind if I re-send it to the nginx with your changes?

I don't think my changes are copyrightable, but even if they are, 
all the code is under the BSD license, and hence can be merged 
into F5 NGINX.

Patch to the documentation:

# HG changeset patch
# User Maxim Dounin <mdounin at mdounin.ru>
# Date 1716511750 -10800
#      Fri May 24 03:49:10 2024 +0300
# Node ID 0bbf14c9fd6692c95dcca75bd02e979b2f50f45b
# Parent  3b5594157fab8ce6c65872b136aa9c599bc005b8
Documented $upstream_cache_key.

diff --git a/xml/en/docs/http/ngx_http_upstream_module.xml b/xml/en/docs/http/ngx_http_upstream_module.xml
--- a/xml/en/docs/http/ngx_http_upstream_module.xml
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="89">
+        rev="90">
 
 <section id="summary">
 
@@ -574,6 +574,12 @@ are separated by commas and colons like 
 <link id="var_upstream_addr">$upstream_addr</link> variable.
 </tag-desc>
 
+<tag-name id="var_upstream_cache_key"><var>$upstream_cache_key</var>
+</tag-name>
+<tag-desc>
+the cache key being used (1.27.1).
+</tag-desc>
+
 <tag-name id="var_upstream_cache_status"><var>$upstream_cache_status</var>
 </tag-name>
 <tag-desc>
diff --git a/xml/ru/docs/http/ngx_http_upstream_module.xml b/xml/ru/docs/http/ngx_http_upstream_module.xml
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_upstream_module"
         link="/ru/docs/http/ngx_http_upstream_module.html"
         lang="ru"
-        rev="89">
+        rev="90">
 
 <section id="summary">
 
@@ -581,6 +581,12 @@ server {
 <link id="var_upstream_addr">$upstream_addr</link>.
 </tag-desc>
 
+<tag-name id="var_upstream_cache_key"><var>$upstream_cache_key</var>
+</tag-name>
+<tag-desc>
+используемый ключ кэширования (1.27.1).
+</tag-desc>
+
 <tag-name id="var_upstream_cache_status"><var>$upstream_cache_status</var>
 </tag-name>
 <tag-desc>

-- 
Maxim Dounin
http://mdounin.ru/