Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_split_clients_module.xml @ 2769:16f6fa718be2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 30 Sep 2021 16:29:20 +0300
parents 813b8349cdbe
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 466
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 466
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 466
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 466
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 466
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
10 <module name="Модуль ngx_http_split_clients_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_split_clients_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
775
813b8349cdbe Expanded the literal empty strings into words.
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
13 rev="2">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 108
diff changeset
15 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
18 Модуль <literal>ngx_http_split_clients_module</literal> создаёт переменные для
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
19 A/B тестирования (также известного как “split-тестирование”).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
20 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
23
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
24
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
25 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
26
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
29 http {
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
30 split_clients "${remote_addr}AAA" $variant {
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
31 0.5% .one;
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
32 2.0% .two;
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
33 * "";
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 server {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37 location / {
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
38 index index${variant}.html;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40 </para>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 342
diff changeset
41
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
45 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
46
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
47 <directive name="split_clients">
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
48 <syntax block="yes">
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
49 <value>строка</value>
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
50 <value>$переменная</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
51 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
54 <para>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
55 Создаёт переменную для A/B тестирования, например:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
56 <example>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
57 split_clients "${remote_addr}AAA" $variant {
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
58 0.5% .one;
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
59 2.0% .two;
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
60 * "";
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
61 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
62 </example>
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
63 Значение исходной строки хэшируется с помощью MurmurHash2.
466
74736c333906 Corrected boundaries of the example ranges.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
64 В приведённом примере при значениях хэша от 0 до 21474835 (0.5%)
342
a076f7661569 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
65 переменная <var>$variant</var> получит значение <literal>".one"</literal>.
466
74736c333906 Corrected boundaries of the example ranges.
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
66 При значениях хэша от 21474836 до 107374180 (2%) — <literal>".two"</literal>.
775
813b8349cdbe Expanded the literal empty strings into words.
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
67 И при значениях хэша от 107374181 до 4294967295 — <literal>""</literal>
813b8349cdbe Expanded the literal empty strings into words.
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
68 (пустая строка).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
69 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
70
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
71 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
72
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
73 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
74
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
75 </module>