annotate xml/ru/docs/stream/ngx_stream_upstream_module.xml @ 1866:6f2c5a36b4d1

Documented the "jitter" parameter for health_check.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 15 Dec 2016 16:56:46 +0300
parents 0160e8784417
children 6225d50b3cba
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
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
9 <module name="Модуль ngx_stream_upstream_module"
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
10 link="/ru/docs/stream/ngx_stream_upstream_module.html"
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
11 lang="ru"
1866
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
12 rev="22">
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>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
17 Модуль <literal>ngx_stream_upstream_module</literal> (1.9.0)
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
18 позволяет описывать группы серверов,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
19 которые могут использоваться в директиве
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
20 <link doc="ngx_stream_proxy_module.xml" id="proxy_pass"/>.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23 </section>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
26 <section id="example" name="Пример конфигурации">
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 <para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29 <example>
1406
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
30 upstream <emphasis>backend</emphasis> {
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
31 hash $remote_addr consistent;
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
32
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
33 server backend1.example.com:12345 weight=5;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
34 server backend2.example.com:12345;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
35 server unix:/tmp/backend3;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
36
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
37 server backup1.example.com:12345 backup;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
38 server backup2.example.com:12345 backup;
1406
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
39 }
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
40
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
41 server {
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
42 listen 12346;
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
43 proxy_pass <emphasis>backend</emphasis>;
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
44 }
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
45 </example>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
46 </para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
47
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
48 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
49 Динамически настраиваемая группа,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
50 доступна как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
51 <commercial_version>коммерческой подписки</commercial_version>:
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
52 <example>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
53 resolver 10.0.0.1;
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 upstream <emphasis>dynamic</emphasis> {
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
56 zone upstream_dynamic 64k;
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 server backend1.example.com:12345 weight=5;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
59 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
60 server 192.0.2.1:12345 max_fails=3;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
61 server backend3.example.com:12345 resolve;
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
62 server backend4.example.com service=http resolve;
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
63
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
64 server backup1.example.com:12345 backup;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
65 server backup2.example.com:12345 backup;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
66 }
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
67
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
68 server {
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
69 listen 12346;
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
70 proxy_pass <emphasis>dynamic</emphasis>;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
71 health_check;
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
72 }
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
73 </example>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
74 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
75
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
76 </section>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
77
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
78
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
79 <section id="directives" name="Директивы">
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
80
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
81 <directive name="upstream">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
82 <syntax block="yes"><value>название</value></syntax>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 <default/>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 <context>stream</context>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
87 Описывает группу серверов.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
88 Серверы могут слушать на разных портах.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
89 Кроме того, можно одновременно использовать серверы,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
90 слушающие на TCP- и UNIX-сокетах.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
94 Пример:
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 <example>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96 upstream backend {
1406
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
97 server backend1.example.com:12345 weight=5;
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
98 server 127.0.0.1:12345 max_fails=3 fail_timeout=30s;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
99 server unix:/tmp/backend2;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
100 server backend3.example.com:12345 resolve;
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101
1406
ea73cd9d4cdb Changed stream_upstream examples.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1405
diff changeset
102 server backup1.example.com:12345 backup;
1367
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 </example>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
108 По умолчанию соединения распределяются по серверам циклически
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
109 (в режиме round-robin) с учётом весов серверов.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
110 В вышеприведённом примере каждые 7 соединений будут распределены так:
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
111 5 соединений на <literal>backend1.example.com:12345</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
112 и по одному соединению на второй и третий серверы.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
113 Если при попытке работы с сервером происходит ошибка, то соединение
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
114 передаётся следующему серверу, и так далее до тех пор, пока не будут опробованы
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
115 все работающие серверы.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
116 Если связь с серверами не удалась, соединение будет закрыто.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119 </directive>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
120
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
121
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
122 <directive name="server">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
123 <syntax><value>адрес</value> [<value>параметры</value>]</syntax>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124 <default/>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125 <context>upstream</context>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
127 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
128 Задаёт <value>адрес</value> и другие <value>параметры</value>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
129 сервера.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
130 Адрес может быть указан в виде доменного имени или IP-адреса,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
131 и обязательного порта, или в виде пути UNIX-сокета, который
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
132 указывается после префикса “<literal>unix:</literal>”.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
133 Доменное имя, которому соответствует несколько IP-адресов,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
134 задаёт сразу несколько серверов.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
138 Могут быть заданы следующие параметры:
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139 <list type="tag">
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141 <tag-name id="weight">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
142 <literal>weight</literal>=<value>число</value>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 </tag-name>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
145 задаёт вес сервера, по умолчанию 1.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146 </tag-desc>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147
1800
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
148 <tag-name id="max_conns">
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
149 <literal>max_conns</literal>=<value>число</value>
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
150 </tag-name>
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
151 <tag-desc>
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
152 ограничивает максимальное <value>число</value> одновременных
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
153 соединений к проксируемому серверу (1.11.5).
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
154 Значение по умолчанию равно 0 и означает, что ограничения нет.
1801
592f9fa804f6 Added info about shared memory to max_conns.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1800
diff changeset
155 Если группа не находится в <link id="zone">зоне разделяемой памяти</link>,
592f9fa804f6 Added info about shared memory to max_conns.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1800
diff changeset
156 то ограничение работает отдельно для каждого рабочего процесса.
1800
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
157 <note>
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
158 До версии 1.11.5 этот параметр был доступен как часть
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
159 <commercial_version>коммерческой подписки</commercial_version>.
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
160 </note>
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
161 </tag-desc>
9d722e4153ab Documented the "max_conns" parameter as opensource.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1799
diff changeset
162
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163 <tag-name id="max_fails">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
164 <literal>max_fails</literal>=<value>число</value>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165 </tag-name>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
167 задаёт число неудачных попыток работы с сервером, которые должны произойти
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
168 в течение времени, заданного параметром <literal>fail_timeout</literal>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
169 чтобы сервер считался недоступным на период времени, также заданный
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
170 параметром <literal>fail_timeout</literal>.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
171 По умолчанию число попыток устанавливается равным 1.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
172 Нулевое значение отключает учёт попыток.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
173 В данном случае неудачной попыткой считается ошибка или таймаут
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
174 при установке соединения с сервером.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175 </tag-desc>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
177 <tag-name id="fail_timeout">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
178 <literal>fail_timeout</literal>=<value>время</value>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
179 </tag-name>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
180 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
181 задаёт
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
182 <list type="bullet">
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
183
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
184 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
185 время, в течение которого должно произойти заданное число неудачных
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
186 попыток работы с сервером для того, чтобы сервер считался недоступным;
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
187 </listitem>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
188
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
189 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
190 и время, в течение которого сервер будет считаться недоступным.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
191 </listitem>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
192
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
193 </list>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
194 По умолчанию параметр равен 10 секундам.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
195 </tag-desc>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
196
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
197 <tag-name id="backup">
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
198 <literal>backup</literal>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
199 </tag-name>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
200 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
201 помечает сервер как запасной сервер.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
202 На него будут передаваться соединения в случае,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
203 если не работают основные серверы.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
204 </tag-desc>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
205
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
206 <tag-name id="down">
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
207 <literal>down</literal>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
208 </tag-name>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
209 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
210 помечает сервер как постоянно недоступный.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
211 </tag-desc>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
212
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
213 </list>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
214 </para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
215
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
216 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
217 Кроме того,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
218 следующие параметры доступны как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
219 <commercial_version>коммерческой подписки</commercial_version>:
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
220 <list type="tag">
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
221
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
222 <tag-name id="resolve">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
223 <literal>resolve</literal>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
224 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
225 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
226 отслеживает изменения IP-адресов, соответствующих доменному имени сервера,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
227 и автоматически изменяет конфигурацию группы
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
228 без необходимости перезапуска nginx.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
229 Группа должна находиться в <link id="zone">зоне разделяемой памяти</link>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
230 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
231 Для работы этого параметра
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
232 директива <link doc="ngx_stream_core_module.xml" id="resolver"/>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
233 должна быть задана в блоке
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
234 <link doc="ngx_stream_core_module.xml" id="stream"/>.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
235 Пример:
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
236 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
237 stream {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
238 resolver 10.0.0.1;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
239
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
240 upstream u {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
241 zone ...;
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 server example.com:12345 resolve;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
244 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
245 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
246 </example>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
247 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
248 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
249
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
250 <tag-name id="service">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
251 <literal>service</literal>=<value>имя</value>
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
252 </tag-name>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
253 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
254 включает преобразование
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
255 <link url="https://tools.ietf.org/html/rfc2782">SRV</link>-записей
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
256 DNS и задаёт <value>имя</value> сервиса (1.9.13).
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
257 Для работы параметра необходимо указать
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
258 параметр <link id="resolve"/> для сервера
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
259 и не указывать порт сервера.
1700
1dbef8ab47c7 Updated description of service parameter in upstream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
260 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
261 Если имя сервиса не содержит точку (“<literal>.</literal>”), то
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
262 имя составляется в соответствии с
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
263 <link url="https://tools.ietf.org/html/rfc2782">RFC</link>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
264 и в префикс службы добавляется протокол TCP.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
265 Например, для получения
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
266 SRV-записи <literal>_http._tcp.backend.example.com</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
267 необходимо указать директиву:
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
268 <example>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
269 server backend.example.com service=http resolve;
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
270 </example>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
271 Если имя сервиса содержит одну и более точек, то имя составляется
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
272 при помощи соединения префикса службы и имени сервера.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
273 Например, для получения SRV-записей
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
274 <literal>_http._tcp.backend.example.com</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
275 и <literal>server1.backend.example.com</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
276 необходимо указать директивы:
1700
1dbef8ab47c7 Updated description of service parameter in upstream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
277 <example>
1dbef8ab47c7 Updated description of service parameter in upstream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
278 server backend.example.com service=_http._tcp resolve;
1dbef8ab47c7 Updated description of service parameter in upstream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
279 server example.com service=server1.backend resolve;
1dbef8ab47c7 Updated description of service parameter in upstream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1680
diff changeset
280 </example>
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
281 </para>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
282
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
283 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
284 SRV-записи с наивысшим приоритетом
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
285 (записи с одинаковым наименьшим значением приоритета)
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
286 преобразуются в основные серверы,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
287 остальные SRV-записи преобразуются в запасные серверы.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
288 Если в конфигурации сервера указан параметр <link id="backup"/>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
289 высокоприоритетные SRV-записи преобразуются в запасные серверы,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
290 остальные SRV-записи игнорируются.
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
291 </para>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
292 </tag-desc>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
293
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
294 <tag-name id="slow_start">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
295 <literal>slow_start</literal>=<value>время</value>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
296 </tag-name>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
297 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
298 задаёт <value>время</value>, в течение которого вес сервера
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
299 восстановится от нуля до своего номинального значения в ситуации, когда
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
300 неработоспособный (unhealthy) сервер вновь становится работоспособным
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
301 (<link id="health_check">healthy</link>)
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
302 или когда сервер становится доступным по прошествии времени,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
303 в течение которого он считался <link id="fail_timeout">недоступным</link>.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
304 Значение по умолчанию равно нулю и означает, что медленный старт выключен.
1817
0160e8784417 Documented behavior of server slow_start with ip_hash and hash.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1809
diff changeset
305 <note>
0160e8784417 Documented behavior of server slow_start with ip_hash and hash.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1809
diff changeset
306 Параметр нельзя использовать совместно с
0160e8784417 Documented behavior of server slow_start with ip_hash and hash.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1809
diff changeset
307 методом балансировки нагрузки <link id="hash"/>.
0160e8784417 Documented behavior of server slow_start with ip_hash and hash.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1809
diff changeset
308 </note>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
309 </tag-desc>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
310
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
311 </list>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
312 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
313
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
314 <para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
315 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
316 Если в группе только один сервер, параметры <literal>max_fails</literal>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
317 <literal>fail_timeout</literal> и <literal>slow_start</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
318 игнорируются и такой сервер никогда не будет считаться недоступным.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
319 </note>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
320 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
321
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
322 </directive>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
323
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
324
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
325 <directive name="zone">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
326 <syntax><value>имя</value> [<value>размер</value>]</syntax>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
327 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
328 <context>upstream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
329
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
330 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
331 Задаёт <value>имя</value> и <value>размер</value> зоны разделяемой памяти,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
332 в которой хранятся конфигурация группы и её рабочее состояние,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
333 разделяемые между рабочими процессами.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
334 В одной и той же зоне могут быть сразу несколько групп.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
335 В этом случае достаточно указать <value>размер</value> только один раз.
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
336 </para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
337
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
338 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
339 Дополнительно, как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
340 <commercial_version>коммерческой подписки</commercial_version>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
341 в таких группах для изменения состава группы
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
342 или настроек отдельных серверов
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
343 нет необходимости перезапускать nginx.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
344 Конфигурация доступна через специальный location,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
345 в котором указана директива
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
346 <link doc="../http/ngx_http_upstream_conf_module.xml" id="upstream_conf"/>.
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
347 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
348
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
349 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
350
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
351
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
352 <directive name="state">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
353 <syntax><value>файл</value></syntax>
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
354 <default/>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
355 <context>upstream</context>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
356 <appeared-in>1.9.7</appeared-in>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
357
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
358 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
359 Задаёт <value>файл</value>, в котором хранится состояние
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
360 динамически настраиваемой группы.
1809
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
361 </para>
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
362
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
363 <para>
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
364 Примеры:
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
365 <example>
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
366 state /var/lib/nginx/state/servers.conf; # путь для Linux
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
367 state /var/db/nginx/state/servers.conf; # путь для FreeBSD
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
368 </example>
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
369 </para>
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
370
2245f2827e2f Added examples of Linux and FreeBSD paths to "state" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1801
diff changeset
371 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
372 В данный момент состояние ограничено списком серверов с их параметрами.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
373 Файл читается при парсинге конфигурации и обновляется каждый раз при
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
374 <link doc="ngx_http_upstream_conf_module.xml" id="upstream_conf">изменении</link>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
375 конфигурации группы.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
376 Изменение содержимого файла напрямую не рекомендуется.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
377 Директиву нельзя использовать
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
378 совместно с директивой <link id="server"/>.
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
379 </para>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
380
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
381 <para>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
382 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
383 Изменения, совершённые в момент
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
384 <link doc="../control.xml" id="reconfiguration">перезагрузки конфигурации</link>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
385 или <link doc="../control.xml" id="upgrade">обновления бинарного файла</link>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
386 могут быть потеряны.
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
387 </note>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
388 </para>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
389
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
390 <para>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
391 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
392 Эта директива доступна как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
393 <commercial_version>коммерческой подписки</commercial_version>.
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
394 </note>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
395 </para>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
396
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
397 </directive>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
398
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
399
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
400 <directive name="hash">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
401 <syntax><value>ключ</value> [<literal>consistent</literal>]</syntax>
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
402 <default/>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
403 <context>upstream</context>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
404
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
405 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
406 Задаёт метод балансировки нагрузки для группы, при котором
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
407 соответствие клиента серверу определяется при помощи
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
408 хэшированного значения <value>ключа</value>.
1744
ab56dcd73af2 Added variables to stream hash, limit_conn_zone, proxy_bind.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1728
diff changeset
409 В качестве <value>ключа</value> может использоваться текст, переменные
ab56dcd73af2 Added variables to stream hash, limit_conn_zone, proxy_bind.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1728
diff changeset
410 и их комбинации (1.11.2).
ab56dcd73af2 Added variables to stream hash, limit_conn_zone, proxy_bind.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1728
diff changeset
411 Пример использования:
ab56dcd73af2 Added variables to stream hash, limit_conn_zone, proxy_bind.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1728
diff changeset
412 <example>
ab56dcd73af2 Added variables to stream hash, limit_conn_zone, proxy_bind.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1728
diff changeset
413 hash $remote_addr;
ab56dcd73af2 Added variables to stream hash, limit_conn_zone, proxy_bind.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1728
diff changeset
414 </example>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
415 Следует отметить, что любое добавление или удаление серверов в группе
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
416 может привести к перераспределению большинства ключей на другие серверы.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
417 Метод совместим с библиотекой Perl
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
418 <link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link>.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
419 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
420
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
421 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
422 Если задан параметр <literal>consistent</literal>, то вместо
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
423 вышеописанного метода будет использоваться метод консистентного хэширования
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
424 <link url="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</link>.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
425 Метод гарантирует, что при добавлении сервера в группу или его удалении
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
426 на другие серверы будет перераспределено минимальное число ключей.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
427 Применение метода для кэширующих серверов обеспечивает
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
428 больший процент попаданий в кэш.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
429 Метод совместим с библиотекой Perl
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
430 <link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached%3A%3AFast">Cache::Memcached::Fast</link>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
431 при значении параметра <value>ketama_points</value> равным 160.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
432 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
433
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
434 </directive>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
435
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
436
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
437 <directive name="least_conn">
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
438 <syntax/>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
439 <default/>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
440 <context>upstream</context>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
441
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
442 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
443 Задаёт для группы метод балансировки нагрузки, при котором соединение
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
444 передаётся серверу с наименьшим числом активных соединений,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
445 с учётом весов серверов.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
446 Если подходит сразу несколько серверов, они выбираются циклически
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
447 (в режиме round-robin) с учётом их весов.
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
448 </para>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
449
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
450 </directive>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
451
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
452
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
453 <directive name="least_time">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
454 <syntax><literal>connect</literal> |
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
455 <literal>first_byte</literal> |
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
456 <literal>last_byte</literal></syntax>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
457 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
458 <context>upstream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
459
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
460 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
461 Задаёт для группы метод балансировки нагрузки, при котором соединение
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
462 передаётся серверу с наименьшими средним временем ответа и
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
463 числом активных соединений с учётом весов серверов.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
464 Если подходит сразу несколько серверов, то они выбираются циклически
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
465 (в режиме round-robin) с учётом их весов.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
466 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
467
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
468 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
469 Если указан параметр <literal>connect</literal>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
470 то учитывается время соединения с сервером группы.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
471 Если указан параметр <literal>first_byte</literal>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
472 то учитывается время получения первого байта данных.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
473 Если указан параметр <literal>last_byte</literal>,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
474 то учитывается время получения ответа.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
475 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
476
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
477 <para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
478 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
479 Эта директива доступна как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
480 <commercial_version>коммерческой подписки</commercial_version>.
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
481 </note>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
482 </para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
483
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
484 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
485
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
486
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
487 <directive name="health_check">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
488 <syntax>[<value>параметры</value>]</syntax>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
489 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
490 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
491
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
492 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
493 Активирует периодические проверки работоспособности серверов в
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
494 <link id="upstream">группе</link>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
495 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
496
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
497 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
498 Могут быть заданы следующие необязательные параметры:
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
499 <list type="tag">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
500
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
501 <tag-name id="interval">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
502 <literal>interval</literal>=<value>время</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
503 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
504 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
505 задаёт интервал между двумя последовательными проверками,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
506 по умолчанию 5 секунд;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
507 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
508
1866
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
509 <tag-name id="health_check_jitter">
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
510 <literal>jitter</literal>=<value>время</value>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
511 </tag-name>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
512 <tag-desc>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
513 задаёт время, в пределах которого
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
514 случайным образом задерживается каждая проверка,
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
515 по умолчанию задержки нет;
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
516 </tag-desc>
6f2c5a36b4d1 Documented the "jitter" parameter for health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1817
diff changeset
517
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
518 <tag-name id="fails">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
519 <literal>fails</literal>=<value>число</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
520 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
521 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
522 задаёт число последовательных неуспешных проверок для определённого сервера,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
523 после которых сервер будет считаться неработоспособным,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
524 по умолчанию 1;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
525 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
526
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
527 <tag-name id="passes">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
528 <literal>passes</literal>=<value>число</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
529 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
530 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
531 задаёт число последовательных успешных проверок для определённого сервера,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
532 после которых сервер будет считаться работоспособным,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
533 по умолчанию 1;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
534 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
535
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
536 <tag-name id="hc_match">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
537 <literal>match</literal>=<value>имя</value>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
538 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
539 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
540 указывает на блок <literal>match</literal> с условиями, которым должно
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
541 удовлетворять соединение, чтобы результат проверки считался успешным;
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
542 по умолчанию проверяется лишь возможность установки TCP-соединения с сервером;
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
543 </tag-desc>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
544
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
545 <tag-name id="health_check_port">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
546 <literal>port</literal>=<value>число</value>
1636
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
547 </tag-name>
44c4323144c5 Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1581
diff changeset
548 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
549 задаёт порт, используемый при подключении к серверу
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
550 для проверки его работоспособности (1.9.7);
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
551 по умолчанию совпадает с портом <link id="server">сервера</link>.
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
552 </tag-desc>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
553
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
554 <tag-name id="health_check_udp">
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
555 <literal>udp</literal>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
556 </tag-name>
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
557 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
558 указывает, что для проверки работоспособности будет использоваться протокол
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
559 <literal>UDP</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
560 вместо протокола <literal>TCP</literal>, используемого по умолчанию (1.9.13);
1799
386a9a8a7ddc Fixed a typo in the "udp" parameter of stream health_check.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1774
diff changeset
561 требует наличия блока <link id="hc_match">match</link> с параметрами
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
562 <link id="match_send">send</link> и <link id="match_expect">expect</link>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
563 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
564
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
565 </list>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
566 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
567
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
568 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
569 В примере
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
570 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
571 server {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
572 proxy_pass backend;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
573 health_check;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
574 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
575 </example>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
576 для каждого сервера группы <literal>backend</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
577 с интервалом в 5 секунд проверяется возможность установки TCP-соединения.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
578 Если соединение с сервером не может быть установлено,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
579 проверка считается неуспешной и сервер
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
580 признаётся неработоспособным.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
581 На неработоспособные серверы клиентские соединения передаваться не будут.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
582 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
583
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
584 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
585 Проверки работоспособности могут тестировать данные, полученные от сервера.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
586 Тесты настраиваются отдельно при помощи директивы <link id="match"/>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
587 и указываются в параметре <literal>match</literal>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
588 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
589
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
590 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
591 Группа должна находиться в <link id="zone">зоне разделяемой памяти</link>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
592 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
593
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
594 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
595 Если для группы задано несколько проверок,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
596 то при любой неуспешной проверке соответствующий сервер будет
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
597 считаться неработоспособным.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
598 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
599
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
600 <para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
601 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
602 Эта директива доступна как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
603 <commercial_version>коммерческой подписки</commercial_version>.
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
604 </note>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
605 </para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
606
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
607 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
608
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
609
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
610 <directive name="health_check_timeout">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
611 <syntax><value>время</value></syntax>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
612 <default>5s</default>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
613 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
614 <context>server</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
615
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
616 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
617 Переопределяет значение
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
618 <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
619 для проверок работоспособности.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
620 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
621
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
622 <para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
623 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
624 Эта директива доступна как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
625 <commercial_version>коммерческой подписки</commercial_version>.
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
626 </note>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
627 </para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
628
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
629 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
630
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
631
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
632 <directive name="match">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
633 <syntax block="yes"><value>имя</value> </syntax>
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
634 <default/>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
635 <context>stream</context>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
636
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
637 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
638 Задаёт именованный набор тестов для для анализа ответов сервера
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
639 на запросы проверки работоспособности.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
640 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
641
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
642 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
643 Могут быть заданы следующие параметры:
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
644 <list type="tag">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
645
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
646 <tag-name id="match_send">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
647 <literal>send</literal> <value>строка</value>;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
648 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
649 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
650 отправляет <value>строку</value> на сервер;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
651 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
652
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
653 <tag-name id="match_expect">
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
654 <literal>expect</literal> <value>стока</value> |
1680
57c3f36b3b6a Updated docs for the upcoming NGINX Plus release.
Ruslan Ermilov <ru@nginx.com>
parents: 1654
diff changeset
655 <literal>~</literal> <value>regex</value>;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
656 </tag-name>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
657 <tag-desc>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
658 текстовая строка (1.9.12) или регулярное выражение,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
659 которым должны соответствовать данные, полученные с сервера.
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
660 Регулярное выражение задаётся либо с модификатором
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
661 “<literal>~*</literal>” (для поиска совпадения без учёта регистра символов),
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
662 либо с модификатором “<literal>~</literal>” (с учётом регистра).
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
663 </tag-desc>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
664
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
665 </list>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
666 Параметры <literal>send</literal> и <literal>expect</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
667 могут содержать строки в шестнадцатеричном виде
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
668 с префиксом “<literal>\x</literal>”
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
669 и последующими двумя шестнадцатеричными цифрами,
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
670 например “<literal>\x80</literal>” (1.9.12).
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
671 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
672
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
673 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
674 Проверка работоспособности считается успешной, если
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
675 <list type="bullet">
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
676 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
677 TCP-соединение успешно установлено;
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
678 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
679
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
680 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
681 <value>строка</value> из параметра <literal>send</literal>
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
682 была отправлена (если была задана);
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
683 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
684
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
685 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
686 данные, полученные от сервера, совпали со строкой или регулярным выражением
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
687 из параметра <literal>expect</literal> (если был задан);
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
688 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
689
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
690 <listitem>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
691 истёкшее время не превышает значение, указанное
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
692 в директиве <link id="health_check_timeout"/>.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
693 </listitem>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
694
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
695 </list>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
696 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
697
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
698 <para>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
699 Пример:
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
700 <example>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
701 upstream backend {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
702 zone upstream_backend 10m;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
703 server 127.0.0.1:12345;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
704 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
705
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
706 match http {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
707 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
708 expect ~ "200 OK";
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
709 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
710
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
711 server {
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
712 listen 12346;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
713 proxy_pass backend;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
714 health_check match=http;
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
715 }
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
716 </example>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
717 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
718
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
719 <para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
720 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
721 Проверяются лишь первые байты данных
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
722 <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
723 полученные от сервера.
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
724 </note>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
725 </para>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
726
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
727 <para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
728 <note>
1728
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
729 Эта директива доступна как часть
f93a5aadad2c Translated the stream upstream module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1727
diff changeset
730 <commercial_version>коммерческой подписки</commercial_version>.
1462
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
731 </note>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
732 </para>
e69e4dbcc760 Documented OSS stream modules.
Vladimir Homutov <vl@nginx.com>
parents: 1450
diff changeset
733
1450
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
734 </directive>
f5b5eefc43cb Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents: 1410
diff changeset
735
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
736 </section>
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
737
1772
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
738
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
739 <section id="variables" name="Встроенные переменные">
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
740
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
741 <para>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
742 Модуль <literal>ngx_stream_upstream_module</literal>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
743 поддерживает следующие встроенные переменные:
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
744 <list type="tag">
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
745
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
746 <tag-name id="var_upstream_addr"><var>$upstream_addr</var></tag-name>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
747 <tag-desc>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
748 хранит IP-адрес и порт или путь к UNIX-сокету сервера группы (1.11.4).
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
749 Если при проксировании были сделаны обращения к нескольким серверам,
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
750 то их адреса разделяются запятой, например
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
751 “<literal>192.168.1.1:12345, 192.168.1.2:12345, unix:/tmp/sock</literal>”.
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
752 </tag-desc>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
753
1773
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
754 <tag-name id="var_upstream_bytes_sent"><var>$upstream_bytes_sent</var></tag-name>
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
755 <tag-desc>
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
756 число байт, переданных на сервер группы (1.11.4).
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
757 Значения нескольких соединений
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
758 разделяются запятыми подобно адресам в переменной
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
759 <link id="var_upstream_addr">$upstream_addr</link>.
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
760 </tag-desc>
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
761
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
762 <tag-name id="var_upstream_bytes_received"><var>$upstream_bytes_received</var></tag-name>
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
763 <tag-desc>
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
764 число байт, полученных от сервера группы (1.11.4).
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
765 Значения нескольких соединений
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
766 разделяются запятыми подобно адресам в переменной
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
767 <link id="var_upstream_addr">$upstream_addr</link>.
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
768 </tag-desc>
9c48a717e001 Documented $upstream_bytes_sent, $upstream_bytes_received in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1772
diff changeset
769
1774
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
770 <tag-name id="var_upstream_connect_time"><var>$upstream_connect_time</var></tag-name>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
771 <tag-desc>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
772 время установки соединения с сервером группы (1.11.4);
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
773 время хранится в секундах с точностью до миллисекунд.
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
774 Времена нескольких соединений
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
775 разделяются запятыми подобно адресам в переменной
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
776 <link id="var_upstream_addr">$upstream_addr</link>.
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
777 </tag-desc>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
778
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
779 <tag-name id="var_upstream_first_byte_time"><var>$upstream_first_byte_time</var></tag-name>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
780 <tag-desc>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
781 время получения первого байта данных (1.11.4);
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
782 время хранится в секундах с точностью до миллисекунд.
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
783 Времена нескольких соединений
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
784 разделяются запятыми подобно адресам в переменной
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
785 <link id="var_upstream_addr">$upstream_addr</link>.
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
786 </tag-desc>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
787
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
788 <tag-name id="var_upstream_session_time"><var>$upstream_session_time</var></tag-name>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
789 <tag-desc>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
790 длительность сессии в секундах с точностью до миллисекунд (1.11.4).
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
791 Времена нескольких соединений
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
792 разделяются запятыми подобно адресам в переменной
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
793 <link id="var_upstream_addr">$upstream_addr</link>.
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
794 </tag-desc>
e1e0c5b27515 Documented $upstream_connect_time, $upstream_first_byte_time, $upstream_session_time.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1773
diff changeset
795
1772
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
796 </list>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
797 </para>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
798
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
799 </section>
536dc1885e24 Documented the $upstream_addr variable in stream.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1744
diff changeset
800
1367
f1e14d87d833 Updated commercial docs for the upcoming release.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
801 </module>