comparison xml/ru/docs/stream/ngx_stream_upstream_module.xml @ 1925:a58b35cc0823

Updated docs for the upcoming NGINX Plus release.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 08 Mar 2017 18:05:46 +0300
parents 6225d50b3cba
children 6b6d0e844bf7
comparison
equal deleted inserted replaced
1924:237a10fb98d2 1925:a58b35cc0823
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_stream_upstream_module" 9 <module name="Модуль ngx_stream_upstream_module"
10 link="/ru/docs/stream/ngx_stream_upstream_module.html" 10 link="/ru/docs/stream/ngx_stream_upstream_module.html"
11 lang="ru" 11 lang="ru"
12 rev="23"> 12 rev="24">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_stream_upstream_module</literal> (1.9.0) 17 Модуль <literal>ngx_stream_upstream_module</literal> (1.9.0)
449 449
450 </directive> 450 </directive>
451 451
452 452
453 <directive name="least_time"> 453 <directive name="least_time">
454 <syntax><literal>connect</literal> | 454 <syntax>
455 <literal>first_byte</literal> | 455 <literal>connect</literal> |
456 <literal>last_byte</literal></syntax> 456 <literal>first_byte</literal> |
457 <literal>last_byte</literal>
458 [<literal>inflight</literal>]</syntax>
457 <default/> 459 <default/>
458 <context>upstream</context> 460 <context>upstream</context>
459 461
460 <para> 462 <para>
461 Задаёт для группы метод балансировки нагрузки, при котором соединение 463 Задаёт для группы метод балансировки нагрузки, при котором соединение
470 то учитывается время соединения с сервером группы. 472 то учитывается время соединения с сервером группы.
471 Если указан параметр <literal>first_byte</literal>, 473 Если указан параметр <literal>first_byte</literal>,
472 то учитывается время получения первого байта данных. 474 то учитывается время получения первого байта данных.
473 Если указан параметр <literal>last_byte</literal>, 475 Если указан параметр <literal>last_byte</literal>,
474 то учитывается время получения ответа. 476 то учитывается время получения ответа.
477 Если указан параметр <literal>inflight</literal> (1.11.6),
478 то также учитываются незавершённые соединения.
479 <note>
480 До версии 1.11.6
481 незавершённые соединения учитывались по умолчанию.
482 </note>
475 </para> 483 </para>
476 484
477 <para> 485 <para>
478 <note> 486 <note>
479 Эта директива доступна как часть 487 Эта директива доступна как часть
531 задаёт число последовательных успешных проверок для определённого сервера, 539 задаёт число последовательных успешных проверок для определённого сервера,
532 после которых сервер будет считаться работоспособным, 540 после которых сервер будет считаться работоспособным,
533 по умолчанию 1. 541 по умолчанию 1.
534 </tag-desc> 542 </tag-desc>
535 543
544 <tag-name id="health_check_mandatory">
545 <literal>mandatory</literal>
546 </tag-name>
547 <tag-desc>
548 устанавливает исходное состояние “checking” для сервера
549 до завершения первой проверки работоспособности (1.11.7).
550 Если параметр не указан,
551 то исходно сервер будет считаться работоспособным.
552 </tag-desc>
553
536 <tag-name id="hc_match"> 554 <tag-name id="hc_match">
537 <literal>match</literal>=<value>имя</value> 555 <literal>match</literal>=<value>имя</value>
538 </tag-name> 556 </tag-name>
539 <tag-desc> 557 <tag-desc>
540 указывает на блок <literal>match</literal> с условиями, которым должно 558 указывает на блок <literal>match</literal> с условиями, которым должно
541 удовлетворять соединение, чтобы результат проверки считался успешным. 559 удовлетворять соединение, чтобы результат проверки считался успешным.
542 По умолчанию проверяется лишь возможность установки TCP-соединения с сервером. 560 По умолчанию для TCP проверяется
561 лишь возможность установки TCP-соединения с сервером,
562 для <link id="health_check_udp">UDP</link> проверяется отсутствие
563 сообщения ICMP “<literal>Destination Unreachable</literal>”
564 в ответ на отправленную строку “<literal>nginx health check</literal>”.
565 <note>
566 До версии 1.11.7 по умолчанию для UDP
567 требовалось наличие блока <link id="hc_match">match</link> с параметрами
568 <link id="match_send">send</link> и <link id="match_expect">expect</link>.
569 </note>
543 </tag-desc> 570 </tag-desc>
544 571
545 <tag-name id="health_check_port"> 572 <tag-name id="health_check_port">
546 <literal>port</literal>=<value>число</value> 573 <literal>port</literal>=<value>число</value>
547 </tag-name> 574 </tag-name>
555 <literal>udp</literal> 582 <literal>udp</literal>
556 </tag-name> 583 </tag-name>
557 <tag-desc> 584 <tag-desc>
558 указывает, что для проверки работоспособности будет использоваться протокол 585 указывает, что для проверки работоспособности будет использоваться протокол
559 <literal>UDP</literal> 586 <literal>UDP</literal>
560 вместо протокола <literal>TCP</literal>, используемого по умолчанию (1.9.13); 587 вместо протокола <literal>TCP</literal>, используемого по умолчанию (1.9.13).
561 требует наличия блока <link id="hc_match">match</link> с параметрами
562 <link id="match_send">send</link> и <link id="match_expect">expect</link>.
563 </tag-desc> 588 </tag-desc>
564 589
565 </list> 590 </list>
566 </para> 591 </para>
567 592
576 для каждого сервера группы <literal>backend</literal> 601 для каждого сервера группы <literal>backend</literal>
577 с интервалом в 5 секунд проверяется возможность установки TCP-соединения. 602 с интервалом в 5 секунд проверяется возможность установки TCP-соединения.
578 Если соединение с сервером не может быть установлено, 603 Если соединение с сервером не может быть установлено,
579 проверка считается неуспешной и сервер 604 проверка считается неуспешной и сервер
580 признаётся неработоспособным. 605 признаётся неработоспособным.
581 На неработоспособные серверы клиентские соединения передаваться не будут. 606 На неработоспособные серверы и серверы в состоянии “checking”
607 клиентские соединения передаваться не будут.
582 </para> 608 </para>
583 609
584 <para> 610 <para>
585 Проверки работоспособности могут тестировать данные, полученные от сервера. 611 Проверки работоспособности могут тестировать данные, полученные от сервера.
586 Тесты настраиваются отдельно при помощи директивы <link id="match"/> 612 Тесты настраиваются отдельно при помощи директивы <link id="match"/>