annotate xml/ru/docs/stream/ngx_stream_upstream_hc_module.xml @ 3011:55d49eb065ac

Fixed example in the js_periodic directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 14 Sep 2023 16:38:00 +0100
parents 9dd8c203a54a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
3 <!--
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
4 Copyright (C) Nginx, Inc.
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
5 -->
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
6
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8
1947
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
9 <module name="Модуль ngx_stream_upstream_hc_module"
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
10 link="/ru/docs/stream/ngx_stream_upstream_hc_module.html"
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
11 lang="ru"
2768
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
12 rev="6">
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
13
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14 <section id="summary">
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16 <para>
1947
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
17 Модуль <literal>ngx_stream_upstream_hc_module</literal> (1.9.0)
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
18 позволяет активировать периодические проверки работоспособности серверов в
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
19 <link doc="ngx_stream_upstream_module.xml" id="upstream">группе</link>.
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
20 Группа должна находиться в
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
21 <link doc="ngx_stream_upstream_module.xml" id="zone">зоне разделяемой памяти</link>.
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
22 </para>
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
23
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
24 <para>
1948
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
25 Если проверка работоспособности была неуспешной,
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
26 то сервер признаётся неработоспособным.
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
27 Если для группы задано несколько проверок,
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
28 то при любой неуспешной проверке соответствующий сервер будет
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
29 считаться неработоспособным.
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
30 На неработоспособные серверы и серверы в состоянии “checking”
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
31 клиентские соединения передаваться не будут.
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
32 </para>
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
33
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
34 <para>
1947
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
35 <note>
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
36 Модуль доступен как часть
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
37 <commercial_version>коммерческой подписки</commercial_version>.
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
38 </note>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41 </section>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
44 <section id="example" name="Пример конфигурации">
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46 <para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 <example>
1947
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
48 upstream tcp {
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
49 zone upstream_tcp 64k;
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
50
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
51 server backend1.example.com:12345 weight=5;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
52 server backend2.example.com:12345 fail_timeout=5s slow_start=30s;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
53 server 192.0.2.1:12345 max_fails=3;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
54
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
55 server backup1.example.com:12345 backup;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
56 server backup2.example.com:12345 backup;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
57 }
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
58
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
59 server {
1947
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
60 listen 12346;
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
61 proxy_pass tcp;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
62 health_check;
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63 }
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 </example>
1951
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
65 Для каждого сервера группы <literal>tcp</literal>
1948
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
66 с интервалом в 5 секунд проверяется возможность установки TCP-соединения.
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
67 Если соединение с сервером не может быть установлено,
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
68 проверка считается неуспешной и сервер
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
69 признаётся неработоспособным.
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
70 </para>
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
71
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
72 <para>
1951
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
73 Проверки работоспособности можно настроить для протокола UDP:
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
74 <example>
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
75 upstream dns_upstream {
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
76
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
77 zone dns_zone 64k;
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
78
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
79 server dns1.example.com:53;
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
80 server dns2.example.com:53;
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
81 server dns3.example.com:53;
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
82 }
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
83
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
84 server {
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
85 listen 53 udp;
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
86 proxy_pass dns_upstream;
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
87 health_check udp;
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
88 }
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
89 </example>
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
90 В этом случае проверяется отсутствие
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
91 сообщения ICMP “<literal>Destination Unreachable</literal>”
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
92 в ответ на отправленную строку “<literal>nginx health check</literal>”.
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
93 </para>
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
94
f069d4b7a8df Added udp example to stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1950
diff changeset
95 <para>
1948
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
96 Проверки работоспособности могут тестировать данные, полученные от сервера.
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
97 Тесты настраиваются отдельно при помощи директивы <link id="match"/>
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
98 и указываются в параметре <literal>match</literal> директивы
25962922969a Moved info from stream "health_check" to intro.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1947
diff changeset
99 <link id="health_check"/>.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102 </section>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
105 <section id="directives" name="Директивы">
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
107 <directive name="health_check">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
108 <syntax>[<value>параметры</value>]</syntax>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
109 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
110 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
111
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
112 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
113 Активирует периодические проверки работоспособности серверов в
1947
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
114 <link doc="ngx_stream_upstream_hc_module.xml" id="upstream">группе</link>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
115 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
116
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
117 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
118 Могут быть заданы следующие необязательные параметры:
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
119 <list type="tag">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
120
1949
8f9c685dfabd Updated IDs in "health_check" directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1948
diff changeset
121 <tag-name id="health_check_interval">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
122 <literal>interval</literal>=<value>время</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
123 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
124 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
125 задаёт интервал между двумя последовательными проверками,
1891
6225d50b3cba Replaced semicolon with dot in health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1866
diff changeset
126 по умолчанию 5 секунд.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
127 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
128
1866
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
129 <tag-name id="health_check_jitter">
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
130 <literal>jitter</literal>=<value>время</value>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
131 </tag-name>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
132 <tag-desc>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
133 задаёт время, в пределах которого
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
134 случайным образом задерживается каждая проверка,
1891
6225d50b3cba Replaced semicolon with dot in health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1866
diff changeset
135 по умолчанию задержки нет.
1866
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
136 </tag-desc>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
137
1949
8f9c685dfabd Updated IDs in "health_check" directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1948
diff changeset
138 <tag-name id="health_check_fails">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
139 <literal>fails</literal>=<value>число</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
140 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
141 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
142 задаёт число последовательных неуспешных проверок для определённого сервера,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
143 после которых сервер будет считаться неработоспособным,
1891
6225d50b3cba Replaced semicolon with dot in health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1866
diff changeset
144 по умолчанию 1.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
145 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
146
1949
8f9c685dfabd Updated IDs in "health_check" directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1948
diff changeset
147 <tag-name id="health_check_passes">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
148 <literal>passes</literal>=<value>число</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
149 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
150 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
151 задаёт число последовательных успешных проверок для определённого сервера,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
152 после которых сервер будет считаться работоспособным,
1891
6225d50b3cba Replaced semicolon with dot in health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1866
diff changeset
153 по умолчанию 1.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
154 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
155
1925
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
156 <tag-name id="health_check_mandatory">
2768
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
157 <literal>mandatory</literal> [<literal>persistent</literal>]
1925
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
158 </tag-name>
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
159 <tag-desc>
2768
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
160 <para>
1925
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
161 устанавливает исходное состояние “checking” для сервера
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
162 до завершения первой проверки работоспособности (1.11.7).
1950
ef22a80a2696 Described the "checking" state in "health_check mandatory"
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1949
diff changeset
163 На серверы в состоянии “checking” клиентские соединения передаваться не будут.
1925
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
164 Если параметр не указан,
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
165 то исходно сервер будет считаться работоспособным.
2768
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
166 </para>
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
167
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
168 <para id="health_check_persistent">
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
169 Параметр <literal>persistent</literal> (1.21.1)
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
170 устанавливает исходное состояние “up” для сервера после перезагрузки nginx
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
171 в случае, если до перезагрузки сервер считался работоспособным.
9dd8c203a54a Updated docs for the upcoming NGINX Plus release.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1951
diff changeset
172 </para>
1925
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
173 </tag-desc>
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
174
1949
8f9c685dfabd Updated IDs in "health_check" directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1948
diff changeset
175 <tag-name id="health_check_match">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
176 <literal>match</literal>=<value>имя</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
177 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
178 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
179 указывает на блок <literal>match</literal> с условиями, которым должно
1891
6225d50b3cba Replaced semicolon with dot in health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1866
diff changeset
180 удовлетворять соединение, чтобы результат проверки считался успешным.
1925
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
181 По умолчанию для TCP проверяется
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
182 лишь возможность установки TCP-соединения с сервером,
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
183 для <link id="health_check_udp">UDP</link> проверяется отсутствие
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
184 сообщения ICMP “<literal>Destination Unreachable</literal>”
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
185 в ответ на отправленную строку “<literal>nginx health check</literal>”.
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
186 <note>
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
187 До версии 1.11.7 по умолчанию для UDP
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
188 требовалось наличие блока <link id="hc_match">match</link> с параметрами
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
189 <link id="match_send">send</link> и <link id="match_expect">expect</link>.
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
190 </note>
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
191 </tag-desc>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
192
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
193 <tag-name id="health_check_port">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
194 <literal>port</literal>=<value>число</value>
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
195 </tag-name>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
196 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
197 задаёт порт, используемый при подключении к серверу
1891
6225d50b3cba Replaced semicolon with dot in health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1866
diff changeset
198 для проверки его работоспособности (1.9.7).
1947
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
199 По умолчанию совпадает с портом
6b6d0e844bf7 Moved "health_check" and "match" to ngx_stream_upstream_hc_module.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1925
diff changeset
200 <link doc="ngx_stream_upstream_module.xml" id="server">сервера</link>.
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
201 </tag-desc>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
202
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
203 <tag-name id="health_check_udp">
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
204 <literal>udp</literal>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
205 </tag-name>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
206 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
207 указывает, что для проверки работоспособности будет использоваться протокол
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
208 <literal>UDP</literal>
1925
a58b35cc0823 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1891
diff changeset
209 вместо протокола <literal>TCP</literal>, используемого по умолчанию (1.9.13).
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
210 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
211
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
212 </list>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
213 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
214
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
215 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
216
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
217
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
218 <directive name="health_check_timeout">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
219 <syntax><value>время</value></syntax>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
220 <default>5s</default>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
221 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
222 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
223
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
224 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
225 Переопределяет значение
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
226 <link doc="ngx_stream_proxy_module.xml" id="proxy_timeout"/>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
227 для проверок работоспособности.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
228 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
229
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
230 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
231
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
232
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
233 <directive name="match">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
234 <syntax block="yes"><value>имя</value> </syntax>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
235 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
236 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
237
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
238 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
239 Задаёт именованный набор тестов для для анализа ответов сервера
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
240 на запросы проверки работоспособности.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
241 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
242
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
243 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
244 Могут быть заданы следующие параметры:
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
245 <list type="tag">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
246
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
247 <tag-name id="match_send">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
248 <literal>send</literal> <value>строка</value>;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
249 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
250 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
251 отправляет <value>строку</value> на сервер;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
252 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
253
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
254 <tag-name id="match_expect">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
255 <literal>expect</literal> <value>стока</value> |
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
256 <literal>~</literal> <value>regex</value>;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
257 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
258 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
259 текстовая строка (1.9.12) или регулярное выражение,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
260 которым должны соответствовать данные, полученные с сервера.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
261 Регулярное выражение задаётся либо с модификатором
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
262 “<literal>~*</literal>” (для поиска совпадения без учёта регистра символов),
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
263 либо с модификатором “<literal>~</literal>” (с учётом регистра).
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
264 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
265
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
266 </list>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
267 Параметры <literal>send</literal> и <literal>expect</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
268 могут содержать строки в шестнадцатеричном виде
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
269 с префиксом “<literal>\x</literal>”
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
270 и последующими двумя шестнадцатеричными цифрами,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
271 например “<literal>\x80</literal>” (1.9.12).
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
272 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
273
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
274 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
275 Проверка работоспособности считается успешной, если
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
276 <list type="bullet">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
277 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
278 TCP-соединение успешно установлено;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
279 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
280
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
281 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
282 <value>строка</value> из параметра <literal>send</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
283 была отправлена (если была задана);
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
284 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
285
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
286 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
287 данные, полученные от сервера, совпали со строкой или регулярным выражением
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
288 из параметра <literal>expect</literal> (если был задан);
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
289 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
290
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
291 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
292 истёкшее время не превышает значение, указанное
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
293 в директиве <link id="health_check_timeout"/>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
294 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
295
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
296 </list>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
297 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
298
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
299 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
300 Пример:
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
301 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
302 upstream backend {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
303 zone upstream_backend 10m;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
304 server 127.0.0.1:12345;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
305 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
306
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
307 match http {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
308 send "GET / HTTP/1.0\r\nHost: localhost\r\n\r\n";
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
309 expect ~ "200 OK";
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
310 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
311
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
312 server {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
313 listen 12346;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
314 proxy_pass backend;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
315 health_check match=http;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
316 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
317 </example>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
318 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
319
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
320 <para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
321 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
322 Проверяются лишь первые байты данных
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
323 <link doc="ngx_stream_proxy_module.xml" id="proxy_buffer_size"/>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
324 полученные от сервера.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
325 </note>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
326 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
327
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
328 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
329
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
330 </section>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
331
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
332 </module>