Mercurial > hg > nginx-site

changeset 135:edf8c90f8085

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Renamed ngx_http_upstream to ngx_http_upstream_module.
author Ruslan Ermilov <ru@nginx.com>
date Sat, 22 Oct 2011 04:48:15 +0000
parents 0991bf45cbb8
children 8437e7f55c4d
files xml/ru/GNUmakefile xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_memcached_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_upstream.xml xml/ru/docs/http/ngx_http_upstream_module.xml xml/ru/docs/index.xml xml/ru/index.xml
diffstat 8 files changed, 250 insertions(+), 250 deletions(-) [+]
line wrap: on
line diff
--- a/xml/ru/GNUmakefile	Fri Oct 21 21:16:08 2011 +0000
+++ b/xml/ru/GNUmakefile	Sat Oct 22 04:48:15 2011 +0000
@@ -45,7 +45,7 @@
 		ru/docs/http/ngx_http_ssi_module			\
 		ru/docs/http/ngx_http_ssl_module			\
 		ru/docs/http/ngx_http_sub_module			\
-		ru/docs/http/ngx_http_upstream				\
+		ru/docs/http/ngx_http_upstream_module			\
 		ru/docs/http/ngx_http_userid_module			\
 		ru/docs/http/ngx_http_xslt_module			\
 
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Fri Oct 21 21:16:08 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Sat Oct 22 04:48:15 2011 +0000
@@ -472,7 +472,7 @@
 Если доменное имя резолвится в несколько адресов, то все они будут
 использоваться в режиме round-robin.
 И кроме того, адрес может быть
-<link doc="ngx_http_upstream.xml">группой серверов</link>.
+<link doc="ngx_http_upstream_module.xml">группой серверов</link>.
 </para>
 
 </directive>
--- a/xml/ru/docs/http/ngx_http_memcached_module.xml	Fri Oct 21 21:16:08 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_memcached_module.xml	Sat Oct 22 04:48:15 2011 +0000
@@ -130,7 +130,7 @@
 Если доменное имя резолвится в несколько адресов, то все они будут
 использоваться в режиме round-robin.
 И кроме того, адрес может быть
-<link doc="ngx_http_upstream.xml">группой серверов</link>.
+<link doc="ngx_http_upstream_module.xml">группой серверов</link>.
 </para>
 
 </directive>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Fri Oct 21 21:16:08 2011 +0000
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Sat Oct 22 04:48:15 2011 +0000
@@ -432,7 +432,7 @@
 Если доменное имя резолвится в несколько адресов, то все они будут
 использоваться в режиме round-robin.
 И кроме того, адрес можно задать
-<link doc="ngx_http_upstream.xml">группой серверов</link>.
+<link doc="ngx_http_upstream_module.xml">группой серверов</link>.
 </para>
 
 <para>
@@ -506,7 +506,7 @@
 
 <para>
 В этом случае имя сервера ищется среди описанных
-<link doc="ngx_http_upstream.xml">групп серверов</link>
+<link doc="ngx_http_upstream_module.xml">групп серверов</link>
 и если не найдено, то определяется с помощью
 <link doc="ngx_http_core_module.xml" id="resolver">resolver'а</link>.
 </para>
