changeset 2134:4cafd82e5007

Added info about gRPC to various modules.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 05 Apr 2018 15:59:41 +0300
parents bb3d2ce5192e
children 6c7841469ec5
files xml/en/docs/http/load_balancing.xml xml/en/docs/http/ngx_http_charset_module.xml xml/en/docs/http/ngx_http_core_module.xml xml/en/docs/http/ngx_http_ssi_module.xml xml/en/docs/http/ngx_http_upstream_module.xml xml/ru/docs/http/ngx_http_charset_module.xml xml/ru/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_ssi_module.xml xml/ru/docs/http/ngx_http_upstream_module.xml
diffstat 9 files changed, 42 insertions(+), 32 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/load_balancing.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/en/docs/http/load_balancing.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -9,7 +9,7 @@
 <article name="Using nginx as HTTP load balancer"
          link="/en/docs/http/load_balancing.html"
          lang="en"
-         rev="4">
+         rev="5">
 
 <section name="Introduction">
 
@@ -95,7 +95,7 @@
 
 <para>
 Reverse proxy implementation in nginx includes load balancing for HTTP,
-HTTPS, FastCGI, uwsgi, SCGI, and memcached.
+HTTPS, FastCGI, uwsgi, SCGI, memcached, and gRPC.
 </para>
 
 <para>
@@ -104,11 +104,12 @@
 </para>
 
 <para>
-When setting up load balancing for FastCGI, uwsgi, SCGI, or memcached, use
+When setting up load balancing for FastCGI, uwsgi, SCGI, memcached, or gRPC, use
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
-<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>, and
-<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>
+<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
+<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>, and
+<link doc="ngx_http_grpc_module.xml" id="grpc_pass"/>
 directives respectively.
 </para>
 
--- a/xml/en/docs/http/ngx_http_charset_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/en/docs/http/ngx_http_charset_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_charset_module"
         link="/en/docs/http/ngx_http_charset_module.html"
         lang="en"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -102,8 +102,9 @@
 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_ignore_headers"/>,
+<link doc="ngx_http_scgi_module.xml" id="scgi_ignore_headers"/>,
 and
-<link doc="ngx_http_scgi_module.xml" id="scgi_ignore_headers"/>
+<link doc="ngx_http_grpc_module.xml" id="grpc_ignore_headers"/>
 directives.
 </para>
 
@@ -197,7 +198,7 @@
 
 <para>
 Determines whether a conversion should be performed for answers
-received from a proxied or a FastCGI/uwsgi/SCGI server
+received from a proxied or a FastCGI/uwsgi/SCGI/gRPC server
 when the answers already carry a charset in the <header>Content-Type</header>
 response header field.
 If conversion is enabled, a charset specified in the received
--- a/xml/en/docs/http/ngx_http_core_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -660,7 +660,7 @@
 
 <para>
 If an error response is processed by a proxied server
-or a FastCGI/uwsgi/SCGI server,
+or a FastCGI/uwsgi/SCGI/gRPC server,
 and the server may return different response codes (e.g., 200, 302, 401
 or 404), it is possible to respond with the code it returns:
 <example>
@@ -1627,8 +1627,9 @@
 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
-<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>, or
-<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>,
+<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
+<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>, or
+<link doc="ngx_http_grpc_module.xml" id="grpc_pass"/>,
 then the special processing is performed.
 In response to a request with URI equal to this string,
 but without the trailing slash,
--- a/xml/en/docs/http/ngx_http_ssi_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/en/docs/http/ngx_http_ssi_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_ssi_module"
         link="/en/docs/http/ngx_http_ssi_module.html"
         lang="en"
-        rev="10">
+        rev="11">
 
 <section id="summary">
 
@@ -332,7 +332,7 @@
 &lt;!--# include virtual="/remote/body.php?argument=value" --&gt;
 </example>
 Several requests specified on one page and processed by proxied or
-FastCGI/uwsgi/SCGI servers run in parallel.
+FastCGI/uwsgi/SCGI/gRPC servers run in parallel.
 If sequential processing is desired, the <literal>wait</literal>
 parameter should be used.
 </tag-desc>
--- a/xml/en/docs/http/ngx_http_upstream_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="68">
+        rev="69">
 
 <section id="summary">
 
@@ -20,8 +20,9 @@
 by the <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
-<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>, and
-<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/> directives.
+<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
+<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>, and
+<link doc="ngx_http_grpc_module.xml" id="grpc_pass"/> directives.
 </para>
 
 </section>
@@ -188,8 +189,9 @@
 <link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_next_upstream"/>,
