Upstream Sticky#
Vincula las sesiones de clientes a servidores de los grupos del módulo HTTP Upstream, de modo que las solicitudes de una misma sesión se pasan al mismo servidor. Las directivas del módulo se establecen en el bloque upstream.
Cuando se compila desde el código fuente, este módulo
se compila por defecto; puede deshabilitarse con la opción de
compilación --without-http_upstream_sticky_module.
En paquetes e imágenes de nuestros repositorios, el módulo está incluido en la compilación.
Guías relacionadas
Load Balancing: la vinculación de sesión prevalece sobre el método.
Ejemplo de configuración#
upstream backend {
zone backend 1m;
server backend1.example.com:8080;
server backend2.example.com:8080;
sticky cookie srv_id max-age=3600;
}
Directivas#
sticky#
| |
Por defecto | — |
upstream |
Configura la persistencia de sesión del cliente a servidores backend,
utilizando el modo especificado en el primer parámetro.
Para retirar gradualmente servidores con la directiva sticky,
puede usar la opción drain en el bloque server.
Advertencia
La directiva sticky debe aparecer después de todas las directivas de método de balanceo de carga.
De lo contrario, no funcionará.
Si se usa junto con bind_conn (PRO),
entonces bind_conn debe venir después de sticky.
Este modo utiliza cookies para mantener la persistencia de sesión. Es más adecuado para situaciones donde las cookies ya se utilizan para la gestión de sesiones.
Aquí, una solicitud de cliente, que aún no está vinculada a ningún servidor, se envía a un servidor elegido según el método de balanceo configurado. Además, Angie establece una cookie con un valor único que identifica al servidor.
El nombre de la cookie (name) se establece mediante la directiva sticky,
y el valor (value) corresponde
al parámetro sid
de la directiva server.
Tenga en cuenta que a este valor se le aplica además un hash
si la directiva sticky_secret está configurada.
Las solicitudes posteriores del cliente que contengan esta cookie se reenvían al servidor identificado por el valor de la cookie, que es el servidor con el sid especificado. Si la selección de un servidor falla o el servidor elegido no puede manejar la solicitud, se selecciona otro servidor según el método de balanceo configurado.
La directiva permite asignar atributos a la cookie;
el único atributo establecido por defecto es path=/.
Los valores de los atributos se especifican como cadenas con variables.
Para eliminar un atributo, establezca un valor vacío para él: attr=.
Así, sticky cookie path= crea una cookie sin path.
Aquí,
Angie crea una cookie llamada srv_id con una duración de una hora
y un dominio especificado por variable:
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;
}
Este modo utiliza identificadores de ruta predefinidos, que pueden provenir de URLs, cookies o argumentos de solicitud. Es menos flexible pero útil cuando dichos identificadores ya existen.
El servidor backend puede devolver un identificador de ruta conocido tanto por el cliente como por el servidor. Este valor debe coincidir con sid.
Las solicitudes posteriores deben llevar el identificador de ruta, por ejemplo, a través de una cookie o un argumento de consulta.
La directiva toma una lista de cadenas que pueden incluir variables para extraer el identificador de ruta. El primer resultado no vacío se compara con sid.
En este ejemplo, Angie comprueba primero la cookie route,
luego el argumento de consulta 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;
}
Este modo utiliza una clave generada dinámicamente para asignar un cliente a un backend. Es flexible y admite el almacenamiento de sesiones en memoria compartida y varias fuentes de identificadores.
Una sesión se crea a partir de la respuesta del servidor backend.
create y lookup definen cómo generar y localizar sesiones,
y ambos aceptan múltiples variables.
El ID de sesión es la primera variable no vacía de create.
Por ejemplo, puede provenir de una cookie de respuesta.
Las sesiones se almacenan en memoria compartida,
definida con zone name:size.
Si no se utiliza durante el periodo timeout (por defecto: 1 hora), la sesión caduca.
De forma predeterminada, Angie refresca las sesiones en cada uso.
Para desactivar este comportamiento, use norefresh.
El ID de sesión de una solicitud de cliente se extrae mediante lookup,
utilizando la primera variable no vacía listada.
Si no se encuentra ninguna, es una solicitud nueva.
Use header para crear la sesión al recibir las cabeceras de la respuesta
en lugar de tras el procesamiento completo de la respuesta.
Ejemplo: sesión creada con 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;
}
Use remote_action y remote_result
para gestionar los ID de sesión con un almacenamiento de sesiones externo.
La zona de memoria compartida actúa como una caché;
el almacenamiento externo es la fuente autoritativa.
create no es compatible con remote_action.
Las sesiones caducan tras timeout (por defecto: 1 hora),
independientemente de remote_action.
De forma predeterminada, Angie refresca el TTL de la sesión en cada uso.
Use norefresh para desactivarlo.
zone es opcional con remote_action.
Sin él, Angie no mantiene una caché local de sesiones
y consulta el almacenamiento externo en cada solicitud
cuyas variables lookup producen un ID de sesión;
las respuestas del almacenamiento aún pueden cachearse con proxy_cache.
Flujo básico:
Extraer el ID de sesión de la primera variable
lookupno vacía. Si no hay ninguna, recurrir al balanceo de carga estándar.Si
zoneestá establecida y la sesión existe, usarla y detenerse.Si no hay sesión o no hay zona, elegir un servidor y hacer una subsolicitud HTTP al endpoint
remote_actioncon:ID de sesión ($sticky_sessid);
ID de servidor ($sticky_sid): el valor
sid=del servidor preseleccionado, o su valor predeterminado generado (consulte server).
Enviarlos como cabeceras HTTP (mediante proxy_set_header).
El almacenamiento remoto responde:
200/201/204: con
zoneestablecida, confirma el servidor seleccionado, y Angie cachea la sesión en la zona. Sinzone, el almacenamiento debe devolver el ID del servidor vinculado a la sesión, que puede diferir de$sticky_sid; Angie lo extrae conremote_resulty dirige la solicitud a ese servidor.409 indica conflicto (si
zoneestá establecida) — sesión vinculada a otro servidor. Usarremote_resultpara extraer el ID de servidor corregido.Cualquier otro código de estado, un error de red o un tiempo de espera agotado — recurrir al servidor seleccionado originalmente.
Un ID de servidor vacío en
remote_result, o uno que no coincide con ningún servidor disponible — registrar un error y elegir un servidor mediante el método de balanceo de carga; con sticky_strict habilitado, devolver en su lugar un error 502.
remote_result usa variables upstream_http_*
para leer las cabeceras de la respuesta del almacenamiento remoto.
Ejemplo: ID de sesión proviene de $cookie_bar,
confirmado mediante $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;
}
}
}
A continuación se muestra un ejemplo de configuración simplificado.
El almacenamiento remoto devuelve el ID de sesión en la cabecera X-Sid
y así confirma o anula la elección de 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/;
}
# Solicitud al almacenamiento de sesión remoto
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";
}
}
}
Con la siguiente respuesta del almacenamiento remoto:
HTTP/1.1 200 OK
...
X-Sid: web-server-01
X-Session-Backend: backend-pool-1
Variables de Angie resultantes:
$upstream_http_x_sid, con el valorweb-server-01;$upstream_http_x_session_backend, con el valorbackend-pool-1.
Dado que la variable $upstream_http_x_sid
está especificada en el parámetro remote_result,
su valor se utilizará
para seleccionar el servidor con sid=web-server-01.
La directiva sticky tiene en cuenta el estado de los servidores en el grupo upstream:
Los servidores marcados como
downo con fallos se excluyen de la selección.Los servidores que han alcanzado el límite
max_connsse omiten.Los servidores con la opción
drainpueden seguir siendo seleccionados para nuevas sesiones en modostickycuando los identificadores coinciden.Los servidores recuperados vuelven a utilizarse automáticamente.
El comportamiento puede ajustarse adicionalmente con las directivas
sticky_secret y sticky_strict.
Si sticky no logra seleccionar un servidor
y sticky_strict está desactivada,
la solicitud se atiende con el método de balanceo de reserva;
si está activada, la solicitud se rechaza.
Cada zone utilizada en sticky debe ser exclusiva de un único bloque upstream.
Las zonas no pueden compartirse entre varios bloques upstream.
sticky_secret#
Añade el string como valor de sal a la función de hash MD5
para la directiva sticky en los modos cookie y route.
El string puede contener variables, por ejemplo, $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;
}
La sal se añade al valor que se está hasheando; para verificar el mecanismo de hash de forma independiente:
$ echo -n "<VALUE><SALT>" | md5sum
sticky_strict#
Cuando está habilitado, Angie devuelve un error HTTP 502 al cliente si el ID de servidor vinculado a la sesión no coincide con ningún servidor del grupo o ese servidor no está disponible, en lugar de recurrir al balanceo de carga (el comportamiento predeterminado).
Variables integradas#
La variable $upstream_sticky_status del
módulo HTTP Upstream indica si la solicitud traía
datos de sesión y si llegó al servidor vinculado. El propio módulo
Se utiliza con Se utiliza con http_upstream_sticky admite las siguientes variables integradas:$sticky_sessid (PRO)#remote_action en sticky;
almacena el ID de sesión inicial tomado de lookup.$sticky_sid (PRO)#remote_action en sticky;
almacena el ID del servidor preseleccionado por el método de balanceo de carga:
el valor sid= del servidor o su valor predeterminado generado
(consulte server).