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#

Sintaxis

sticky cookie name [attr=value]...;

sticky route value...;

sticky learn zone=zone create=$create_var1... lookup=$lookup_var1... [header] [norefresh] [timeout=time];

sticky learn [zone=zone] lookup=$lookup_var1... remote_action=uri remote_result=$remote_var [norefresh] [timeout=time]; (PRO)

Por defecto

—

Contexto

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;
}

La directiva sticky tiene en cuenta el estado de los servidores en el grupo upstream:

  • Los servidores marcados como down o con fallos se excluyen de la selección.

  • Los servidores que han alcanzado el límite max_conns se omiten.

  • Los servidores con la opción drain pueden seguir siendo seleccionados para nuevas sesiones en modo sticky cuando 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#

Sintaxis

sticky_secret string;

Predeterminado

—

Contexto

upstream

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#

Sintaxis

sticky_strict on | off;

Predeterminado

sticky_strict off;

Contexto

upstream

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 http_upstream_sticky admite las siguientes variables integradas:

$sticky_sessid (PRO)#

Se utiliza con remote_action en sticky; almacena el ID de sesión inicial tomado de lookup.

$sticky_sid (PRO)#

Se utiliza con 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).