changeset 1124:d790333947f4

Upstream: the "resolve" parameter of the "server" directive.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 20 Mar 2014 15:42:32 +0400
parents 9a9aa8e9d12c
children 9a95b9026a16
files xml/en/docs/http/ngx_http_upstream_module.xml xml/ru/docs/http/ngx_http_upstream_module.xml
diffstat 2 files changed, 60 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_upstream_module.xml	Thu Mar 20 15:41:50 2014 +0400
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml	Thu Mar 20 15:42:32 2014 +0400
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="15">
+        rev="16">
 
 <section id="summary">
 
@@ -215,6 +215,36 @@
 the <link id="ip_hash"/> directive.
 </tag-desc>
 
+<tag-name id="resolve">
+<literal>resolve</literal>
+</tag-name>
+<tag-desc>
+monitors changes of the IP addresses
+that correspond to a domain name of the server,
+and automatically modifies the upstream configuration
+without the need of restarting nginx (1.5.12)
+<para>
+In order for this parameter to work,
+the <link doc="ngx_http_core_module.xml" id="resolver"/> directive
+must be specified in the
+<link doc="ngx_http_core_module.xml" id="http"/> block.
+<example>
+http {
+    resolver 10.0.0.1;
+
+    upstream u {
+        zone ...;
+        ...
+        server example.com resolve;
+    }
+}
+</example>
+</para>
+<note>
+This functionality is available as part of our <commercial_version/>.
+</note>
+</tag-desc>
+
 <tag-name><literal>route</literal>=<value>string</value></tag-name>
 <tag-desc>
 sets the server route name.
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml	Thu Mar 20 15:41:50 2014 +0400
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml	Thu Mar 20 15:42:32 2014 +0400
@@ -173,6 +173,35 @@
 совместно с директивой <link id="ip_hash"/>.
 </tag-desc>
 
+<tag-name id="resolve">
+<literal>resolve</literal>
+</tag-name>
+<tag-desc>
+отслеживает изменения IP-адресов, соответствующих доменному имени сервера,
+и автоматически изменяет конфигурацию группы
+без необходимости перезапуска nginx (1.5.12)
+<para>
+Для работы этого параметра
+директива <link doc="ngx_http_core_module.xml" id="resolver"/>
+должна быть задана в блоке
+<link doc="ngx_http_core_module.xml" id="http"/>.
+<example>
+http {
+    resolver 10.0.0.1;
+
+    upstream u {
+        zone ...;
+        ...
+        server example.com resolve;
+    }
+}
+</example>
+</para>
+<note>
+Эта функциональность доступна как часть <commercial_version/>.
+</note>
+</tag-desc>
+
 </list>
 </para>