Upstream Sticky#

Vincula las sesiones de clientes a servidores de los grupos del módulo Stream Upstream, de modo que las conexiones 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 junto con el módulo Stream (habilitado con --with-stream); puede deshabilitarse con la opción de compilación --without-stream_upstream_sticky_module.

En paquetes e imágenes de nuestros repositorios, el módulo está incluido en la compilación.

Ejemplo de configuración#

upstream backend {
    zone backend 1m;
    server backend1.example.com:1935;
    server backend2.example.com:1935;

    sticky learn zone=clients:1m create=$remote_addr lookup=$remote_addr;
}

Angie vincula cada dirección de cliente al servidor de su primera sesión y pasa las conexiones posteriores desde esa dirección al mismo servidor.

Directivas#

sticky#

Sintaxis

sticky route value...;

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

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

Predeterminado

—

Contexto

upstream

Configura sesiones persistentes entre clientes y servidores upstream, dependiendo del modo especificado en el primer parámetro. Para retirar gradualmente servidores con sticky de la rotación, puede usarse 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á.

Este modo utiliza identificadores de ruta predefinidos que pueden estar integrados en propiedades de conexión accesibles para Angie. Es menos flexible ya que depende de valores predefinidos, pero es más adecuado si dichos identificadores ya están en uso.

Aquí, al establecer una conexión, el servidor upstream puede asignar una ruta al cliente y devolver su identificador de una manera conocida por ambas partes. El identificador de ruta debe usar el valor del parámetro sid de la directiva server. Tenga en cuenta que el parámetro se hashea adicionalmente si se especifica la directiva sticky_secret.

Las conexiones posteriores de clientes que deseen usar esta ruta deben contener el identificador emitido por el servidor, de tal manera que termine en variables de Angie.

Los parámetros de la directiva especifican cadenas que pueden incluir variables para el enrutamiento. Para seleccionar el servidor al que se dirige la conexión entrante, se usa el primer valor no vacío; luego se compara con el parámetro sid de la directiva server. Si la selección del servidor falla o el servidor seleccionado no puede aceptar la conexión, se seleccionará otro servidor según el método de balanceo de carga configurado.

Aquí Angie busca el identificador de ruta en la variable $route, que recibe su valor basándose en $ssl_preread_server_name (tenga en cuenta que ssl_preread debe estar habilitado):

stream {

    map $ssl_preread_server_name $route {

        a.example.com            a;
        b.example.com            b;
        default                  "";
    }

    upstream backend {

        zone backend 1m;

        server 127.0.0.1:8081 sid=a;
        server 127.0.0.1:8082 sid=b;

        sticky route $route;
    }

    server {

        listen 127.0.0.1:8080;

        ssl_preread on;

        proxy_pass backend;
    }
}

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

  • Los servidores marcados como down o temporalmente no disponibles debido a fallos se excluyen de la selección.

  • Los servidores que han alcanzado el número máximo de conexiones (al usar max_conns) se omiten temporalmente.

  • Los servidores con la opción drain pueden ser seleccionados para crear nuevas sesiones en modo sticky cuando los identificadores coinciden.

  • Si un servidor previamente no disponible se recupera, sticky reanuda automáticamente su uso.

El comportamiento de sticky puede configurarse adicionalmente con las directivas sticky_secret y sticky_strict. Si sticky no logra seleccionar un servidor o este no está disponible, la solicitud se manejará según el método de balanceo de carga seleccionado, a menos que la directiva sticky_strict esté habilitada. En modo sticky_strict on;, la solicitud se rechaza con un error.

Las zonas de memoria compartida especificadas en el parámetro zone de la directiva sticky no pueden compartirse entre diferentes grupos upstream; cada grupo debe usar su propia zona.

sticky_secret#

Sintaxis

sticky_secret cadena;

Predeterminado

—

Contexto

upstream

Añade cadena como sal a la función hash MD5 para la directiva sticky en modo route. Cadena puede contener variables, por ejemplo $remote_addr:

upstream backend {
    zone backend 1m;
    server 127.0.0.1:8081 sid=a;
    server 127.0.0.1:8082 sid=b;

    sticky route $route;
    sticky_secret my_secret.$remote_addr;
}

La sal se añade después del valor hash; para verificar independientemente el mecanismo de hash:

$ 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 de conexión al cliente si el identificador 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 Stream Upstream indica si la conexión traía datos de sesión y si llegó al servidor vinculado. El propio módulo stream_upstream_sticky admite las siguientes variables integradas:

$sticky_sessid (PRO)#

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

$sticky_sid (PRO)#

Se usa con remote_action en sticky; almacena el identificador del servidor preseleccionado por el método de balanceo de carga: el valor sid= del servidor o su valor predeterminado generado (consulte server).