# HG changeset patch # User Yaroslav Zhuravlev # Date 1467730714 -10800 # Node ID ab56dcd73af263fb52ba82ec7413cb602a6f19e3 # Parent 3d686cb47c2c0f53c55c2904e6b37e8d389c72d0 Added variables to stream hash, limit_conn_zone, proxy_bind. diff -r 3d686cb47c2c -r ab56dcd73af2 xml/en/docs/stream/ngx_stream_limit_conn_module.xml --- a/xml/en/docs/stream/ngx_stream_limit_conn_module.xml Tue Jul 05 17:58:34 2016 +0300 +++ b/xml/en/docs/stream/ngx_stream_limit_conn_module.xml Tue Jul 05 17:58:34 2016 +0300 @@ -10,7 +10,7 @@ + rev="3">
@@ -114,16 +114,15 @@ 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 key is -the client address in the binary form specified as -$binary_remote_addr. +The key can contain text, variables, +and their combinations (1.11.2). Connections with an empty key value are not accounted. Usage example: limit_conn_zone $binary_remote_addr zone=addr:10m; Here, the key is a client IP address set by the -$binary_remote_addr key. +$binary_remote_addr variable. The size of $binary_remote_addr is 4 bytes for IPv4 addresses or 16 bytes for IPv6 addresses. The stored state always occupies 32 or 64 bytes diff -r 3d686cb47c2c -r ab56dcd73af2 xml/en/docs/stream/ngx_stream_proxy_module.xml --- a/xml/en/docs/stream/ngx_stream_proxy_module.xml Tue Jul 05 17:58:34 2016 +0300 +++ b/xml/en/docs/stream/ngx_stream_proxy_module.xml Tue Jul 05 17:58:34 2016 +0300 @@ -9,7 +9,7 @@ + rev="15">
@@ -66,6 +66,7 @@ Makes outgoing connections to a proxied server originate from the specified local IP address. +Parameter value can contain variables (1.11.2). The special value off cancels the effect of the proxy_bind directive inherited from the previous configuration level, which allows the diff -r 3d686cb47c2c -r ab56dcd73af2 xml/en/docs/stream/ngx_stream_upstream_module.xml --- a/xml/en/docs/stream/ngx_stream_upstream_module.xml Tue Jul 05 17:58:34 2016 +0300 +++ b/xml/en/docs/stream/ngx_stream_upstream_module.xml Tue Jul 05 17:58:34 2016 +0300 @@ -9,7 +9,7 @@ + rev="14">
@@ -383,8 +383,12 @@ Specifies a load balancing method for a server group where client-server mapping is based on the hashed key value. -Currently, the only supported value for the key -is the client remote address specified as $remote_addr. +The key can contain text, variables, +and their combinations (1.11.2). +Usage example: + +hash $remote_addr; + 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 diff -r 3d686cb47c2c -r ab56dcd73af2 xml/ru/docs/stream/ngx_stream_limit_conn_module.xml --- a/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml Tue Jul 05 17:58:34 2016 +0300 +++ b/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml Tue Jul 05 17:58:34 2016 +0300 @@ -10,7 +10,7 @@ + rev="3">
@@ -115,16 +115,15 @@ Задаёт параметры зоны разделяемой памяти, которая хранит состояние для разных значений ключа. Состояние в частности содержит текущее число соединений. -На данный момент возможным значением для ключа является -адрес клиента в бинарном виде, указываемый как -$binary_remote_addr. +В качестве ключа может использоваться текст, переменные +и их комбинации (1.11.2). Запросы с пустым значением ключа не учитываются. Пример использования: limit_conn_zone $binary_remote_addr zone=addr:10m; Здесь в качестве ключа используется IP-адрес клиента, -задаваемый ключом $binary_remote_addr. +задаваемый переменной $binary_remote_addr. Длина значения $binary_remote_addr равна 4 байтам для IPv4-адресов или 16 байтам для IPv6-адресов. При этом размер состояния всегда равен 32 или 64 байтам diff -r 3d686cb47c2c -r ab56dcd73af2 xml/ru/docs/stream/ngx_stream_proxy_module.xml --- a/xml/ru/docs/stream/ngx_stream_proxy_module.xml Tue Jul 05 17:58:34 2016 +0300 +++ b/xml/ru/docs/stream/ngx_stream_proxy_module.xml Tue Jul 05 17:58:34 2016 +0300 @@ -9,7 +9,7 @@ + rev="15">
@@ -66,6 +66,7 @@ Задаёт локальный IP-адрес, который будет использоваться в исходящих соединениях с проксируемым сервером. +В значении параметра допустимо использование переменных (1.11.2). Специальное значение off отменяет действие унаследованной с предыдущего уровня конфигурации директивы proxy_bind, позволяя системе diff -r 3d686cb47c2c -r ab56dcd73af2 xml/ru/docs/stream/ngx_stream_upstream_module.xml --- a/xml/ru/docs/stream/ngx_stream_upstream_module.xml Tue Jul 05 17:58:34 2016 +0300 +++ b/xml/ru/docs/stream/ngx_stream_upstream_module.xml Tue Jul 05 17:58:34 2016 +0300 @@ -9,7 +9,7 @@ + rev="14">
@@ -385,9 +385,12 @@ Задаёт метод балансировки нагрузки для группы, при котором соответствие клиента серверу определяется при помощи хэшированного значения ключа. -В настоящий момент единственно возможным значением для ключа -является удалённый адрес клиента, -указываемый как $remote_addr. +В качестве ключа может использоваться текст, переменные +и их комбинации (1.11.2). +Пример использования: + +hash $remote_addr; + Следует отметить, что любое добавление или удаление серверов в группе может привести к перераспределению большинства ключей на другие серверы. Метод совместим с библиотекой Perl