Upstream Sticky#
Vincula sessões de clientes a servidores em grupos do módulo Stream Upstream, de modo que as conexões de uma sessão sejam encaminhadas ao mesmo servidor. As diretivas do módulo são definidas no bloco upstream.
Ao compilar a partir do código-fonte, o módulo é
compilado por padrão junto com o módulo Stream
(habilitado com --with-stream); ele pode ser desabilitado com a
opção de compilação --without-stream_upstream_sticky_module.
Em pacotes e imagens de nossos repositórios, o
módulo está incluído na compilação. O Angie vincula cada endereço de cliente ao servidor de sua primeira sessão e
encaminha as conexões seguintes desse endereço ao mesmo servidor. Padrão — upstream Configura sessões persistentes entre clientes e servidores upstream,
dependendo do modo especificado no primeiro parâmetro.
Para gradualmente tirar servidores com Aviso A diretiva Este modo usa identificadores de rota predefinidos
que podem ser incorporados em propriedades de conexão acessíveis ao Angie.
É menos flexível, pois depende de valores predefinidos,
mas é mais adequado se tais identificadores já estiverem em uso. Aqui, ao estabelecer uma conexão, o servidor upstream
pode atribuir uma rota ao cliente e retornar seu identificador de uma forma
conhecida por ambas as partes.
O identificador de rota
deve usar o valor do parâmetro sid
da diretiva server.
Note que o parâmetro é adicionalmente hasheado
se a diretiva sticky_secret for especificada. Conexões subsequentes de clientes que desejam usar esta rota
devem conter o identificador emitido pelo servidor, de tal forma
que ele termine em variáveis do Angie. Os parâmetros da diretiva especificam strings que podem incluir variáveis
para roteamento. Para selecionar o servidor para onde a conexão de entrada é direcionada,
o primeiro valor não vazio é usado;
ele é então comparado com o parâmetro sid
da diretiva server.
Se a seleção do servidor falhar
ou o servidor selecionado não puder aceitar a conexão,
outro servidor será selecionado
de acordo com o método de balanceamento de carga configurado. Aqui o Angie procura o identificador de rota na variável Neste modo, uma chave gerada dinamicamente é usada
para vincular um cliente a um servidor upstream específico;
este modo é mais flexível
pois atribui servidores dinamicamente,
armazena sessões em uma zona de memória compartilhada,
e suporta várias formas de passar identificadores de sessão. Aqui, uma sessão é criada
com base em propriedades de conexão vindas do servidor upstream.
Os parâmetros O identificador de sessão é o valor da primeira variável não vazia
especificada com Sessões são armazenadas em uma zona de memória compartilhada;
seu nome e tamanho são especificados pelo parâmetro Por padrão, o Angie estende o tempo de vida da sessão
atualizando o timestamp do último acesso cada vez que ela é usada.
O parâmetro Conexões subsequentes de clientes que desejam usar uma sessão
devem conter seu identificador.
O parâmetro O parâmetro No exemplo, o Angie cria e procura sessões
usando a variável $rdp_cookie: Os parâmetros O parâmetro O parâmetro O princípio geral de operação deste modo é o seguinte:
se um identificador de sessão não for encontrado localmente,
o Angie envia uma subrequisição síncrona para um armazenamento remoto
especificado pelo parâmetro Quando uma nova conexão chega, o Angie executa as seguintes ações: Primeiro, o identificador de sessão é extraído da primeira variável não vazia
na lista Se Se a sessão não for encontrada localmente ou o identificador de sessão do parâmetro o identificador do servidor pré-selecionado
(na configuração, esta é a
variável $sticky_sid):
o valor As variáveis O armazenamento remoto processa a requisição e retorna uma resposta HTTP: Com Com Ao receber qualquer outro código HTTP do armazenamento,
ou em caso de erro de rede ou timeout,
o Angie usa o servidor originalmente selecionado. Se O identificador do servidor é extraído da resposta do armazenamento remoto
via o parâmetro Abaixo está um exemplo de configuração simplificado.
O armazenamento remoto retorna o identificador do servidor no cabeçalho Aqui, com a seguinte resposta do armazenamento remoto: Duas variáveis ficam disponíveis: Como a variável A diretiva Servidores marcados como Servidores que atingiram o número máximo de conexões
(ao usar Servidores com a opção Se um servidor anteriormente indisponível se recuperar,
O comportamento de Zonas de memória compartilhada
especificadas no parâmetro Adiciona string como salt à função hash MD5
para a diretiva sticky no modo O salt é adicionado após o valor com hash;
para verificar independentemente o mecanismo de hashing: Quando habilitado, o Angie retorna um erro de conexão para o cliente
se o identificador do servidor vinculado à sessão não corresponder a nenhum servidor do grupo
ou se esse servidor estiver indisponível,
em vez de recorrer ao balanceamento de carga
(o comportamento padrão). A variável $upstream_sticky_status do
módulo Stream Upstream mostra se uma conexão trouxe
dados de sessão e se chegou ao servidor vinculado. O próprio módulo
Usado com Usado com Exemplo de configuração#
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;
}
Diretivas#
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 rotação,
você pode usar a opção drain no bloco server.sticky deve aparecer após todas as diretivas de método de balanceamento de carga,
caso contrário não funcionará.$route,
que recebe seu valor baseado em $ssl_preread_server_name
(note que ssl_preread deve 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 e lookup listam variáveis
que especificam como novas sessões são criadas e as existentes são encontradas.
Ambos os parâmetros podem ser usados múltiplas vezes.create;
por exemplo, isso poderia ser
o nome do servidor upstream.zone.
Se uma sessão não foi acessada dentro do tempo
especificado por timeout, ela é excluída.
O valor padrão é 1 hora.norefresh altera este comportamento:
a sessão expira estritamente pelo timeout, mesmo se estiver sendo usada.lookup procura o identificador de sessão na conexão
usando a lista especificada de variáveis,
parando na primeira não vazia.
Se nada for encontrado, a requisição é considerada nova.
O valor do identificador encontrado
é comparado com sessões na memória compartilhada.
Se a seleção do servidor falhar
ou o servidor selecionado não puder lidar com a conexão,
outro servidor será selecionado
de acordo com o método de balanceamento de carga configurado.connect permite criar uma sessão
imediatamente após estabelecer uma conexão com o servidor upstream.
Sem ele, a sessão é criada apenas após o processamento da conexão estar completo.
(No caso de conexões UDP, sessões são criadas imediatamente após a seleção do 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 e remote_result
permitem atribuir e gerenciar identificadores de sessão dinamicamente
usando um armazenamento de sessão remoto (PRO).zone é opcional neste modo.
Com ele, a zona de memória compartilhada atua como cache local de sessões,
e timeout e norefresh funcionam
como no modo learn com create;
o armazenamento remoto continua sendo a fonte autoritativa.
Sem ele, o Angie não mantém cache local de sessões
e consulta o armazenamento remoto para cada conexão
cujas variáveis lookup produzam um identificador de sessão.remote_action deve apontar para um location
no contexto client.
O parâmetro remote_uri especifica o URI da requisição HTTP do cliente
para o location especificado.
Por padrão, é /.
O valor de remote_uri pode conter variáveis.remote_action.lookup.
Se todas as variáveis estiverem vazias,
o algoritmo normal de balanceamento de carga é usado sem sessões persistentes.zone estiver definida,
o Angie procura a sessão na zona de memória compartilhada.
Se a sessão for encontrada, o Angie usa o servidor dela e para.zone não estiver definida,
o Angie seleciona um servidor pelo método de balanceamento de carga configurado.
Então envia uma subrequisição HTTP síncrona para o armazenamento remoto
especificado pelo parâmetro remote_action, que deve conter
em um formato compreendido pelo armazenamento:lookup
(na configuração, esta é a
variável $sticky_sessid);sid= do servidor
ou seu padrão gerado (veja server).$sticky_sessid e $sticky_sid são automaticamente
exportadas para o contexto HTTP com o prefixo stream_:
$stream_sticky_sessid, $stream_sticky_sid.
Isso permite usá-las diretamente em diretivas HTTP,
por exemplo via cabeçalhos HTTP usando proxy_set_header.zone definida,
uma resposta com código 200, 201 ou 204 confirma o servidor selecionado,
e a sessão é salva na zona de memória compartilhada.
Sem zone, o armazenamento deve retornar nessa resposta
o identificador do servidor vinculado à sessão,
que pode diferir de $sticky_sid;
o Angie o extrai via remote_result
e encaminha a conexão para esse servidor.zone definida, uma resposta com código 409 sinaliza um conflito:
o identificador de sessão já existe, mas está vinculado a outro servidor.
O armazenamento remoto deve retornar o identificador correto do servidor
na mesma resposta; ele pode ser extraído via remote_result.remote_result produzir um identificador de servidor vazio
ou um que não corresponda a nenhum servidor disponível,
o Angie registra um erro e seleciona um servidor pelo método de balanceamento de carga;
com sticky_strict habilitada,
o cliente recebe um erro de conexão.remote_result:
ele pode especificar variáveis
com o prefixo upstream_http_,
que são criadas automaticamente pelo Angie para acessar
cabeçalhos de resposta HTTP do armazenamento remoto,
ou $sent_body para usar o corpo da resposta.
Por exemplo, o cabeçalho X-Sid: server1 em tal resposta
torna-se acessível na variável $upstream_http_x_sid
com o valor server1.X-Sticky-Sid
e assim confirma ou substitui a seleção do Angie:http {
client {
location @sticky_client1 {
# usa variáveis do stream upstream;
# ele adiciona essas variáveis ao contexto HTTP com o prefixo 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 # stream variable
remote_action=@sticky_client1 # location from client block
remote_result=$upstream_http_x_sticky_sid # HTTP variable
remote_uri=/foo; # default is /
}
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,
com o valor backend-01;$upstream_http_x_session_info,
com o valor active.$upstream_http_x_sticky_sid
é especificada no parâmetro remote_result,
seu valor será usado
para selecionar o servidor com sid=backend-01.sticky leva em consideração o estado dos servidores em upstream:down ou temporariamente indisponíveis devido a falhas
são excluídos da seleção.max_conns) são temporariamente ignorados.drain
podem ser selecionados para criar novas sessões no modo sticky
quando os identificadores correspondem.sticky automaticamente retoma seu uso.sticky pode ser configurado adicionalmente
com as diretivas sticky_secret e sticky_strict.
Se sticky falhar ao selecionar um servidor ou ele estiver indisponível,
a requisição será tratada de acordo com o método de balanceamento de carga selecionado,
a menos que a diretiva sticky_strict esteja habilitada.
No modo sticky_strict on;, a requisição é rejeitada com um erro.zone da diretiva sticky
não podem ser compartilhadas entre diferentes grupos upstream;
cada grupo deve usar sua própria zona.sticky_secret#
route.
String pode conter variáveis, por exemplo $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#
Variáveis integradas#
stream_upstream_sticky suporta as seguintes variáveis integradas:$sticky_sessid (PRO)#remote_action em sticky;
armazena o identificador de sessão inicial obtido de lookup.$sticky_sid (PRO)#remote_action em sticky;
armazena o identificador do servidor pré-selecionado pelo método de balanceamento de carga:
o valor sid= do servidor ou seu padrão gerado
(veja server).