diff xml/ru/docs/http/ngx_http_upstream_module.xml @ 1230:6cc809881694

Upstream: added the "hash" directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 17 Jun 2014 17:05:37 +0400
parents 9264fdb6c833
children 314801ed88e7
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml
@@ -243,6 +243,40 @@ http {
 </directive>
 
 
+<directive name="hash">
+<syntax><value>ключ</value> [<literal>consistent</literal>]</syntax>
+<default/>
+<context>upstream</context>
+<appeared-in>1.7.2</appeared-in>
+
+<para>
+Задаёт метод балансировки нагрузки для группы, при котором
+соответствие клиента серверу определяется при помощи
+хэшированного значения <value>ключа</value>.
+В качестве <value>ключа</value> может использоваться
+текст, переменные и их комбинации.
+Следует отметить, что любое добавление или удаление серверов в группе
+может привести к перераспределению большинства ключей на другие серверы.
+Метод совместим с библиотекой Perl
+<link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link>.
+</para>
+
+<para>
+Если задан параметр <literal>consistent</literal>, то вместо
+вышеописанного метода будет использоваться метод консистентного хэширования
+<link url="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</link>.
+Метод гарантирует, что при добавлении сервера в группу или его удалении
+на другие серверы будет перераспределено минимальное число ключей.
+Применение метода для кэширующих серверов обеспечивает
+больший процент попаданий в кэш.
+Метод совместим с библиотекой Perl
+<link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached%3A%3AFast">Cache::Memcached::Fast</link>
+при значении параметра <value>ketama_points</value> равным 160.
+</para>
+
+</directive>
+
+
 <directive name="ip_hash">
 <syntax/>
 <default/>