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. 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. Predeterminado — upstream Configura sesiones persistentes entre clientes y servidores upstream,
dependiendo del modo especificado en el primer parámetro.
Para retirar gradualmente servidores con Advertencia La directiva 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 En este modo, se usa una clave generada dinámicamente
para vincular un cliente a un servidor upstream específico;
este modo es más flexible
ya que asigna servidores sobre la marcha,
almacena sesiones en una zona de memoria compartida,
y admite varias formas de pasar identificadores de sesión. Aquí, se crea una sesión
basándose en propiedades de conexión provenientes del servidor upstream.
Los parámetros El identificador de sesión es el valor de la primera variable no vacía
especificada con Las sesiones se almacenan en una zona de memoria compartida;
su nombre y tamaño se especifican mediante el parámetro Por defecto, Angie extiende el tiempo de vida de la sesión
actualizando la marca de tiempo del último acceso cada vez que se usa.
El parámetro Las conexiones posteriores de clientes que deseen usar una sesión
deben contener su identificador.
El parámetro El parámetro En el ejemplo, Angie crea y busca sesiones
usando la variable $rdp_cookie: Los parámetros El parámetro El parámetro El principio general de funcionamiento de este modo es el siguiente:
si no se encuentra un identificador de sesión localmente,
Angie envía una subsolicitud síncrona a un almacén remoto
especificado por el parámetro Cuando llega una nueva conexión, Angie realiza las siguientes acciones: Primero, el identificador de sesión se extrae de la primera variable no vacía
en la lista Si Si la sesión no se encuentra localmente o el identificador de sesión del parámetro el identificador del servidor preseleccionado
(en la configuración, esta es la
variable $sticky_sid):
el valor Las variables El almacén remoto procesa la solicitud y devuelve una respuesta HTTP: Con Con Al recibir cualquier otro código HTTP del almacén,
o ante un error de red o un tiempo de espera agotado,
Angie usa el servidor originalmente seleccionado. Si El identificador del servidor se extrae de la respuesta del almacén remoto
mediante el parámetro A continuación se muestra un ejemplo de configuración simplificado.
El almacén remoto devuelve el identificador del servidor en la cabecera Aquí, con la siguiente respuesta del almacén remoto: Dos variables quedan disponibles: Dado que la variable La directiva Los servidores marcados como Los servidores que han alcanzado el número máximo de conexiones
(al usar Los servidores con la opción Si un servidor previamente no disponible se recupera,
El comportamiento de Las zonas de memoria compartida
especificadas en el parámetro Añade cadena como sal a la función hash MD5
para la directiva sticky en modo La sal se añade después del valor hash;
para verificar independientemente el mecanismo de hash: 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). 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
Se usa con Se usa con 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;
}
Directivas#
sticky#
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)sticky de la rotación,
puede usarse la opción drain en el bloque server.sticky debe aparecer después de todas las directivas de método de balanceo de carga,
de lo contrario no funcionará.$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;
}
}
create y lookup listan variables
que especifican cómo se crean nuevas sesiones y se encuentran las existentes.
Ambos parámetros pueden usarse múltiples veces.create;
por ejemplo, esto podría ser
el nombre del servidor upstream.zone.
Si no se ha accedido a una sesión dentro del tiempo
especificado por timeout, se elimina.
El valor predeterminado es 1 hora.norefresh cambia este comportamiento:
la sesión expira estrictamente por tiempo de espera, incluso si se está usando.lookup busca el identificador de sesión en la conexión
usando la lista especificada de variables,
deteniéndose en la primera no vacía.
Si no se encuentra nada, la solicitud se considera nueva.
El valor del identificador encontrado
se compara con las sesiones en memoria compartida.
Si la selección del servidor falla
o el servidor seleccionado no puede manejar la conexión,
se seleccionará otro servidor
según el método de balanceo de carga configurado.connect permite crear una sesión
inmediatamente después de establecer una conexión con el servidor upstream.
Sin él, la sesión se crea solo después de que se completa el procesamiento de la conexión.
(En el caso de conexiones UDP, las sesiones se crean inmediatamente después de la selección del servidor.)stream {
upstream backend {
zone backend 1m;
server 127.0.0.1:3390;
server 127.0.0.1:3391;
sticky learn lookup=$rdp_cookie create=$rdp_cookie zone=sessions:1m;
}
server {
listen 127.0.0.1:3389;
rdp_preread on;
proxy_pass backend;
}
}
remote_action y remote_result
permiten asignar y gestionar identificadores de sesión dinámicamente
usando un almacén de sesiones remoto (PRO).zone es opcional en este modo.
Con él, la zona de memoria compartida actúa como caché local de sesiones,
y timeout y norefresh funcionan
igual que en el modo learn con create;
el almacén remoto sigue siendo la fuente autoritativa.
Sin él, Angie no mantiene una caché local de sesiones
y consulta el almacén remoto para cada conexión
cuyas variables lookup producen un identificador de sesión.remote_action debe apuntar a un location
en el contexto client.
El parámetro remote_uri especifica el URI de la solicitud HTTP del cliente
al location especificado.
Por defecto, es /.
El valor de remote_uri puede contener variables.remote_action.lookup.
Si todas las variables están vacías,
se usa el algoritmo de balanceo de carga normal sin sesiones persistentes.zone está establecida,
Angie busca la sesión en la zona de memoria compartida.
Si encuentra la sesión, Angie usa su servidor y se detiene.zone no está establecida,
Angie selecciona un servidor mediante el método de balanceo de carga configurado.
Luego envía una subsolicitud HTTP síncrona al almacén remoto
especificado por el parámetro remote_action, que debe contener
en un formato entendido por el almacén:lookup
(en la configuración, esta es la
variable $sticky_sessid);sid= del servidor
o su valor predeterminado generado (consulte server).$sticky_sessid y $sticky_sid se exportan automáticamente
al contexto HTTP con el prefijo stream_:
$stream_sticky_sessid, $stream_sticky_sid.
Esto permite usarlas directamente en directivas HTTP,
por ejemplo mediante cabeceras HTTP usando proxy_set_header.zone establecida,
una respuesta con código 200, 201 o 204 confirma el servidor seleccionado,
y la sesión se guarda en la zona de memoria compartida.
Sin zone, el almacén debe devolver en dicha respuesta
el identificador del servidor vinculado a la sesión,
que puede diferir de $sticky_sid;
Angie lo extrae mediante remote_result
y dirige la conexión a ese servidor.zone establecida, una respuesta con código 409 indica un conflicto:
el identificador de sesión ya existe, pero está vinculado a otro servidor.
El almacén remoto debe devolver el identificador de servidor correcto
en la misma respuesta; puede extraerse mediante remote_result.remote_result produce un identificador de servidor vacío
o uno que no coincide con ningún servidor disponible,
Angie registra un error y selecciona un servidor mediante el método de balanceo de carga;
con sticky_strict habilitado,
el cliente recibe en su lugar un error de conexión.remote_result:
puede especificar variables
con el prefijo upstream_http_,
que son creadas automáticamente por Angie para acceder
a las cabeceras de respuesta HTTP del almacén remoto,
o $sent_body para usar el cuerpo de la respuesta.
Por ejemplo, la cabecera X-Sid: server1 en dicha respuesta
se vuelve accesible en la variable $upstream_http_x_sid
con el valor server1.X-Sticky-Sid
y así confirma o anula la selección de Angie:http {
client {
location @sticky_client1 {
# usar variables del upstream de stream;
# las añade al contexto HTTP con el prefijo stream_*
proxy_set_header X-Sticky-Sessid $stream_sticky_sessid;
proxy_set_header X-Sticky-Sid $stream_sticky_sid;
proxy_set_header X-Sticky-Last $msec;
proxy_pass http://127.0.0.1:8080;
proxy_cache remote;
proxy_cache_valid 200 1d;
proxy_cache_key $scheme$proxy_host$request_uri$stream_sticky_sessid;
}
}
}
stream {
upstream u {
zone u 1m;
server 127.0.0.1:8081 sid=backend-01;
server 127.0.0.1:8082 sid=backend-02;
sticky learn lookup=$remote_addr # variable de stream
remote_action=@sticky_client1 # location del bloque client
remote_result=$upstream_http_x_sticky_sid # variable HTTP
remote_uri=/foo; # por defecto es /
}
server {
listen 127.0.0.1:8080;
proxy_pass u;
}
}
HTTP/1.1 200 OK
...
X-Sticky-Sid: backend-01
X-Session-Info: active
$upstream_http_x_sticky_sid,
con el valor backend-01;$upstream_http_x_session_info,
con el valor active.$upstream_http_x_sticky_sid
se especifica en el parámetro remote_result,
su valor se utilizará
para seleccionar el servidor con sid=backend-01.sticky tiene en cuenta el estado de los servidores en upstream:down o temporalmente no disponibles debido a fallos
se excluyen de la selección.max_conns) se omiten temporalmente.drain
pueden ser seleccionados para crear nuevas sesiones en modo sticky
cuando los identificadores coinciden.sticky reanuda automáticamente su uso.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.zone de la directiva sticky
no pueden compartirse entre diferentes grupos upstream;
cada grupo debe usar su propia zona.sticky_secret#
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;
}
$ echo -n "<VALUE><SALT>" | md5sum
sticky_strict#
Variables integradas#
stream_upstream_sticky admite las siguientes variables integradas:$sticky_sessid (PRO)#remote_action en sticky;
almacena el identificador de sesión inicial tomado de lookup.$sticky_sid (PRO)#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).