changeset 1744:ab56dcd73af2

Added variables to stream hash, limit_conn_zone, proxy_bind.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 05 Jul 2016 17:58:34 +0300
parents 3d686cb47c2c
children 0dfb7628bfee
files xml/en/docs/stream/ngx_stream_limit_conn_module.xml xml/en/docs/stream/ngx_stream_proxy_module.xml xml/en/docs/stream/ngx_stream_upstream_module.xml xml/ru/docs/stream/ngx_stream_limit_conn_module.xml xml/ru/docs/stream/ngx_stream_proxy_module.xml xml/ru/docs/stream/ngx_stream_upstream_module.xml
diffstat 6 files changed, 26 insertions(+), 19 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/stream/ngx_stream_limit_conn_module.xml
+++ b/xml/en/docs/stream/ngx_stream_limit_conn_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_stream_limit_conn_module"
         link="/en/docs/stream/ngx_stream_limit_conn_module.html"
         lang="en"
-        rev="2">
+        rev="3">
 
 <section id="summary">
 
@@ -114,16 +114,15 @@ limits the number of connections.
 Sets parameters for a shared memory zone
 that will keep states for various keys.
 In particular, the state includes the current number of connections.
-Currently, the supported value for the <value>key</value> is
-the client address in the binary form specified as
-<literal>$binary_remote_addr</literal>.
+The <value>key</value> can contain text, variables,
+and their combinations (1.11.2).
 Connections with an empty key value are not accounted.
 Usage example:
 <example>
 limit_conn_zone $binary_remote_addr zone=addr:10m;
 </example>
 Here, the key is a client IP address set by the
-<literal>$binary_remote_addr</literal> key.
+<literal>$binary_remote_addr</literal> variable.
 The size of <literal>$binary_remote_addr</literal>
 is 4 bytes for IPv4 addresses or 16 bytes for IPv6 addresses.
 The stored state always occupies 32 or 64 bytes
--- a/xml/en/docs/stream/ngx_stream_proxy_module.xml
+++ b/xml/en/docs/stream/ngx_stream_proxy_module.xml
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_proxy_module"
         link="/en/docs/stream/ngx_stream_proxy_module.html"
         lang="en"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -66,6 +66,7 @@ server {
 <para>
 Makes outgoing connections to a proxied server originate
 from the specified local IP <value>address</value>.
+Parameter value can contain variables (1.11.2).
 The special value <literal>off</literal> cancels the effect
 of the <literal>proxy_bind</literal> directive
 inherited from the previous configuration level, which allows the
--- a/xml/en/docs/stream/ngx_stream_upstream_module.xml
+++ b/xml/en/docs/stream/ngx_stream_upstream_module.xml
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_upstream_module"
         link="/en/docs/stream/ngx_stream_upstream_module.html"
         lang="en"
-        rev="13">
+        rev="14">
 
 <section id="summary">
 
@@ -383,8 +383,12 @@ This directive is available as part of o
 <para>
 Specifies a load balancing method for a server group
 where client-server mapping is based on the hashed <value>key</value> value.
-Currently, the only supported value for the <literal>key</literal>
-is the client remote address specified as <literal>$remote_addr</literal>.
+The <value>key</value> can contain text, variables,
+and their combinations (1.11.2).
+Usage example:
+<example>
+hash $remote_addr;
+</example>
 Note that adding or removing a server from the group
 may result in remapping most of the keys to different servers.
 The method is compatible with the
--- a/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_stream_limit_conn_module"
         link="/ru/docs/stream/ngx_stream_limit_conn_module.html"
         lang="ru"
-        rev="2">
+        rev="3">
 
 <section id="summary">
 
@@ -115,16 +115,15 @@ IP-адреса.
 Задаёт параметры зоны разделяемой памяти, которая хранит состояние
 для разных значений ключа.
 Состояние в частности содержит текущее число соединений.
-На данный момент возможным значением для <value>ключа</value> является
-адрес клиента в бинарном виде, указываемый как
-<literal>$binary_remote_addr</literal>.
+В качестве <value>ключа</value> может использоваться текст, переменные
+и их комбинации (1.11.2).
 Запросы с пустым значением ключа не учитываются.
 Пример использования:
 <example>
 limit_conn_zone $binary_remote_addr zone=addr:10m;
 </example>
 Здесь в качестве ключа используется IP-адрес клиента,
-задаваемый ключом <literal>$binary_remote_addr</literal>.
+задаваемый переменной <literal>$binary_remote_addr</literal>.
 Длина значения <literal>$binary_remote_addr</literal>
 равна 4 байтам для IPv4-адресов или 16 байтам для IPv6-адресов.
 При этом размер состояния всегда равен 32 или 64 байтам
--- a/xml/ru/docs/stream/ngx_stream_proxy_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_proxy_module.xml
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_proxy_module"
         link="/ru/docs/stream/ngx_stream_proxy_module.html"
         lang="ru"
-        rev="14">
+        rev="15">
 
 <section id="summary">
 
@@ -66,6 +66,7 @@ server {
 <para>
 Задаёт локальный IP-<value>адрес</value>, который будет использоваться в
 исходящих соединениях с проксируемым сервером.
+В значении параметра допустимо использование переменных (1.11.2).
 Специальное значение <literal>off</literal> отменяет действие
 унаследованной с предыдущего уровня конфигурации
 директивы <literal>proxy_bind</literal>, позволяя системе
--- a/xml/ru/docs/stream/ngx_stream_upstream_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_upstream_module.xml
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_upstream_module"
         link="/ru/docs/stream/ngx_stream_upstream_module.html"
         lang="ru"
-        rev="13">
+        rev="14">
 
 <section id="summary">
 
@@ -385,9 +385,12 @@ SRV-записи с наивысшим приоритетом
 Задаёт метод балансировки нагрузки для группы, при котором
 соответствие клиента серверу определяется при помощи
 хэшированного значения <value>ключа</value>.
-В настоящий момент единственно возможным значением для <literal>ключа</literal>
-является удалённый адрес клиента,
-указываемый как <literal>$remote_addr</literal>.
+В качестве <value>ключа</value> может использоваться текст, переменные
+и их комбинации (1.11.2).
+Пример использования:
+<example>
+hash $remote_addr;
+</example>
 Следует отметить, что любое добавление или удаление серверов в группе
 может привести к перераспределению большинства ключей на другие серверы.
 Метод совместим с библиотекой Perl