Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_upstream_module.xml @ 1700:1dbef8ab47c7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated description of service parameter in upstream.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 26 Apr 2016 19:31:57 +0300
parents 57c3f36b3b6a
children b536cb3dbccf
comparison
equal deleted inserted replaced
1699:6c96a644b0b3 1700:1dbef8ab47c7
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_upstream_module" 10 <module name="Модуль ngx_http_upstream_module"
11 link="/ru/docs/http/ngx_http_upstream_module.html" 11 link="/ru/docs/http/ngx_http_upstream_module.html"
12 lang="ru" 12 lang="ru"
13 rev="47"> 13 rev="48">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_upstream_module</literal> 18 Модуль <literal>ngx_http_upstream_module</literal>
263 <tag-desc> 263 <tag-desc>
264 задаёт имя маршрута к серверу. 264 задаёт имя маршрута к серверу.
265 </tag-desc> 265 </tag-desc>
266 266
267 <tag-name id="service"> 267 <tag-name id="service">
268 <literal>service</literal>=<value>имя</value> | <value>_имя._протокол</value> 268 <literal>service</literal>=<value>имя</value>
269 </tag-name> 269 </tag-name>
270 <tag-desc> 270 <tag-desc>
271 включает преобразование 271 включает преобразование
272 <link url="https://tools.ietf.org/html/rfc2782">SRV</link>-записей 272 <link url="https://tools.ietf.org/html/rfc2782">SRV</link>-записей
273 DNS и задаёт <value>имя</value> сервиса 273 DNS и задаёт <value>имя</value> сервиса (1.9.13).
274 или <value>имя</value> и <value>протокол</value> в следующем формате:
275 <value>_имя._протокол</value> (1.9.13).
276 Если задано только <value>имя</value>, то
277 используется протокол <literal>TCP</literal>.
278 <para>
279 Для работы параметра необходимо указать 274 Для работы параметра необходимо указать
280 параметр <link id="resolve"/> для сервера 275 параметр <link id="resolve"/> для сервера
281 и не указывать порт сервера: 276 и не указывать порт сервера.
277 <para>
278 Если имя сервиса не содержит точку (“<literal>.</literal>”), то
279 имя составляется в соответствии с
280 <link url="https://tools.ietf.org/html/rfc2782">RFC</link>
281 и в префикс службы добавляется протокол TCP.
282 Например, для получения
283 SRV-записи <literal>_http._tcp.backend.example.com</literal>
284 необходимо указать директиву:
282 <example> 285 <example>
283 server backend.example.com service=http resolve; 286 server backend.example.com service=http resolve;
287 </example>
288 Если имя сервиса содержит одну и более точек, то имя составляется
289 при помощи соединения префикса службы и имени сервера.
290 Например, для получения SRV-записей
291 <literal>_http._tcp.backend.example.com</literal>
292 и <literal>server1.backend.example.com</literal>
293 необходимо указать директивы:
294 <example>
284 server backend.example.com service=_http._tcp resolve; 295 server backend.example.com service=_http._tcp resolve;
285 </example> 296 server example.com service=server1.backend resolve;
286 Обе директивы задают одну и ту же SRV-запись: 297 </example>
287 <literal>_http._tcp.backend.example.com</literal>.
288 </para> 298 </para>
289 299
290 <para> 300 <para>
291 SRV-записи с наивысшим приоритетом 301 SRV-записи с наивысшим приоритетом
292 (записи с одинаковым наименьшим значением приоритета) 302 (записи с одинаковым наименьшим значением приоритета)