-<link doc="ngx_http_scgi_module.xml" id="scgi_next_upstream"/>, and
-<link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/>
+<link doc="ngx_http_scgi_module.xml" id="scgi_next_upstream"/>,
+<link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/>, and
+<link doc="ngx_http_grpc_module.xml" id="grpc_next_upstream"/>
 directives.
 </tag-desc>
 
--- a/xml/ru/docs/http/ngx_http_charset_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/ru/docs/http/ngx_http_charset_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_charset_module"
         link="/ru/docs/http/ngx_http_charset_module.html"
         lang="ru"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
@@ -101,9 +101,10 @@
 Эту возможность можно запретить с помощью директив
 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_ignore_headers"/>,
-<link doc="ngx_http_uwsgi_module.xml" id="uwsgi_ignore_headers"/>
+<link doc="ngx_http_uwsgi_module.xml" id="uwsgi_ignore_headers"/>,
+<link doc="ngx_http_scgi_module.xml" id="scgi_ignore_headers"/>
 и
-<link doc="ngx_http_scgi_module.xml" id="scgi_ignore_headers"/>.
+<link doc="ngx_http_grpc_module.xml" id="grpc_ignore_headers"/>.
 </para>
 
 </directive>
@@ -198,7 +199,7 @@
 
 <para>
 Определяет, выполнять ли перекодирование для ответов,
-полученных от проксированного сервера или от FastCGI/uwsgi/SCGI-сервера,
+полученных от проксированного сервера или от FastCGI/uwsgi/SCGI/gRPC-сервера,
 если в ответах уже указана кодировка в поле <header>Content-Type</header>
 заголовка ответа.
 Если перекодирование разрешено, то в качестве исходной кодировки
--- a/xml/ru/docs/http/ngx_http_core_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -657,7 +657,8 @@
 
 <para>
 Если ошибочный ответ обрабатывается проксированным сервером или
-FastCGI/uwsgi/SCGI-сервером, и этот сервер может вернуть разные коды ответов,
+FastCGI/uwsgi/SCGI/gRPC-сервером,
+и этот сервер может вернуть разные коды ответов,
 например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код:
 <example>
 error_page 404 = /404.php;
@@ -1625,8 +1626,9 @@
 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
-<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/> или
-<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>,
+<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
+<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/> или
+<link doc="ngx_http_grpc_module.xml" id="grpc_pass"/>,
 происходит специальная обработка.
 В ответ на запрос с URI равным этой строке, но без завершающего слэша,
 будет возвращено постоянное перенаправление с кодом 301
--- a/xml/ru/docs/http/ngx_http_ssi_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/ru/docs/http/ngx_http_ssi_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_ssi_module"
         link="/ru/docs/http/ngx_http_ssi_module.html"
         lang="ru"
-        rev="10">
+        rev="11">
 
 <section id="summary">
 
@@ -335,7 +335,7 @@
 &lt;!--# include virtual="/remote/body.php?argument=value" --&gt;
 </example>
 Несколько запросов, указанных на одной странице и обрабатываемых
-проксируемыми или FastCGI/uwsgi/SCGI-серверами, работают параллельно.
+проксируемыми или FastCGI/uwsgi/SCGI/gRPC-серверами, работают параллельно.
 Если нужна последовательная обработка, следует воспользоваться параметром
 <literal>wait</literal>.
 </tag-desc>
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml	Thu Apr 05 15:49:33 2018 +0300
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml	Thu Apr 05 15:59:41 2018 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_upstream_module"
         link="/ru/docs/http/ngx_http_upstream_module.html"
         lang="ru"
-        rev="68">
+        rev="69">
 
 <section id="summary">
 
@@ -21,8 +21,9 @@
 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_pass"/>,
-<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/> и
-<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/>.
+<link doc="ngx_http_scgi_module.xml" id="scgi_pass"/>,
+<link doc="ngx_http_memcached_module.xml" id="memcached_pass"/> и
+<link doc="ngx_http_grpc_module.xml" id="grpc_pass"/>.
 </para>
 
 </section>
@@ -192,8 +193,9 @@
 <link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/>,
 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_next_upstream"/>,
-<link doc="ngx_http_scgi_module.xml" id="scgi_next_upstream"/> и
-<link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/>.
+<link doc="ngx_http_scgi_module.xml" id="scgi_next_upstream"/>,
+<link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/> и
+<link doc="ngx_http_grpc_module.xml" id="grpc_next_upstream"/>.
 </tag-desc>
 
 <tag-name id="fail_timeout">