Mercurial > hg > nginx-site
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 +++ b/xml/en/docs/http/load_balancing.xml @@ -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 @@ balancing to distribute the requests. <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 @@ as the protocol. </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 +++ b/xml/en/docs/http/ngx_http_charset_module.xml @@ -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 @@ This capability can be disabled using th <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 @@ as the default MIME type instead of “<literal>application/javascript</literal>”. <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 +++ b/xml/en/docs/http/ngx_http_core_module.xml @@ -660,7 +660,7 @@ error_page 404 =200 /empty.gif; <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 @@ and requests are processed by one of <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 +++ b/xml/en/docs/http/ngx_http_ssi_module.xml @@ -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 @@ specifies an included request, for examp <!--# include virtual="/remote/body.php?argument=value" --> </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 +++ b/xml/en/docs/http/ngx_http_upstream_module.xml @@ -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 @@ is used to define groups of servers that 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 @@ What is considered an unsuccessful attem <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 +++ b/xml/ru/docs/http/ngx_http_charset_module.xml @@ -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 @@ charset_map iso-8859-5 _ { } Эту возможность можно запретить с помощью директив <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 @@ application/javascript application/rss+x <para> Определяет, выполнять ли перекодирование для ответов, -полученных от проксированного сервера или от FastCGI/uwsgi/SCGI-сервера, +полученных от проксированного сервера или от FastCGI/uwsgi/SCGI/gRPC-сервера, если в ответах уже указана кодировка в поле <header>Content-Type</header> заголовка ответа. Если перекодирование разрешено, то в качестве исходной кодировки
--- a/xml/ru/docs/http/ngx_http_core_module.xml +++ b/xml/ru/docs/http/ngx_http_core_module.xml @@ -657,7 +657,8 @@ error_page 404 =200 /empty.gif; <para> Если ошибочный ответ обрабатывается проксированным сервером или -FastCGI/uwsgi/SCGI-сервером, и этот сервер может вернуть разные коды ответов, +FastCGI/uwsgi/SCGI/gRPC-сервером, +и этот сервер может вернуть разные коды ответов, например, 200, 302, 401 или 404, то можно выдавать возвращаемый им код: <example> error_page 404 = /404.php; @@ -1625,8 +1626,9 @@ location ~* \.(gif|jpg|jpeg)$ { <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 +++ b/xml/ru/docs/http/ngx_http_ssi_module.xml @@ -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 @@ location / { <!--# include virtual="/remote/body.php?argument=value" --> </example> Несколько запросов, указанных на одной странице и обрабатываемых -проксируемыми или FastCGI/uwsgi/SCGI-серверами, работают параллельно. +проксируемыми или FastCGI/uwsgi/SCGI/gRPC-серверами, работают параллельно. Если нужна последовательная обработка, следует воспользоваться параметром <literal>wait</literal>. </tag-desc>
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml +++ b/xml/ru/docs/http/ngx_http_upstream_module.xml @@ -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 @@ 5 запросов на <literal>backend1.example.com</literal> <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">