Mercurial > hg > nginx-site
diff xml/en/docs/stream/ngx_stream_upstream_module.xml @ 1700:1dbef8ab47c7
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 | 1a16dce51bce |
line wrap: on
line diff
--- a/xml/en/docs/stream/ngx_stream_upstream_module.xml +++ b/xml/en/docs/stream/ngx_stream_upstream_module.xml @@ -9,7 +9,7 @@ <module name="Module ngx_stream_upstream_module" link="/en/docs/stream/ngx_stream_upstream_module.html" lang="en" - rev="11"> + rev="12"> <section id="summary"> @@ -243,26 +243,35 @@ stream { </tag-desc> <tag-name id="service"> -<literal>service</literal>=<value>name</value> | <value>_name._protocol</value> +<literal>service</literal>=<value>name</value> </tag-name> <tag-desc> enables resolving of DNS <link url="https://tools.ietf.org/html/rfc2782">SRV</link> -records and sets the service <value>name</value>, -or <value>name</value> and <value>protocol</value> in the following format: -<value>_name._protocol</value> (1.9.13). -If only the <value>name</value> is specified, -the <literal>TCP</literal> protocol is used. -<para> +records and sets the service <value>name</value> (1.9.13). In order for this parameter to work, it is necessary to specify the <link id="resolve"/> parameter for the server -and specify a hostname without a port number: +and specify a hostname without a port number. +<para> +If the service name does not contain a dot (“<literal>.</literal>”), then +the <link url="https://tools.ietf.org/html/rfc2782">RFC</link>-compliant name +is constructed +and the TCP protocol is added to the service prefix. +For example, to look up the +<literal>_http._tcp.backend.example.com</literal> SRV record, +it is necessary to specify the directive: <example> server backend.example.com service=http resolve; -server backend.example.com service=_http._tcp resolve; </example> -Both directives specify the same SRV record: -<literal>_http._tcp.backend.example.com</literal>. +If the service name contains one or more dots, then the name is constructed +by joining the service prefix and the server name. +For example, to look up the <literal>_http._tcp.backend.example.com</literal> +and <literal>server1.backend.example.com</literal> SRV records, +it is necessary to specify the directives: +<example> +server backend.example.com service=_http._tcp resolve; +server example.com service=server1.backend resolve; +</example> </para> <para>