Mercurial > hg > nginx-site
changeset 1728:f93a5aadad2c
Translated the stream upstream module into Russian.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Thu, 11 Jun 2015 19:06:06 +0300 |
parents | 1a16dce51bce |
children | 8da2ab346a71 |
files | xml/ru/GNUmakefile xml/ru/docs/index.xml xml/ru/docs/stream/ngx_stream_upstream_module.xml |
diffstat | 3 files changed, 261 insertions(+), 257 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/ru/GNUmakefile +++ b/xml/ru/GNUmakefile @@ -88,6 +88,7 @@ REFS = \ stream/ngx_stream_limit_conn_module \ stream/ngx_stream_proxy_module \ stream/ngx_stream_ssl_module \ + stream/ngx_stream_upstream_module \ TOP = \ download \
--- a/xml/ru/docs/index.xml +++ b/xml/ru/docs/index.xml @@ -511,8 +511,8 @@ ngx_stream_ssl_module</link> </listitem> <listitem> -<link doc="../../en/docs/stream/ngx_stream_upstream_module.xml"> -ngx_stream_upstream_module</link> [en] +<link doc="stream/ngx_stream_upstream_module.xml"> +ngx_stream_upstream_module</link> </listitem> </list>
copy from xml/en/docs/stream/ngx_stream_upstream_module.xml copy to xml/ru/docs/stream/ngx_stream_upstream_module.xml --- a/xml/en/docs/stream/ngx_stream_upstream_module.xml +++ b/xml/ru/docs/stream/ngx_stream_upstream_module.xml @@ -6,24 +6,24 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Module ngx_stream_upstream_module" - link="/en/docs/stream/ngx_stream_upstream_module.html" - lang="en" +<module name="Модуль ngx_stream_upstream_module" + link="/ru/docs/stream/ngx_stream_upstream_module.html" + lang="ru" rev="13"> <section id="summary"> <para> -The <literal>ngx_stream_upstream_module</literal> module (1.9.0) -is used to define groups of servers that can be referenced -by the <link doc="ngx_stream_proxy_module.xml" id="proxy_pass"/> -directive. +Модуль <literal>ngx_stream_upstream_module</literal> (1.9.0) +позволяет описывать группы серверов, +которые могут использоваться в директиве +<link doc="ngx_stream_proxy_module.xml" id="proxy_pass"/>. </para> </section> -<section id="example" name="Example Configuration"> +<section id="example" name="Пример конфигурации"> <para> <example> @@ -46,9 +46,9 @@ server { </para> <para> -Dynamically configurable group, -available as part of our -<commercial_version>commercial subscription</commercial_version>: +Динамически настраиваемая группа, +доступна как часть +<commercial_version>коммерческой подписки</commercial_version>: <example> resolver 10.0.0.1; @@ -76,22 +76,22 @@ server { </section> -<section id="directives" name="Directives"> +<section id="directives" name="Директивы"> <directive name="upstream"> -<syntax block="yes"><value>name</value></syntax> +<syntax block="yes"><value>название</value></syntax> <default/> <context>stream</context> <para> -Defines a group of servers. -Servers can listen on different ports. -In addition, servers listening on TCP and UNIX-domain sockets -can be mixed. +Описывает группу серверов. +Серверы могут слушать на разных портах. +Кроме того, можно одновременно использовать серверы, +слушающие на TCP- и UNIX-сокетах. </para> <para> -Example: +Пример: <example> upstream backend { server backend1.example.com:12345 weight=5; @@ -105,129 +105,128 @@ upstream backend { </para> <para> -By default, connections are distributed between the servers using a -weighted round-robin balancing method. -In the above example, each 7 connections will be distributed as follows: -5 connections go to <literal>backend1.example.com:12345</literal> -and one connection to each of the second and third servers. -If an error occurs during communication with a server, the connection will -be passed to the next server, and so on until all of the functioning -servers will be tried. -If communication with all servers fails, the connection will be closed. +По умолчанию соединения распределяются по серверам циклически +(в режиме round-robin) с учётом весов серверов. +В вышеприведённом примере каждые 7 соединений будут распределены так: +5 соединений на <literal>backend1.example.com:12345</literal> +и по одному соединению на второй и третий серверы. +Если при попытке работы с сервером происходит ошибка, то соединение +передаётся следующему серверу, и так далее до тех пор, пока не будут опробованы +все работающие серверы. +Если связь с серверами не удалась, соединение будет закрыто. </para> </directive> <directive name="server"> -<syntax><value>address</value> [<value>parameters</value>]</syntax> +<syntax><value>адрес</value> [<value>параметры</value>]</syntax> <default/> <context>upstream</context> <para> -Defines the <value>address</value> and other <value>parameters</value> -of a server. -The address can be specified as a domain name or IP address -with an obligatory port, or as a UNIX-domain socket path -specified after the “<literal>unix:</literal>” prefix. -A domain name that resolves to several IP addresses defines -multiple servers at once. +Задаёт <value>адрес</value> и другие <value>параметры</value> +сервера. +Адрес может быть указан в виде доменного имени или IP-адреса, +и обязательного порта, или в виде пути UNIX-сокета, который +указывается после префикса “<literal>unix:</literal>”. +Доменное имя, которому соответствует несколько IP-адресов, +задаёт сразу несколько серверов. </para> <para> -The following parameters can be defined: +Могут быть заданы следующие параметры: <list type="tag"> <tag-name id="weight"> -<literal>weight</literal>=<value>number</value> +<literal>weight</literal>=<value>число</value> </tag-name> <tag-desc> -sets the weight of the server, by default, 1. +задаёт вес сервера, по умолчанию 1. </tag-desc> <tag-name id="max_fails"> -<literal>max_fails</literal>=<value>number</value> +<literal>max_fails</literal>=<value>число</value> </tag-name> <tag-desc> -sets the number of unsuccessful attempts to communicate with the server -that should happen in the duration set by the <literal>fail_timeout</literal> -parameter to consider the server unavailable for a duration also set by the -<literal>fail_timeout</literal> parameter. -By default, the number of unsuccessful attempts is set to 1. -The zero value disables the accounting of attempts. -Here, an unsuccessful attempt is an error or timeout -while establishing a connection with the server. +задаёт число неудачных попыток работы с сервером, которые должны произойти +в течение времени, заданного параметром <literal>fail_timeout</literal>, +чтобы сервер считался недоступным на период времени, также заданный +параметром <literal>fail_timeout</literal>. +По умолчанию число попыток устанавливается равным 1. +Нулевое значение отключает учёт попыток. +В данном случае неудачной попыткой считается ошибка или таймаут +при установке соединения с сервером. </tag-desc> <tag-name id="fail_timeout"> -<literal>fail_timeout</literal>=<value>time</value> +<literal>fail_timeout</literal>=<value>время</value> </tag-name> <tag-desc> -sets +задаёт <list type="bullet"> <listitem> -the time during which the specified number of unsuccessful attempts to -communicate with the server should happen to consider the server unavailable; +время, в течение которого должно произойти заданное число неудачных +попыток работы с сервером для того, чтобы сервер считался недоступным; </listitem> <listitem> -and the period of time the server will be considered unavailable. +и время, в течение которого сервер будет считаться недоступным. </listitem> </list> -By default, the parameter is set to 10 seconds. +По умолчанию параметр равен 10 секундам. </tag-desc> <tag-name id="backup"> <literal>backup</literal> </tag-name> <tag-desc> -marks the server as a backup server. -Connections to the backup server will be passed -when the primary servers are unavailable. +помечает сервер как запасной сервер. +На него будут передаваться соединения в случае, +если не работают основные серверы. </tag-desc> <tag-name id="down"> <literal>down</literal> </tag-name> <tag-desc> -marks the server as permanently unavailable. +помечает сервер как постоянно недоступный. </tag-desc> </list> </para> <para> -Additionally, -the following parameters are available as part of our -<commercial_version>commercial subscription</commercial_version>: +Кроме того, +следующие параметры доступны как часть +<commercial_version>коммерческой подписки</commercial_version>: <list type="tag"> <tag-name id="max_conns"> -<literal>max_conns</literal>=<value>number</value> +<literal>max_conns</literal>=<value>число</value> </tag-name> <tag-desc> -limits the maximum <value>number</value> of simultaneous connections to the -proxied server. -Default value is zero, meaning there is no limit. +ограничивает максимальное <value>число</value> одновременных +соединений к проксируемому серверу. +Значение по умолчанию равно 0 и означает, что ограничения нет. </tag-desc> <tag-name id="resolve"> <literal>resolve</literal> </tag-name> <tag-desc> -monitors changes of the IP addresses -that correspond to a domain name of the server, -and automatically modifies the upstream configuration -without the need of restarting nginx. -The server group must reside in the <link id="zone">shared memory</link>. +отслеживает изменения IP-адресов, соответствующих доменному имени сервера, +и автоматически изменяет конфигурацию группы +без необходимости перезапуска nginx. +Группа должна находиться в <link id="zone">зоне разделяемой памяти</link>. <para> -In order for this parameter to work, -the <link doc="ngx_stream_core_module.xml" id="resolver"/> directive -must be specified in the -<link doc="ngx_stream_core_module.xml" id="stream"/> block. -Example: +Для работы этого параметра +директива <link doc="ngx_stream_core_module.xml" id="resolver"/> +должна быть задана в блоке +<link doc="ngx_stream_core_module.xml" id="stream"/>. +Пример: <example> stream { resolver 10.0.0.1; @@ -243,31 +242,32 @@ stream { </tag-desc> <tag-name id="service"> -<literal>service</literal>=<value>name</value> +<literal>service</literal>=<value>имя</value> </tag-name> <tag-desc> -enables resolving of DNS -<link url="https://tools.ietf.org/html/rfc2782">SRV</link> -records and sets the service <value>name</value> (1.9.13). -In order for this parameter to work, it is necessary to specify -the <link id="resolve"/> parameter for the server -and specify a hostname without a port number. +включает преобразование +<link url="https://tools.ietf.org/html/rfc2782">SRV</link>-записей +DNS и задаёт <value>имя</value> сервиса (1.9.13). +Для работы параметра необходимо указать +параметр <link id="resolve"/> для сервера +и не указывать порт сервера. <para> -If the service name does not contain a dot (“<literal>.</literal>”), then -the <link url="https://tools.ietf.org/html/rfc2782">RFC</link>-compliant name -is constructed -and the TCP protocol is added to the service prefix. -For example, to look up the -<literal>_http._tcp.backend.example.com</literal> SRV record, -it is necessary to specify the directive: +Если имя сервиса не содержит точку (“<literal>.</literal>”), то +имя составляется в соответствии с +<link url="https://tools.ietf.org/html/rfc2782">RFC</link> +и в префикс службы добавляется протокол TCP. +Например, для получения +SRV-записи <literal>_http._tcp.backend.example.com</literal> +необходимо указать директиву: <example> server backend.example.com service=http resolve; </example> -If the service name contains one or more dots, then the name is constructed -by joining the service prefix and the server name. -For example, to look up the <literal>_http._tcp.backend.example.com</literal> -and <literal>server1.backend.example.com</literal> SRV records, -it is necessary to specify the directives: +Если имя сервиса содержит одну и более точек, то имя составляется +при помощи соединения префикса службы и имени сервера. +Например, для получения SRV-записей +<literal>_http._tcp.backend.example.com</literal> +и <literal>server1.backend.example.com</literal> +необходимо указать директивы: <example> server backend.example.com service=_http._tcp resolve; server example.com service=server1.backend resolve; @@ -275,26 +275,27 @@ server example.com service=server1.backe </para> <para> -Highest-priority SRV records -(records with the same lowest-number priority value) -are resolved as primary servers, -the rest of SRV records are resolved as backup servers. -If the <link id="backup"/> parameter is specified for the server, -high-priority SRV records are resolved as backup servers, -the rest of SRV records are ignored. +SRV-записи с наивысшим приоритетом +(записи с одинаковым наименьшим значением приоритета) +преобразуются в основные серверы, +остальные SRV-записи преобразуются в запасные серверы. +Если в конфигурации сервера указан параметр <link id="backup"/>, +высокоприоритетные SRV-записи преобразуются в запасные серверы, +остальные SRV-записи игнорируются. </para> </tag-desc> <tag-name id="slow_start"> -<literal>slow_start</literal>=<value>time</value> +<literal>slow_start</literal>=<value>время</value> </tag-name> <tag-desc> -sets the <value>time</value> during which the server will recover its weight -from zero to a nominal value, when unhealthy server becomes -<link id="health_check">healthy</link>, -or when the server becomes available after a period of time -it was considered <link id="fail_timeout">unavailable</link>. -Default value is zero, i.e. slow start is disabled. +задаёт <value>время</value>, в течение которого вес сервера +восстановится от нуля до своего номинального значения в ситуации, когда +неработоспособный (unhealthy) сервер вновь становится работоспособным +(<link id="health_check">healthy</link>) +или когда сервер становится доступным по прошествии времени, +в течение которого он считался <link id="fail_timeout">недоступным</link>. +Значение по умолчанию равно нулю и означает, что медленный старт выключен. </tag-desc> </list> @@ -302,9 +303,9 @@ Default value is zero, i.e. slow start i <para> <note> -If there is only a single server in a group, <literal>max_fails</literal>, -<literal>fail_timeout</literal> and <literal>slow_start</literal> parameters -are ignored, and such a server will never be considered unavailable. +Если в группе только один сервер, параметры <literal>max_fails</literal>, +<literal>fail_timeout</literal> и <literal>slow_start</literal> +игнорируются и такой сервер никогда не будет считаться недоступным. </note> </para> @@ -312,26 +313,26 @@ are ignored, and such a server will neve <directive name="zone"> -<syntax><value>name</value> [<value>size</value>]</syntax> +<syntax><value>имя</value> [<value>размер</value>]</syntax> <default/> <context>upstream</context> <para> -Defines the <value>name</value> and <value>size</value> of the shared -memory zone that keeps the group’s configuration and run-time state that are -shared between worker processes. -Several groups may share the same zone. -In this case, it is enough to specify the zone size only once. +Задаёт <value>имя</value> и <value>размер</value> зоны разделяемой памяти, +в которой хранятся конфигурация группы и её рабочее состояние, +разделяемые между рабочими процессами. +В одной и той же зоне могут быть сразу несколько групп. +В этом случае достаточно указать <value>размер</value> только один раз. </para> <para> -Additionally, -as part of our <commercial_version>commercial subscription</commercial_version>, -such groups allow changing the group membership -or modifying the settings of a particular server -without the need of restarting nginx. -The configuration is accessible via a special location -handled by +Дополнительно, как часть +<commercial_version>коммерческой подписки</commercial_version>, +в таких группах для изменения состава группы +или настроек отдельных серверов +нет необходимости перезапускать nginx. +Конфигурация доступна через специальный location, +в котором указана директива <link doc="../http/ngx_http_upstream_conf_module.xml" id="upstream_conf"/>. </para> @@ -339,36 +340,36 @@ handled by <directive name="state"> -<syntax><value>file</value></syntax> +<syntax><value>файл</value></syntax> <default/> <context>upstream</context> <appeared-in>1.9.7</appeared-in> <para> -Specifies a <value>file</value> that keeps the state -of the dynamically configurable group. -The state is currently limited to the list of servers with their parameters. -The file is read when parsing the configuration and is updated each time -the upstream configuration is -<link doc="ngx_http_upstream_conf_module.xml" id="upstream_conf">changed</link>. -Changing the file content directly should be avoided. -The directive cannot be used -along with the <link id="server"/> directive. +Задаёт <value>файл</value>, в котором хранится состояние +динамически настраиваемой группы. +В данный момент состояние ограничено списком серверов с их параметрами. +Файл читается при парсинге конфигурации и обновляется каждый раз при +<link doc="ngx_http_upstream_conf_module.xml" id="upstream_conf">изменении</link> +конфигурации группы. +Изменение содержимого файла напрямую не рекомендуется. +Директиву нельзя использовать +совместно с директивой <link id="server"/>. </para> <para> <note> -Changes made during -<link doc="../control.xml" id="reconfiguration">configuration reload</link> -or <link doc="../control.xml" id="upgrade">binary upgrade</link> -can be lost. +Изменения, совершённые в момент +<link doc="../control.xml" id="reconfiguration">перезагрузки конфигурации</link> +или <link doc="../control.xml" id="upgrade">обновления бинарного файла</link>, +могут быть потеряны. </note> </para> <para> <note> -This directive is available as part of our -<commercial_version>commercial subscription</commercial_version>. +Эта директива доступна как часть +<commercial_version>коммерческой подписки</commercial_version>. </note> </para> @@ -376,33 +377,34 @@ This directive is available as part of o <directive name="hash"> -<syntax><value>key</value> [<literal>consistent</literal>]</syntax> +<syntax><value>ключ</value> [<literal>consistent</literal>]</syntax> <default/> <context>upstream</context> <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>. -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 -<link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link> -Perl library. +Задаёт метод балансировки нагрузки для группы, при котором +соответствие клиента серверу определяется при помощи +хэшированного значения <value>ключа</value>. +В настоящий момент единственно возможным значением для <literal>ключа</literal> +является удалённый адрес клиента, +указываемый как <literal>$remote_addr</literal>. +Следует отметить, что любое добавление или удаление серверов в группе +может привести к перераспределению большинства ключей на другие серверы. +Метод совместим с библиотекой Perl +<link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link>. </para> <para> -If the <literal>consistent</literal> parameter is specified, -the <link url="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</link> -consistent hashing method will be used instead. -The method ensures that only a few keys -will be remapped to different servers -when a server is added to or removed from the group. -This helps to achieve a higher cache hit ratio for caching servers. -The method is compatible with the +Если задан параметр <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> -Perl library with the <value>ketama_points</value> parameter set to 160. +при значении параметра <value>ketama_points</value> равным 160. </para> </directive> @@ -414,12 +416,11 @@ Perl library with the <value>ketama_poin <context>upstream</context> <para> -Specifies that a server group should use a load balancing method -where a connection -is passed to the server with the least number of active connections, -taking into account weights of servers. -If there are several such servers, they are tried in turn using a -weighted round-robin balancing method. +Задаёт для группы метод балансировки нагрузки, при котором соединение +передаётся серверу с наименьшим числом активных соединений, +с учётом весов серверов. +Если подходит сразу несколько серверов, они выбираются циклически +(в режиме round-robin) с учётом их весов. </para> </directive> @@ -433,26 +434,26 @@ weighted round-robin balancing method. <context>upstream</context> <para> -Specifies that a group should use a load balancing method where a connection -is passed to the server with the least average time and -least number of active connections, taking into account weights of servers. -If there are several such servers, they are tried in turn using a -weighted round-robin balancing method. +Задаёт для группы метод балансировки нагрузки, при котором соединение +передаётся серверу с наименьшими средним временем ответа и +числом активных соединений с учётом весов серверов. +Если подходит сразу несколько серверов, то они выбираются циклически +(в режиме round-robin) с учётом их весов. </para> <para> -If the <literal>connect</literal> parameter is specified, -time to connect to the upstream server is used. -If the <literal>first_byte</literal> parameter is specified, -time to receive the first byte of data is used. -If the <literal>last_byte</literal> is specified, -time to receive the last byte of data is used. +Если указан параметр <literal>connect</literal>, +то учитывается время соединения с сервером группы. +Если указан параметр <literal>first_byte</literal>, +то учитывается время получения первого байта данных. +Если указан параметр <literal>last_byte</literal>, +то учитывается время получения ответа. </para> <para> <note> -This directive is available as part of our -<commercial_version>commercial subscription</commercial_version>. +Эта директива доступна как часть +<commercial_version>коммерческой подписки</commercial_version>. </note> </para> @@ -460,114 +461,113 @@ This directive is available as part of o <directive name="health_check"> -<syntax>[<value>parameters</value>]</syntax> +<syntax>[<value>параметры</value>]</syntax> <default/> <context>server</context> <para> -Enables periodic health checks of the servers in a -<link id="upstream">group</link>. +Активирует периодические проверки работоспособности серверов в +<link id="upstream">группе</link>. </para> <para> -The following optional parameters are supported: +Могут быть заданы следующие необязательные параметры: <list type="tag"> <tag-name id="interval"> -<literal>interval</literal>=<value>time</value> +<literal>interval</literal>=<value>время</value> </tag-name> <tag-desc> -sets the interval between two consecutive health checks, -by default, 5 seconds; +задаёт интервал между двумя последовательными проверками, +по умолчанию 5 секунд; </tag-desc> <tag-name id="fails"> -<literal>fails</literal>=<value>number</value> +<literal>fails</literal>=<value>число</value> </tag-name> <tag-desc> -sets the number of consecutive failed health checks of a particular server -after which this server will be considered unhealthy, -by default, 1; +задаёт число последовательных неуспешных проверок для определённого сервера, +после которых сервер будет считаться неработоспособным, +по умолчанию 1; </tag-desc> <tag-name id="passes"> -<literal>passes</literal>=<value>number</value> +<literal>passes</literal>=<value>число</value> </tag-name> <tag-desc> -sets the number of consecutive passed health checks of a particular server -after which the server will be considered healthy, -by default, 1; +задаёт число последовательных успешных проверок для определённого сервера, +после которых сервер будет считаться работоспособным, +по умолчанию 1; </tag-desc> <tag-name id="hc_match"> -<literal>match</literal>=<value>name</value> +<literal>match</literal>=<value>имя</value> </tag-name> <tag-desc> -specifies the <literal>match</literal> block configuring the tests that a -successful connection should pass in order for a health check to pass. -By default, -only the ability to establish a TCP connection with the server is checked; +указывает на блок <literal>match</literal> с условиями, которым должно +удовлетворять соединение, чтобы результат проверки считался успешным; +по умолчанию проверяется лишь возможность установки TCP-соединения с сервером; </tag-desc> <tag-name id="health_check_port"> -<literal>port</literal>=<value>number</value> +<literal>port</literal>=<value>число</value> </tag-name> <tag-desc> -defines the port used when connecting to a server -to perform a health check (1.9.7); -by default, equals the <link id="server"/> port; +задаёт порт, используемый при подключении к серверу +для проверки его работоспособности (1.9.7); +по умолчанию совпадает с портом <link id="server">сервера</link>. </tag-desc> <tag-name id="health_check_udp"> <literal>udp</literal> </tag-name> <tag-desc> -specifies that the <literal>UDP</literal> protocol should be used for -health checks instead of the default <literal>TCP</literal> protocol (1.9.13); -requires a <link id="hc_match">match</link> block with the -<link id="match_send">send</link> and <link id="match_expect">expect</link> -parameters. +указывает, что для проверки работоспособности будет использоваться протокол +<literal>UDP</literal> +вместо протокола <literal>TCP</literal>, используемого по умолчанию (1.9.13); +тебует наличия блока <link id="hc_match">match</link> с параметрами +<link id="match_send">send</link> и <link id="match_expect">expect</link>. </tag-desc> </list> </para> <para> -For example, +В примере <example> server { proxy_pass backend; health_check; } </example> -will check the ability to establish a TCP connection to each server -in the <literal>backend</literal> group every five seconds. -When a connection to the server cannot be established, -the health check will fail, and the server will -be considered unhealthy. -Client connections are not passed to unhealthy servers. +для каждого сервера группы <literal>backend</literal> +с интервалом в 5 секунд проверяется возможность установки TCP-соединения. +Если соединение с сервером не может быть установлено, +проверка считается неуспешной и сервер +признаётся неработоспособным. +На неработоспособные серверы клиентские соединения передаваться не будут. </para> <para> -Health checks can also be configured to test data obtained from the server. -Tests are configured separately using the <link id="match"/> directive -and referenced in the <literal>match</literal> parameter. +Проверки работоспособности могут тестировать данные, полученные от сервера. +Тесты настраиваются отдельно при помощи директивы <link id="match"/> +и указываются в параметре <literal>match</literal>. </para> <para> -The server group must reside in the <link id="zone">shared memory</link>. +Группа должна находиться в <link id="zone">зоне разделяемой памяти</link>. </para> <para> -If several health checks are defined for the same group of servers, -a single failure of any check will make the corresponding server be -considered unhealthy. +Если для группы задано несколько проверок, +то при любой неуспешной проверке соответствующий сервер будет +считаться неработоспособным. </para> <para> <note> -This directive is available as part of our -<commercial_version>commercial subscription</commercial_version>. +Эта директива доступна как часть +<commercial_version>коммерческой подписки</commercial_version>. </note> </para> @@ -575,21 +575,21 @@ This directive is available as part of o <directive name="health_check_timeout"> -<syntax><value>timeout</value></syntax> +<syntax><value>время</value></syntax> <default>5s</default> <context>stream</context> <context>server</context> <para> -Overrides the +Переопределяет значение <link doc="ngx_stream_proxy_module.xml" id="proxy_timeout"/> -value for health checks. +для проверок работоспособности. </para> <para> <note> -This directive is available as part of our -<commercial_version>commercial subscription</commercial_version>. +Эта директива доступна как часть +<commercial_version>коммерческой подписки</commercial_version>. </note> </para> @@ -597,70 +597,73 @@ This directive is available as part of o <directive name="match"> -<syntax block="yes"><value>name</value> </syntax> +<syntax block="yes"><value>имя</value> </syntax> <default/> <context>stream</context> <para> -Defines the named test set used to verify server responses to health checks. +Задаёт именованный набор тестов для для анализа ответов сервера +на запросы проверки работоспособности. </para> <para> -The following parameters can be configured: +Могут быть заданы следующие параметры: <list type="tag"> <tag-name id="match_send"> -<literal>send</literal> <value>string</value>; +<literal>send</literal> <value>строка</value>; </tag-name> <tag-desc> -sends a <value>string</value> to the server; +отправляет <value>строку</value> на сервер; </tag-desc> <tag-name id="match_expect"> -<literal>expect</literal> <value>string</value> | +<literal>expect</literal> <value>стока</value> | <literal>~</literal> <value>regex</value>; </tag-name> <tag-desc> -a literal string (1.9.12) or a regular expression -that the data obtained from the server should match. -The regular expression is specified with the preceding -“<literal>~*</literal>” modifier (for case-insensitive matching), or the -“<literal>~</literal>” modifier (for case-sensitive matching). +текстовая строка (1.9.12) или регулярное выражение, +которым должны соответствовать данные, полученные с сервера. +Регулярное выражение задаётся либо с модификатором +“<literal>~*</literal>” (для поиска совпадения без учёта регистра символов), +либо с модификатором “<literal>~</literal>” (с учётом регистра). </tag-desc> </list> -Both <literal>send</literal> and <literal>expect</literal> parameters -can contain hexadecimal literals with the prefix “<literal>\x</literal>” -followed by two hex digits, for example, “<literal>\x80</literal>” (1.9.12). +Параметры <literal>send</literal> и <literal>expect</literal> +могут содержать строки в шестнадцатеричном виде +с префиксом “<literal>\x</literal>” +и последующими двумя шестнадцатеричными цифрами, +например “<literal>\x80</literal>” (1.9.12). </para> <para> -Health check is passed if: +Проверка работоспособности считается успешной, если <list type="bullet"> <listitem> -the TCP connection was successfully established; +TCP-соединение успешно установлено; </listitem> <listitem> -the <value>string</value> from the <literal>send</literal> parameter, -if specified, was sent; +<value>строка</value> из параметра <literal>send</literal> +была отправлена (если была задана); </listitem> <listitem> -the data obtained from the server matched the string or regular expression -from the <literal>expect</literal> parameter, if specified; +данные, полученные от сервера, совпали со строкой или регулярным выражением +из параметра <literal>expect</literal> (если был задан); </listitem> <listitem> -the time elapsed does not exceed the value specified -in the <link id="health_check_timeout"/> directive. +истёкшее время не превышает значение, указанное +в директиве <link id="health_check_timeout"/>. </listitem> </list> </para> <para> -Example: +Пример: <example> upstream backend { zone upstream_backend 10m; @@ -682,16 +685,16 @@ server { <para> <note> -Only the first -<link doc="ngx_stream_proxy_module.xml" id="proxy_buffer_size"/> -bytes of data obtained from the server are examined. +Проверяются лишь первые байты данных +<link doc="ngx_stream_proxy_module.xml" id="proxy_buffer_size"/>, +полученные от сервера. </note> </para> <para> <note> -This directive is available as part of our -<commercial_version>commercial subscription</commercial_version>. +Эта директива доступна как часть +<commercial_version>коммерческой подписки</commercial_version>. </note> </para>