diff xml/ru/docs/stream/ngx_stream_upstream_module.xml @ 3043:9eadb98ec770

Free nginx: removed commercial version documentation.
author Maxim Dounin <mdounin@mdounin.ru>
date Wed, 14 Feb 2024 20:05:49 +0300
parents 3a2d342533fb
children
line wrap: on
line diff
--- a/xml/ru/docs/stream/ngx_stream_upstream_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_upstream_module.xml
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_upstream_module"
         link="/ru/docs/stream/ngx_stream_upstream_module.html"
         lang="ru"
-        rev="39">
+        rev="40">
 
 <section id="summary">
 
@@ -45,36 +45,6 @@ server {
 </example>
 </para>
 
-<para>
-Динамически настраиваемая группа
-с периодическими
-<link doc="ngx_stream_upstream_hc_module.xml">проверками работоспособности</link>
-доступна как часть
-<commercial_version>коммерческой подписки</commercial_version>:
-<example>
-resolver 10.0.0.1;
-
-upstream <emphasis>dynamic</emphasis> {
-    zone upstream_dynamic 64k;
-
-    server backend1.example.com:12345 weight=5;
-    server backend2.example.com:12345 fail_timeout=5s slow_start=30s;
-    server 192.0.2.1:12345            max_fails=3;
-    server backend3.example.com:12345 resolve;
-    server backend4.example.com       service=http resolve;
-
-    server backup1.example.com:12345  backup;
-    server backup2.example.com:12345  backup;
-}
-
-server {
-    listen 12346;
-    proxy_pass <emphasis>dynamic</emphasis>;
-    health_check;
-}
-</example>
-</para>
-
 </section>
 
 
@@ -156,10 +126,6 @@ 5 соединений на <literal>backend1.example.com:12345</literal>
 Значение по умолчанию равно 0 и означает, что ограничения нет.
 Если группа не находится в <link id="zone">зоне разделяемой памяти</link>,
 то ограничение работает отдельно для каждого рабочего процесса.
-<note>
-До версии 1.11.5 этот параметр был доступен как часть
-<commercial_version>коммерческой подписки</commercial_version>.
-</note>
 </tag-desc>
 
 <tag-name id="max_fails">
@@ -220,96 +186,9 @@ 5 соединений на <literal>backend1.example.com:12345</literal>
 </para>
 
 <para>
-Кроме того,
-следующие параметры доступны как часть
-<commercial_version>коммерческой подписки</commercial_version>:
-<list type="tag">
-
-<tag-name id="resolve">
-<literal>resolve</literal>
-</tag-name>
-<tag-desc>
-отслеживает изменения IP-адресов, соответствующих доменному имени сервера,
-и автоматически изменяет конфигурацию группы
-без необходимости перезапуска nginx.
-Группа должна находиться в <link id="zone">зоне разделяемой памяти</link>.
-<para>
-Для работы этого параметра
-директива <literal>resolver</literal>
-должна быть задана в блоке
-<link doc="ngx_stream_core_module.xml" id="resolver">stream</link>
-или в соответствующем блоке <link id="resolver">upstream</link>.
-</para>
-</tag-desc>
-
-<tag-name id="service">
-<literal>service</literal>=<value>имя</value>
-</tag-name>
-<tag-desc>
-включает преобразование
-<link url="https://datatracker.ietf.org/doc/html/rfc2782">SRV</link>-записей
-DNS и задаёт <value>имя</value> сервиса (1.9.13).
-Для работы параметра необходимо указать
-параметр <link id="resolve"/> для сервера
-и не указывать порт сервера.
-<para>
-Если имя сервиса не содержит точку (“<literal>.</literal>”), то
-имя составляется в соответствии с
-<link url="https://datatracker.ietf.org/doc/html/rfc2782">RFC</link>
-и в префикс службы добавляется протокол TCP.
-Например, для получения
-SRV-записи <literal>_http._tcp.backend.example.com</literal>
-необходимо указать директиву:
-<example>
-server backend.example.com service=http resolve;
-</example>
-Если имя сервиса содержит одну и более точек, то имя составляется
-при помощи соединения префикса службы и имени сервера.
-Например, для получения SRV-записей
-<literal>_http._tcp.backend.example.com</literal>
-и <literal>server1.backend.example.com</literal>
-необходимо указать директивы:
-<example>
-server backend.example.com service=_http._tcp resolve;
-server example.com service=server1.backend resolve;
-</example>
-</para>
-
-<para>
-SRV-записи с наивысшим приоритетом
-(записи с одинаковым наименьшим значением приоритета)
-преобразуются в основные серверы,
-остальные SRV-записи преобразуются в запасные серверы.
-Если в конфигурации сервера указан параметр <link id="backup"/>,
-высокоприоритетные SRV-записи преобразуются в запасные серверы,
-остальные SRV-записи игнорируются.
-</para>
-</tag-desc>
-
-<tag-name id="slow_start">
-<literal>slow_start</literal>=<value>время</value>
-</tag-name>
-<tag-desc>
-задаёт <value>время</value>, в течение которого вес сервера
-восстановится от нуля до своего номинального значения в ситуации, когда
-неработоспособный (unhealthy) сервер вновь становится работоспособным
-(<link doc="ngx_stream_upstream_hc_module.xml" id="health_check">healthy</link>)
-или когда сервер становится доступным по прошествии времени,
-в течение которого он считался <link id="fail_timeout">недоступным</link>.
-Значение по умолчанию равно нулю и означает, что медленный старт выключен.
 <note>
-Параметр нельзя использовать совместно с
-методами балансировки нагрузки <link id="hash"/> и <link id="random"/>.
-</note>
-</tag-desc>
-
-</list>
-</para>
-
-<para>
-<note>
-Если в группе только один сервер, параметры <literal>max_fails</literal>,
-<literal>fail_timeout</literal> и <literal>slow_start</literal>
+Если в группе только один сервер,
+параметры <literal>max_fails</literal> и <literal>fail_timeout</literal>
 игнорируются и такой сервер никогда не будет считаться недоступным.
 </note>
 </para>
@@ -330,70 +209,6 @@ SRV-записи с наивысшим приоритетом
 В этом случае достаточно указать <value>размер</value> только один раз.
 </para>
 
-<para>
-Дополнительно, как часть
-<commercial_version>коммерческой подписки</commercial_version>,
-в таких группах для изменения состава группы
-или настроек отдельных серверов
-нет необходимости перезапускать nginx.
-Конфигурация доступна через
-модуль <link doc="../http/ngx_http_api_module.xml">API</link> (1.13.3).
-<note>
-До версии 1.13.3
-конфигурация была доступна только через специальный location,
-в котором указана директива
-<link doc="../http/ngx_http_upstream_conf_module.xml" id="upstream_conf"/>.
-</note>
-</para>
-
-</directive>
-
-
-<directive name="state">
-<syntax><value>файл</value></syntax>
-<default/>
-<context>upstream</context>
-<appeared-in>1.9.7</appeared-in>
-
-<para>
-Задаёт <value>файл</value>, в котором хранится состояние
-динамически настраиваемой группы.
-</para>
-
-<para>
-Примеры:
-<example>
-state /var/lib/nginx/state/servers.conf; # путь для Linux
-state /var/db/nginx/state/servers.conf;  # путь для FreeBSD
-</example>
-</para>
-
-<para>
-В данный момент состояние ограничено списком серверов с их параметрами.
-Файл читается при парсинге конфигурации и обновляется каждый раз при
-<link doc="../http/ngx_http_api_module.xml" id="stream_upstreams_stream_upstream_name_servers_">изменении</link>
-конфигурации группы.
-Изменение содержимого файла напрямую не рекомендуется.
-Директиву нельзя использовать
-совместно с директивой <link id="server"/>.
-</para>
-
-<para>
-<note>
-Изменения, совершённые в момент
-<link doc="../control.xml" id="reconfiguration">перезагрузки конфигурации</link>
-или <link doc="../control.xml" id="upgrade">обновления бинарного файла</link>,
-могут быть потеряны.
-</note>
-</para>
-
-<para>
-<note>
-Эта директива доступна как часть
-<commercial_version>коммерческой подписки</commercial_version>.
-</note>
-</para>
-
 </directive>
 
 
@@ -450,51 +265,6 @@ hash $remote_addr;
 </directive>
 
 
-<directive name="least_time">
-<syntax>
-    <literal>connect</literal> |
-    <literal>first_byte</literal> |
-    <literal>last_byte</literal>
-    [<literal>inflight</literal>]</syntax>
-<default/>
-<context>upstream</context>
-
-<para>
-Задаёт для группы метод балансировки нагрузки, при котором соединение
-передаётся серверу с наименьшими средним временем ответа и
-числом активных соединений с учётом весов серверов.
-Если подходит сразу несколько серверов, то они выбираются циклически
-(в режиме round-robin) с учётом их весов.
-</para>
-
-<para>
-Если указан параметр <literal>connect</literal>,
-то учитывается время
-<link id="var_upstream_connect_time">соединения</link> с сервером группы.
-Если указан параметр <literal>first_byte</literal>,
-то учитывается время получения
-<link id="var_upstream_first_byte_time">первого байта</link> данных.
-Если указан параметр <literal>last_byte</literal>,
-то учитывается время получения
-<link id="var_upstream_session_time">последнего байта</link> данных.
-Если указан параметр <literal>inflight</literal> (1.11.6),
-то также учитываются незавершённые соединения.
-<note>
-До версии 1.11.6
-незавершённые соединения учитывались по умолчанию.
-</note>
-</para>
-
-<para>
-<note>
-Эта директива доступна как часть
-<commercial_version>коммерческой подписки</commercial_version>.
-</note>
-</para>
-
-</directive>
-
-
 <directive name="random">
 <syntax>[<literal>two</literal> [<value>метод</value>]]</syntax>
 <default/>
@@ -518,110 +288,6 @@ hash $remote_addr;
 с наименьшим количеством активных соединений.
 </para>
 
-<para id="random_least_time">
-Если указан метод <literal>least_time</literal>, то соединение передаётся
-серверу
-с наименьшими средним временем ответа и числом активных соединений.
-Если указан <literal>least_time=connect</literal>,
-то учитывается время
-<link id="var_upstream_connect_time">соединения</link> с сервером группы.
-Если указан <literal>least_time=first_byte</literal>,
-то учитывается время получения
-<link id="var_upstream_first_byte_time">первого байта</link> данных.
-Если указан <literal>least_time=last_byte</literal>,
-то учитывается время получения
-<link id="var_upstream_session_time">последнего байта</link> данных.
-<note>
-Метод <literal>least_time</literal> доступен как часть
-<commercial_version>коммерческой подписки</commercial_version>.
-</note>
-</para>
-
-</directive>
-
-
-<directive name="resolver">
-<syntax>
-    <value>адрес</value> ...
-    [<literal>valid</literal>=<value>время</value>]
-    [<literal>ipv4</literal>=<literal>on</literal>|<literal>off</literal>]
-    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]
-    [<literal>status_zone</literal>=<value>зона</value>]</syntax>
-<default/>
-<context>upstream</context>
-<appeared-in>1.17.5</appeared-in>
-
-<para>
-Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов
-в адреса, например:
-<example>
-resolver 127.0.0.1 [::1]:5353;
-</example>
-Адрес может быть указан в виде доменного имени или IP-адреса,
-и необязательного порта.
-Если порт не указан, используется порт 53.
-Серверы DNS опрашиваются циклически.
-</para>
-
-<para id="resolver_ipv6">
-По умолчанию nginx будет искать как IPv4-, так и IPv6-адреса
-при преобразовании имён в адреса.
-Если поиск IPv4- или IPv6-адресов нежелателен,
-можно указать параметр <literal>ipv4=off</literal> (1.23.1) или
-<literal>ipv6=off</literal>.
-</para>
-
-<para id="resolver_valid">
-По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
-Необязательный параметр <literal>valid</literal> позволяет это
-переопределить:
-<example>
-resolver 127.0.0.1 [::1]:5353 valid=30s;
-</example>
-<note>
-Для предотвращения DNS-спуфинга рекомендуется
-использовать DNS-серверы в защищённой доверенной локальной сети.
-</note>
-</para>
-
-<para id="resolver_status_zone">
-Необязательный параметр <literal>status_zone</literal>
-включает
-<link doc="../http/ngx_http_api_module.xml" id="resolvers_">сбор информации</link>
-о запросах и ответах сервера DNS
-в указанной <value>зоне</value>.
-</para>
-
-<para>
-<note>
-Эта директива доступна как часть
-<commercial_version>коммерческой подписки</commercial_version>.
-</note>
-</para>
-
-</directive>
-
-
-<directive name="resolver_timeout">
-<syntax><value>время</value></syntax>
-<default>30s</default>
-<context>upstream</context>
-<appeared-in>1.17.5</appeared-in>
-
-<para>
-Задаёт таймаут для преобразования имени в адрес, например:
-<example>
-resolver_timeout 5s;
-</example>
-</para>
-
-<para>
-<note>
-Эта директива доступна как часть
-<commercial_version>коммерческой подписки</commercial_version>.
-</note>
-</para>
-
 </directive>
 
 </section>