--- a/xml/ru/docs/http/ngx_http_upstream.xml	Fri Oct 21 21:16:08 2011 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,241 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
-
-<module name="Директивы модуля ngx_http_upstream"
-        link="/ru/docs/http/ngx_http_upstream.html"
-        lang="ru">
-
-<section id="summary">
-
-<para>
-Модуль позволяет описывать группы серверов,
-которые могут использоваться в директивах
-<link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>
-и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>.
-</para>
-
-</section>
-
-
-<section name="Пример конфигурации" id="example">
-
-<para>
-<example>
-upstream  <emphasis>backend</emphasis>  {
-    server   backend1.example.com        weight=5;
-    server   backend2.example.com:8080;
-    server   unix:/tmp/backend3;
-
-    server   backup1.example.com:8080    backup;
-    server   backup2.example.com:8080    backup;
-}
-
-server {
-    location / {
-        proxy_pass  http://<emphasis>backend</emphasis>;
-    }
-}
-</example>
-</para>
-
-</section>
-
-
-<section name="Директивы" id="directives">
-
-<directive name="ip_hash">
-<syntax/>
-<default/>
-<context>upstream</context>
-
-<para>
-Директива задаёт метод распределения запросов по серверам на основе
-IP-адресов клиентов. В качестве ключа для хеширования используется сеть
-класса C, в которой находится адрес клиента.
-Метод гарантирует, что запросы клиента будут передаваться на один и тот же
-сервер.  Если же этот сервер будет считаться неработающим, то запросы этого
-клиента будут передаваться на другой сервер. С большой долей вероятности
-это также будет один и тот же сервер.
-</para>
-
-<para>
-Для серверов, использующих метод распределения ip_hash, нельзя задать вес.
-Если один из серверов нужно убрать на некоторое время, то для сохранения
-текущего хеширования IP-адресов клиентов этот сервер нужно пометить
-параметром down.
-</para>
-
-<para>
-Пример конфигурации:
-<example>
-upstream  backend  {
-    ip_hash;
-
-    server   backend1.example.com;
-    server   backend2.example.com;
-    server   backend3.example.com  down;
-    server   backend4.example.com;
-}
-</example>
-</para>
-
-</directive>
-
-
-<directive name="server">
-<syntax><value>название [параметры]</value></syntax>
-<default/>
-<context>upstream</context>
-
-<para>
-Директива задаёт имя и параметры сервера.
-В качестве имени можно использовать доменное имя, адрес, порт или путь
-unix-сокета. Если доменное имя резолвится в несколько адресов, то
-используются все.
-<list type="bullet">
-
-<listitem>
-weight=число — задаёт вес сервера, по умолчанию вес равен одному.
-</listitem>
-
-<listitem>
-max_fails=число — задаёт число неудачных попыток работы с сервером
-в течение времени, заданного параметром fail_timeout,
-после которых он считается неработающим также в течение времени
-заданного параметром fail_timeout.
-По умолчанию число попыток равно одной.
-Нулевое значение запрещает учёт попыток.
-Что считается неудачной попыткой, задаётся директивами
-<link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>
-и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/>.
-Состояние http_404 не считается неудачной попыткой.
-</listitem>
-
-<listitem>
-fail_timeout=время — задаёт
-<list type="bullet">
-
-<listitem>
-время, в течение которого должно произойти заданное число неудачных
-попыток работы с сервером для того, чтобы сервер считался неработающим;
-</listitem>
-
-<listitem>
-и время, в течение которого сервер будет считаться неработающим.
-</listitem>
-
-</list>
-По умолчанию время равно 10 секундам.
-</listitem>
-
-<listitem>
-backup — помечает сервер как запасной сервер. На него будут
-передаваться запросы в случае, если не работают основные сервера.
-</listitem>
-
-<listitem>
-down — помечает сервер как постоянно неработающий, используется
-совместно с директивой <link id="ip_hash"/>.
-</listitem>
-
-</list>
-</para>
-
-<para>
-Пример конфигурации:
-<example>
-upstream  backend  {
-    server   backend1.example.com       weight=5;
-    server   127.0.0.1:8080             max_fails=3  fail_timeout=30s;
-    server   unix:/tmp/backend3;
-
-    server   backup1.example.com:8080   backup;
-}
-</example>
-</para>
-
-</directive>
-
-
-<directive name="upstream">
-<syntax block="yes"><value>название</value></syntax>
-<default/>
-<context>http</context>
-
-<para>
-Директива описывает группу серверов.
-Сервера могут слушать на разных портах, кроме того, можно одновременно
-использовать сервера, слушающие на TCP и unix сокетах.
-</para>
-
-<para>
-Пример конфигурации:
-<example>
-upstream  backend  {
-    server   backend1.example.com    weight=5;
-    server   127.0.0.1:8080          max_fails=3  fail_timeout=30s;
-    server   unix:/tmp/backend3;
-}
-</example>
-</para>
-
-<para>
-Запросы распределяются по серверам в режиме round-robin с учётом весов серверов.
-В вышеприведённом примере каждые 7 семь запросов будут распределены так:
-5 запросов на backend1.example.com и по одному запросу на второй и третий
-сервера.
-Если при попытке работы с сервером произошла ошибка, то запрос будет
-передан следующему серверу и так до тех пор, пока не будут опробованы
-все работающие сервера. Если не удастся получить успешный ответ
-от всех серверов, то клиенту будет возвращён результат работы
-с последним сервером.
-</para>
-
-</directive>
-
-</section>
-
-
-<section name="Встроенные переменные" id="variables">
-
-<para>
-Модуль ngx_http_upstream поддерживает следующие встроенные переменные:
-<list type="bullet">
-
-<listitem>
-$upstream_addr — в переменной хранятся ip-адрес и порт сервера
-или путь к unix-сокету.
-Если при обработке запроса были сделаны обращения к нескольким серверам,
-то их адреса разделяются запятой, например,
-"192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock".
-Если произошёл внутренний редирект от одной группы серверов на другую с помощью
-"X-Accel-Redirect" или error_page, то эти группы серверов разделяются
-двоеточием, например,
-"192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80".
-</listitem>
-
-<listitem>
-$upstream_response_time — в переменной хранятся времена ответов серверов
-в секундах с точностью до миллисекунд.
-Несколько ответов также разделяются запятыми и двоеточиями.
-</listitem>
-
-<listitem>
-$upstream_status — в переменной хранятся коды ответов серверов.
-Несколько ответов также разделяются запятыми и двоеточиями.
-</listitem>
-
-<listitem>
-$upstream_http_... — в переменных хранятся строки заголовков ответов
-серверов, например, строка заголовка ответа "Server" доступна в переменной
-$upstream_http_server. Необходимо иметь ввиду, что запоминаются только
-строки последнего сервера.
-</listitem>
-
-</list>
-</para>
-
-</section>
-
-</module>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml	Sat Oct 22 04:48:15 2011 +0000
@@ -0,0 +1,241 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
+
+<module name="Директивы модуля ngx_http_upstream_module"
+        link="/ru/docs/http/ngx_http_upstream_module.html"
+        lang="ru">
+
+<section id="summary">
+
+<para>
+Модуль позволяет описывать группы серверов,
+которые могут использоваться в директивах
+<link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>
+и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>.
+</para>
+
+</section>
+
+
+<section name="Пример конфигурации" id="example">
+
+<para>
+<example>
+upstream  <emphasis>backend</emphasis>  {
+    server   backend1.example.com        weight=5;
+    server   backend2.example.com:8080;
+    server   unix:/tmp/backend3;
+
+    server   backup1.example.com:8080    backup;
+    server   backup2.example.com:8080    backup;
+}
+
+server {
+    location / {
+        proxy_pass  http://<emphasis>backend</emphasis>;
+    }
+}
+</example>
+</para>
+
+</section>
+
+
+<section name="Директивы" id="directives">
+
+<directive name="ip_hash">
+<syntax/>
+<default/>
+<context>upstream</context>
+
+<para>
+Директива задаёт метод распределения запросов по серверам на основе
+IP-адресов клиентов. В качестве ключа для хеширования используется сеть
+класса C, в которой находится адрес клиента.
+Метод гарантирует, что запросы клиента будут передаваться на один и тот же
+сервер.  Если же этот сервер будет считаться неработающим, то запросы этого
+клиента будут передаваться на другой сервер. С большой долей вероятности
+это также будет один и тот же сервер.
+</para>
+
+<para>
+Для серверов, использующих метод распределения ip_hash, нельзя задать вес.
+Если один из серверов нужно убрать на некоторое время, то для сохранения
+текущего хеширования IP-адресов клиентов этот сервер нужно пометить
+параметром down.
+</para>
+
+<para>
+Пример конфигурации:
+<example>
+upstream  backend  {
+    ip_hash;
+
+    server   backend1.example.com;
+    server   backend2.example.com;
+    server   backend3.example.com  down;
+    server   backend4.example.com;
+}
+</example>
+</para>
+
+</directive>
+
+
+<directive name="server">
+<syntax><value>название [параметры]</value></syntax>
+<default/>
+<context>upstream</context>
+
+<para>
+Директива задаёт имя и параметры сервера.
+В качестве имени можно использовать доменное имя, адрес, порт или путь
+unix-сокета. Если доменное имя резолвится в несколько адресов, то
+используются все.
+<list type="bullet">
+
+<listitem>
+weight=число — задаёт вес сервера, по умолчанию вес равен одному.
+</listitem>
+
+<listitem>
+max_fails=число — задаёт число неудачных попыток работы с сервером
+в течение времени, заданного параметром fail_timeout,
+после которых он считается неработающим также в течение времени
+заданного параметром fail_timeout.
+По умолчанию число попыток равно одной.
+Нулевое значение запрещает учёт попыток.
+Что считается неудачной попыткой, задаётся директивами
+<link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>
+и <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/>.
+Состояние http_404 не считается неудачной попыткой.
+</listitem>
+
+<listitem>
+fail_timeout=время — задаёт
+<list type="bullet">
+
+<listitem>
+время, в течение которого должно произойти заданное число неудачных
+попыток работы с сервером для того, чтобы сервер считался неработающим;
+</listitem>
+
+<listitem>
+и время, в течение которого сервер будет считаться неработающим.
+</listitem>
+
+</list>
+По умолчанию время равно 10 секундам.
+</listitem>
+
+<listitem>
+backup — помечает сервер как запасной сервер. На него будут
+передаваться запросы в случае, если не работают основные сервера.
+</listitem>
+
+<listitem>
+down — помечает сервер как постоянно неработающий, используется
+совместно с директивой <link id="ip_hash"/>.
+</listitem>
+
+</list>
+</para>
+
+<para>
+Пример конфигурации:
+<example>
+upstream  backend  {
+    server   backend1.example.com       weight=5;
+    server   127.0.0.1:8080             max_fails=3  fail_timeout=30s;
+    server   unix:/tmp/backend3;
+
+    server   backup1.example.com:8080   backup;
+}
+</example>
+</para>
+
+</directive>
+
+
+<directive name="upstream">
+<syntax block="yes"><value>название</value></syntax>
+<default/>
+<context>http</context>
+
+<para>
+Директива описывает группу серверов.
+Сервера могут слушать на разных портах, кроме того, можно одновременно
+использовать сервера, слушающие на TCP и unix сокетах.
+</para>
+
+<para>
+Пример конфигурации:
+<example>
+upstream  backend  {
+    server   backend1.example.com    weight=5;
+    server   127.0.0.1:8080          max_fails=3  fail_timeout=30s;
+    server   unix:/tmp/backend3;
+}
+</example>
+</para>
+
+<para>
+Запросы распределяются по серверам в режиме round-robin с учётом весов серверов.
+В вышеприведённом примере каждые 7 семь запросов будут распределены так:
+5 запросов на backend1.example.com и по одному запросу на второй и третий
+сервера.
+Если при попытке работы с сервером произошла ошибка, то запрос будет
+передан следующему серверу и так до тех пор, пока не будут опробованы
+все работающие сервера. Если не удастся получить успешный ответ
+от всех серверов, то клиенту будет возвращён результат работы
+с последним сервером.
+</para>
+
+</directive>
+
+</section>
+
+
+<section name="Встроенные переменные" id="variables">
+
+<para>
+Модуль ngx_http_upstream_module поддерживает следующие встроенные переменные:
+<list type="bullet">
+
+<listitem>
+$upstream_addr — в переменной хранятся ip-адрес и порт сервера
+или путь к unix-сокету.
+Если при обработке запроса были сделаны обращения к нескольким серверам,
+то их адреса разделяются запятой, например,
+"192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock".
+Если произошёл внутренний редирект от одной группы серверов на другую с помощью
+"X-Accel-Redirect" или error_page, то эти группы серверов разделяются
+двоеточием, например,
+"192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80".
+</listitem>
+
+<listitem>
+$upstream_response_time — в переменной хранятся времена ответов серверов
+в секундах с точностью до миллисекунд.
+Несколько ответов также разделяются запятыми и двоеточиями.
+</listitem>
+
+<listitem>
+$upstream_status — в переменной хранятся коды ответов серверов.
+Несколько ответов также разделяются запятыми и двоеточиями.
+</listitem>
+
+<listitem>
+$upstream_http_... — в переменных хранятся строки заголовков ответов
+серверов, например, строка заголовка ответа "Server" доступна в переменной
+$upstream_http_server. Необходимо иметь ввиду, что запоминаются только
+строки последнего сервера.
+</listitem>
+
+</list>
+</para>
+
+</section>
+
+</module>
--- a/xml/ru/docs/index.xml	Fri Oct 21 21:16:08 2011 +0000
+++ b/xml/ru/docs/index.xml	Sat Oct 22 04:48:15 2011 +0000
@@ -93,8 +93,8 @@
 </item>
 
 <item>
-<a href="/ru/docs/http/ngx_http_upstream.xml">
-ngx_http_upstream</a>
+<a href="/ru/docs/http/ngx_http_upstream_module.xml">
+ngx_http_upstream_module</a>
 </item>
 
 <item>
--- a/xml/ru/index.xml	Fri Oct 21 21:16:08 2011 +0000
+++ b/xml/ru/index.xml	Sat Oct 22 04:48:15 2011 +0000
@@ -52,7 +52,7 @@
 <item>
 <link doc="docs/http/ngx_http_proxy_module.xml">Акселерированное
 проксирование с кэшированием</link>,
-<link doc="docs/http/ngx_http_upstream.xml">простое
+<link doc="docs/http/ngx_http_upstream_module.xml">простое
 распределение нагрузки и отказоустойчивость</link>;
 </item>
 
@@ -62,7 +62,7 @@
 uwsgi, SCGI и
 <link doc="docs/http/ngx_http_memcached_module.xml">memcached</link>
 серверов с кэшированием,
-<link doc="docs/http/ngx_http_upstream.xml">простое
+<link doc="docs/http/ngx_http_upstream_module.xml">простое
 распределение нагрузки и отказоустойчивость</link>;
 </item>