comparison xml/ru/docs/http/ngx_http_upstream_module.xml @ 966:95c3c3bbf1ce

Text review.
author Egor Nikitin <yegor.nikitin@gmail.com>
date Wed, 14 Aug 2013 12:03:41 +0400
parents ba3d6ade3513
children 2d8269d8fea8
comparison
equal deleted inserted replaced
965:fadccc156188 966:95c3c3bbf1ce
79 По умолчанию запросы распределяются по серверам циклически 79 По умолчанию запросы распределяются по серверам циклически
80 (в режиме round-robin) с учётом весов серверов. 80 (в режиме round-robin) с учётом весов серверов.
81 В вышеприведённом примере каждые 7 запросов будут распределены так: 81 В вышеприведённом примере каждые 7 запросов будут распределены так:
82 5 запросов на <literal>backend1.example.com</literal> 82 5 запросов на <literal>backend1.example.com</literal>
83 и по одному запросу на второй и третий серверы. 83 и по одному запросу на второй и третий серверы.
84 Если при попытке работы с сервером произошла ошибка, то запрос будет 84 Если при попытке работы с сервером происходит ошибка, то запрос
85 передан следующему серверу, и так до тех пор, пока не будут опробованы 85 передаётся следующему серверу, и так далее до тех пор, пока не будут опробованы
86 все работающие серверы. 86 все работающие серверы.
87 Если не удастся получить успешный ответ 87 Если не удастся получить успешный ответ
88 ни от одного из серверов, то клиенту будет возвращён результат работы 88 ни от одного из серверов, то клиенту будет возвращён результат работы
89 с последним сервером. 89 с последним сервером.
90 </para> 90 </para>
117 задаёт вес сервера, по умолчанию 1. 117 задаёт вес сервера, по умолчанию 1.
118 </tag-desc> 118 </tag-desc>
119 119
120 <tag-name><literal>max_fails</literal>=<value>число</value></tag-name> 120 <tag-name><literal>max_fails</literal>=<value>число</value></tag-name>
121 <tag-desc> 121 <tag-desc>
122 задаёт число неудачных попыток работы с сервером 122 задаёт число неудачных попыток работы с сервером, которые должны произойти
123 в течение времени, заданного параметром <literal>fail_timeout</literal>, 123 в промежуток времени, заданный параметром <literal>fail_timeout</literal>,
124 после которого он считается неработающим, также в течение времени 124 чтобы сервер считался неработающим на период времени, также заданный
125 заданного параметром <literal>fail_timeout</literal>. 125 параметром <literal>fail_timeout</literal>.
126 По умолчанию число попыток устанавливается равным 1. 126 По умолчанию число попыток устанавливается равным 1.
127 Нулевое значение запрещает учёт попыток. 127 Нулевое значение отключает учёт попыток.
128 Что считается неудачной попыткой, определяется директивами 128 Что считается неудачной попыткой, определяется директивами
129 <link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>, 129 <link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>,
130 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/> и 130 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/> и
131 <link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/>. 131 <link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/>.
132 </tag-desc> 132 </tag-desc>
144 <listitem> 144 <listitem>
145 и время, в течение которого сервер будет считаться неработающим. 145 и время, в течение которого сервер будет считаться неработающим.
146 </listitem> 146 </listitem>
147 147
148 </list> 148 </list>
149 По умолчанию таймаут равен 10 секундам. 149 По умолчанию параметр равен 10 секундам.
150 </tag-desc> 150 </tag-desc>
151 151
152 <tag-name><literal>backup</literal></tag-name> 152 <tag-name><literal>backup</literal></tag-name>
153 <tag-desc> 153 <tag-desc>
154 помечает сервер как запасной сервер. 154 помечает сервер как запасной сервер.
248 закрываются. 248 закрываются.
249 <note> 249 <note>
250 Следует особо отметить, что директива <literal>keepalive</literal> 250 Следует особо отметить, что директива <literal>keepalive</literal>
251 не ограничивает общее число соединений с серверами группы, которые 251 не ограничивает общее число соединений с серверами группы, которые
252 рабочие процессы nginx могут открыть. 252 рабочие процессы nginx могут открыть.
253 Параметр <value>соединения</value> следует устанавливать 253 Параметр <value>соединения</value> следует устанавливать достаточно
254 достаточно консервативно для обеспечения возможности 254 консервативно, чтобы серверы группы по-прежнему могли обрабатывать
255 обработки серверами группы новых входящих соединений. 255 новые входящие соединения.
256 </note> 256 </note>
257 </para> 257 </para>
258 258
259 <para> 259 <para>
260 Пример конфигурации группы серверов memcached с постоянными соединениями: 260 Пример конфигурации группы серверов memcached с постоянными соединениями:
304 </para> 304 </para>
305 305
306 <para> 306 <para>
307 <note> 307 <note>
308 Хоть это и не рекомендуется, но также возможно использование постоянных 308 Хоть это и не рекомендуется, но также возможно использование постоянных
309 соединений в HTTP/1.0, путём передачи поля заголовка 309 соединений с HTTP/1.0, путём передачи поля заголовка
310 <header>Connection: Keep-Alive</header> серверу группы. 310 <header>Connection: Keep-Alive</header> серверу группы.
311 </note> 311 </note>
312 </para> 312 </para>
313 313
314 <para> 314 <para>
384 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock</literal>”. 384 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock</literal>”.
385 Если произошло внутреннее перенаправление от одной группы серверов на другую 385 Если произошло внутреннее перенаправление от одной группы серверов на другую
386 с помощью 386 с помощью
387 <header>X-Accel-Redirect</header> или 387 <header>X-Accel-Redirect</header> или
388 <link doc="ngx_http_core_module.xml" id="error_page"/>, 388 <link doc="ngx_http_core_module.xml" id="error_page"/>,
389 то эти группы серверов разделяются двоеточием, например, 389 то адреса, соответствующие разным группам серверов, разделяются двоеточием,
390 например,
390 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80</literal>”. 391 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80</literal>”.
391 </tag-desc> 392 </tag-desc>
392 393
393 <tag-name><var>$upstream_cache_status</var></tag-name> 394 <tag-name><var>$upstream_cache_status</var></tag-name>
394 <tag-desc> 395 <tag-desc>
401 402
402 <tag-name><var>$upstream_response_length</var></tag-name> 403 <tag-name><var>$upstream_response_length</var></tag-name>
403 <tag-desc> 404 <tag-desc>
404 хранит длины ответов, полученных от серверов группы (0.7.27); 405 хранит длины ответов, полученных от серверов группы (0.7.27);
405 длины хранятся в байтах. 406 длины хранятся в байтах.
406 Несколько ответов разделяются запятыми и двоеточиями, 407 Длины нескольких ответов разделяются запятыми и двоеточиями
407 подобно переменной <var>$upstream_addr</var>. 408 подобно адресам в переменной <var>$upstream_addr</var>.
408 </tag-desc> 409 </tag-desc>
409 410
410 <tag-name><var>$upstream_response_time</var></tag-name> 411 <tag-name><var>$upstream_response_time</var></tag-name>
411 <tag-desc> 412 <tag-desc>
412 хранит времена ответов, полученных от серверов группы; 413 хранит времена ответов, полученных от серверов группы;
413 времена хранятся в секундах с точностью до миллисекунд. 414 времена хранятся в секундах с точностью до миллисекунд.
414 Несколько ответов разделяются запятыми и двоеточиями, 415 Времена нескольких ответов разделяются запятыми и двоеточиями
415 подобно переменной <var>$upstream_addr</var>. 416 подобно адресам в переменной <var>$upstream_addr</var>.
416 </tag-desc> 417 </tag-desc>
417 418
418 <tag-name><var>$upstream_status</var></tag-name> 419 <tag-name><var>$upstream_status</var></tag-name>
419 <tag-desc> 420 <tag-desc>
420 хранит коды ответов, полученных от серверов группы. 421 хранит коды ответов, полученных от серверов группы.
421 Несколько ответов разделяются запятыми и двоеточиями, 422 Коды нескольких ответов разделяются запятыми и двоеточиями
422 подобно переменной <var>$upstream_addr</var>. 423 подобно адресам в переменной <var>$upstream_addr</var>.
423 </tag-desc> 424 </tag-desc>
424 425
425 <tag-name><var>$upstream_http_...</var></tag-name> 426 <tag-name><var>$upstream_http_...</var></tag-name>
426 <tag-desc> 427 <tag-desc>
427 хранят поля заголовка ответа сервера. 428 хранят поля заголовка ответа сервера.
428 Например, поле заголовка ответа <header>Server</header> 429 Например, поле заголовка ответа <header>Server</header>
429 доступно в переменной <var>$upstream_http_server</var>. 430 доступно в переменной <var>$upstream_http_server</var>.
430 Правила преобразования имён полей заголовка ответа в имена переменных 431 Правила преобразования имён полей заголовка ответа в имена переменных
431 такие же, как для переменных с префиксом 432 такие же, как для переменных с префиксом
432 “<link doc="ngx_http_core_module.xml" id="variables">$http_</link>”. 433 “<link doc="ngx_http_core_module.xml" id="variables">$http_</link>”.
433 Необходимо иметь в виду, что запоминаются только поля заголовка ответа 434 Необходимо иметь в виду, что запоминаются поля заголовка только из ответа
434 последнего сервера. 435 последнего сервера.
435 </tag-desc> 436 </tag-desc>
436 437
437 </list> 438 </list>
438 </para> 439 </para>