Upstream Sticky#
Привязывает клиентские сессии к серверам групп HTTP-модуля
Upstream,
чтобы запросы одной сессии передавались на один и тот же сервер.
Директивы модуля задаются в блоке upstream. По умолчанию — upstream Настраивает привязку клиентских сессий к проксируемым серверам
в режиме, заданном первым параметром;
для разгрузки серверов,
у которых задана директива Предупреждение Директива Этот режим использует cookie для хранения сессий.
Он подходит для ситуаций,
когда cookie уже используются для управления сессиями. Здесь запрос от клиента,
пока не привязанного к какому-то серверу,
отправляется на сервер,
выбираемый согласно настроенному методу балансировки.
При этом Angie устанавливает cookie
с уникальным значением, идентифицирующим сервер. Имя cookie ( Последующие запросы от клиента, содержащие такой cookie,
передаются на сервер, заданный значением cookie,
то есть сервер с указанным sid.
Если выбрать сервер не удается
или выбранный сервер не может обработать запрос,
то будет выбран другой сервер
согласно настроенному методу балансировки. Директива позволяет назначать атрибуты такого cookie;
единственный атрибут, устанавливаемый по умолчанию, — Здесь Angie создает cookie Этот режим использует предопределенные идентификаторы маршрутов,
которые могут быть встроены в URL, cookie или другие свойства запроса.
Он менее гибок, так как зависит от предопределенных значений,
но лучше подходит, если такие идентификаторы уже используются. Здесь проксируемый сервер при получении запроса
может назначить клиенту маршрут и вернуть его идентификатор способом,
известным им обоим.
В качестве идентификатора маршрута
должно использоваться значение параметра sid
директивы server.
Учтите, что параметр дополнительно хэшируется,
если задана директива sticky_secret. Последующие запросы от клиентов, желающих использовать этот маршрут,
должны содержать выданный сервером идентификатор, причем так,
чтобы он попал в переменные Angie, например
в cookie или аргументы запроса. В параметрах директивы указываются строки, которые могут содержать
переменные, чтобы извлечь идентификатор маршрута.
Чтобы выбрать сервер, куда передается поступивший запрос,
используется первое непустое значение;
она затем сравнивается с параметром sid
директивы server.
Если выбрать сервер не удается
или выбранный сервер не может обработать запрос,
то будет выбран другой сервер
согласно настроенному методу балансировки. Здесь Angie ищет идентификатор маршрута в cookie В этом режиме для привязки клиента к конкретному проксируемому серверу
используется динамически генерируемый ключ;
этот режим более гибок,
так как назначает серверы на ходу,
хранит сеансы в зоне разделяемой памяти
и поддерживает различные способы передачи идентификаторов сессий. Здесь сессия создается
на основе ответа проксируемого сервера.
С параметрами Идентификатором сессии служит значение первой непустой переменной,
указанной с Сессии хранятся в зоне разделяемой памяти;
ее имя и размер задаются параметром По умолчанию Angie продлевает срок действия сессии,
обновляя метку времени последнего обращения при каждом использовании.
Параметр Последующие запросы от клиентов, желающих использовать сессию,
должны содержать ее идентификатор.
Параметр Параметр В примере Angie создает сессию,
устанавливая в ответе cookie с именем Параметры Если к сессии не было обращений в течение времени
По умолчанию Angie продлевает срок действия сессии,
обновляя метку времени последнего обращения при каждом ее использовании.
Параметр Параметр Общий принцип работы режима таков:
если идентификатор сессии не найден локально или истек таймаут,
Angie отправляет синхронный подзапрос в некое удаленное хранилище,
заданное параметром При поступлении HTTP-запроса Angie выполняет следующие действия: Сначала извлекается идентификатор сессии из первой непустой переменной
в списке Если задан параметр Если сессия не найдена локально или параметр идентификатор сессии из параметра идентификатор предварительно выбранного сервера:
значение его параметра Проще всего можно передать эти идентификаторы через HTTP-заголовки
с помощью proxy_set_header. Удаленное хранилище обрабатывает запрос и возвращает HTTP-ответ: Если задан параметр Ответ с кодом 409 указывает на конфликт (лишь при наличии При получении от хранилища любого другого HTTP-кода,
а также при ошибке сети или таймауте
Angie использует изначально выбранный сервер. Если Идентификатор сервера извлекается из ответа удаленного хранилища
через параметр В следующем примере Angie создает сессию,
использует переменную Ниже показан упрощенный пример конфигурации.
Удаленное хранилище возвращает идентификатор сессии в заголовке Здесь при следующем ответе от удаленного хранилища: Становятся доступными две переменные: Так как переменная Директива Серверы, помеченные как Серверы, которые достигли максимального количества соединений
(при использовании Серверы с опцией Если ранее недоступный сервер восстанавливается,
Поведение Зоны разделяемой памяти,
указываемые в параметре Добавляет строку как соль в функцию MD5-хэширования
для директивы sticky в режимах Соль добавляется после хэшируемого значения;
чтобы независимо проверить механизм хэширования: Если директива включена, Angie возвращает клиенту ошибку HTTP 502,
когда идентификатор сервера, закрепленный за сессией,
не соответствует ни одному серверу группы или этот сервер недоступен,
а не переходит к балансировке нагрузки, как по умолчанию. Переменная $upstream_sticky_status
HTTP-модуля Upstream показывает, содержал ли запрос
данные о привязке и попал ли он на привязанный сервер. Сам модуль
Используется с Используется с Пример конфигурации#
upstream backend {
zone backend 1m;
server backend1.example.com:8080;
server backend2.example.com:8080;
sticky cookie srv_id max-age=3600;
}
Директивы#
sticky#
sticky cookie name [attr=значение]...;sticky route значение...;sticky learn zone=зона create=$create_var1... lookup=$lookup_var1... [header] [norefresh] [timeout=время];sticky learn [zone=зона] lookup=$lookup_var1... remote_action=uri remote_result=$remote_var [norefresh] [timeout=время];sticky,
можно использовать опцию drain
в блоке server.sticky должна использоваться после всех директив,
задающих тот или иной метод балансировки нагрузки,
иначе она не будет работать.
Если она используется наряду с директивой bind_conn,
то bind_conn должна стоять после sticky.name) задается директивой sticky,
а значение (value) соответствует
параметру sid
директивы server.
Учтите, что параметр дополнительно хэшируется,
если задана директива sticky_secret.path=/.
Значения атрибутов задаются строками с переменными.
Чтобы удалить атрибут, задайте для него пустое значение: attr=.
Так, sticky cookie path= задает cookie без атрибута path.srv_id со сроком действия в 1 час
и доменом, заданным переменной:upstream backend {
zone backend 1m;
server backend1.example.com:8080;
server backend2.example.com:8080;
sticky cookie srv_id domain=$my_domain max-age=3600;
}
route,
затем в аргументе запроса route:upstream backend {
zone backend 1m;
server backend1.example.com:8080 "sid=server 1";
server backend2.example.com:8080 "sid=server 2";
sticky route $cookie_route $arg_route;
}
create и lookup перечисляются переменные,
указывающие, как создаются новые и ищутся существующие сессии.
Оба параметра можно использовать по нескольку раз.create;
например, это может быть
cookie с проксируемого сервера.zone.
Если к сессии не было обращений в течение времени
timeout, она удаляется.
Значение по умолчанию — 1 час.norefresh отключает это поведение:
сессия истечет строго по таймауту, даже если продолжает использоваться.
Такой режим удобен,
когда требуется принудительно завершать сессию по истечении времени,
например, при интеграции с внешними менеджерами сессий.lookup ищет идентификатор сессии в пользовательском запросе
по заданному для него списку переменных,
останавливаясь на первой непустой.
Если ничего не найдено — запрос считается новым.
Значение найденного идентификатора
сопоставляется с сессиями в разделяемой памяти.
Если выбрать сервер не удается
или выбранный сервер не может обработать запрос,
то будет выбран другой сервер
согласно настроенному методу балансировки.header позволяет создать сессию
сразу после получения заголовков ответа от проксируемого сервера.
Без него сессия создается только после завершения обработки запроса.examplecookie:upstream backend {
zone backend 1m;
server backend1.example.com:8080;
server backend2.example.com:8080;
sticky learn
create=$upstream_cookie_examplecookie
lookup=$cookie_examplecookie
zone=client_sessions:1m;
}
remote_action и remote_result
позволяют динамически назначать идентификаторы сессий и управлять ими
с использованием удаленного хранилища сессий.
При этом зона разделяемой памяти выступает в роли локального кэша,
а удаленное хранилище является авторитетным источником.
Поэтому параметр create
несовместим с remote_action,
так как идентификаторы сессий должны создаваться удаленно.timeout, она удаляется.
Значение по умолчанию — 1 час.
Настройка remote_action не влияет на таймаут.norefresh меняет это поведение:
сессия истекает строго по таймауту, даже если используется.zone
в конфигурации sticky с remote_action
необязателен.
Если он не задан,
Angie полностью полагается на удаленное хранилище:
не кэширует сессии локально
(хотя позволяет кэшировать ответы хранилища через proxy_cache)
и обращается к удаленному хранилищу при каждом запросе,
для которого переменные lookup дают идентификатор сессии.remote_action.lookup.
Если все переменные пустые,
используется обычный алгоритм балансировки нагрузки без привязки.zone,
Angie ищет существующую сессию в локальной разделяемой памяти.
При обнаружении используется связанный с ней сервер
и обработка завершается.zone не задан,
сервер выбирается как обычно, согласно настроенному методу балансировки.
Затем Angie отправляет в удаленное хранилище,
заданное параметром remote_action, синхронный HTTP-подзапрос,
который должен содержать в понятном хранилищу виде:lookup
(в конфигурации это переменная
$sticky_sessid);sid=
или идентификатор, сгенерированный по умолчанию
(см. server;
в конфигурации это переменная
$sticky_sid).zone,
ответ с кодом 200, 201 или 204 подтверждает выбранный сервер,
и сессия сохраняется в зоне разделяемой памяти.
Без zone хранилище возвращает в таком ответе
идентификатор сервера, закрепленного за сессией
(он может отличаться от $sticky_sid);
Angie извлекает его через remote_result
и направляет запрос на сервер с этим идентификатором.zone):
данный идентификатор сессии уже существует, но связан с другим сервером.
Удаленное хранилище должно одновременно с этим
вернуть правильный идентификатор сервера в HTTP-заголовке;
извлечь его можно через remote_result.remote_result дает пустой идентификатор сервера
или идентификатор, которому не соответствует ни один доступный сервер,
Angie записывает ошибку в лог и выбирает сервер методом балансировки;
при включенной директиве sticky_strict
клиент вместо этого получает ошибку 502.remote_result:
в нем можно указывать переменные
с префиксом upstream_http_,
которые создаются Angie автоматически для доступа
к заголовкам HTTP-ответов от удаленного хранилища.
Например, заголовок X-Sid: server1 в таком ответе
становится доступным в переменной $upstream_http_x_sid
со значением server1.$cookie_bar
для начального идентификатора сессии,
а альтернативные идентификаторы сессий, возвращенные удаленным хранилищем,
сохраняет в $upstream_http_x_sticky_sid:http {
upstream u1 {
server srv1;
server srv2;
sticky learn zone=sz:1m
lookup=$cookie_bar
remote_action=/remote_session
remote_result=$upstream_http_x_sticky_sid;
zone z 1m;
}
server {
listen localhost;
location / {
proxy_pass http://u1/;
}
location /remote_session {
internal;
proxy_set_header X-Sticky-Sessid $sticky_sessid;
proxy_set_header X-Sticky-Sid $sticky_sid;
proxy_set_header X-Sticky-Last $msec;
proxy_pass http://remote;
}
}
}
X-Sid
и таким образом подтверждает или переопределяет выбор Angie:http {
proxy_cache_path c1 keys_zone=s1:1m;
upstream tc_0 {
server 10.0.0.1 sid=web-server-01;
server 10.0.0.2 sid=web-server-02;
sticky learn
lookup=$arg_id
remote_action=@create_session
remote_result=$upstream_http_x_sid;
}
server {
listen 127.0.0.1:8080;
location / {
proxy_pass http://tc_0/;
}
# Запрос к удаленному хранилищу сессий
location @create_session {
internal;
proxy_set_header X-Sticky-Sessid $sticky_sessid;
proxy_set_header X-Sticky-Sid $sticky_sid;
proxy_set_header X-Sticky-Last $msec;
proxy_pass http://session_backend;
proxy_connect_timeout 1s;
proxy_read_timeout 1s;
proxy_cache s1;
proxy_cache_valid 200 1d;
proxy_cache_key "$scheme$proxy_host$request_uri$sticky_sessid";
}
}
}
HTTP/1.1 200 OK
...
X-Sid: web-server-01
X-Session-Backend: backend-pool-1
$upstream_http_x_sid,
со значением web-server-01;$upstream_http_x_session_backend,
со значением backend-pool-1.$upstream_http_x_sid
указана в параметре remote_result,
то ее значение будет использовано
для выбора сервера с sid=web-server-01.sticky учитывает состояние серверов в upstream:down или временно недоступные из-за сбоев,
исключаются из выбора.max_conns), временно пропускаются.drain
могут быть выбраны для создания новых сессий в режиме sticky
при совпадении идентификаторов.sticky автоматически возобновляет его использование.sticky можно дополнительно настроить
директивами sticky_secret и sticky_strict.
Если в ходе работы sticky выбрать сервер не удается или он недоступен,
запрос будет обработан согласно выбранному методу балансировки нагрузки,
если только не включена директива sticky_strict.
В режиме sticky_strict on; запрос отклоняется с ошибкой.zone директивы sticky,
не могут использоваться совместно различными upstream;
каждая группа должна использовать свою собственную зону.sticky_secret#
cookie и route.
Строка может содержать переменные, например $remote_addr:upstream backend {
zone backend 1m;
server backend1.example.com:8080;
server backend2.example.com:8080;
sticky cookie cookie_name;
sticky_secret my_secret.$remote_addr;
}
$ echo -n "<VALUE><SALT>" | md5sum
sticky_strict#
Встроенные переменные#
http_upstream_sticky поддерживает следующие встроенные переменные:$sticky_sessid#remote_action в sticky;
хранит начальный идентификатор сессии, взятый из lookup.$sticky_sid#remote_action в sticky;
хранит идентификатор сервера, предварительно выбранного методом балансировки:
значение его параметра sid=
или идентификатор, сгенерированный по умолчанию
(см. server).