Mercurial > hg > nginx-site
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"/> |