Como utilizar a integração Upstash Waiting Room através do Marketplace

Upstash Waiting Room é uma integração que ajuda você a gerenciar picos de tráfego e evitar sobrecarga em seus sites e aplicações. A integração usa uma abordagem First-In, First-Out (FIFO) e aproveita o Edge Firewall da Azion, criando uma sala de espera para controlar e redirecionar o acesso de acordo com seus parâmetros.

Quando uma requisição é recebida pelo seu site, o Edge Firewall executa a integração. Em seguida, a integração verifica se há espaço disponível e move a requisição da fila de espera para a fila de liberação. Se não houver disponibilidade, a requisição é redirecionada para a sala de espera, recebendo um número na linha para acessar.


Para começar a usar esta integração, você precisa:


Para instalar esta integração:

  1. Acesse Azion Console > Marketplace.
  2. Na página inicial do Marketplace, selecione o cartão da Upstash Waiting Room.
  3. Na página de integração, clique no botão Get It Now, localizado no canto inferior direito da página.

Você verá uma mensagem indicando que sua integração foi instalada com sucesso.


Depois de instalar a integração Upstash Waiting Room, você precisará concluir as etapas explicadas abaixo para configurá-la.

Siga estes passos:

  1. No canto superior esquerdo, abra o Products menu e selecione Edge Firewall na seção SECURE.
  2. Clique no botão Add Rule Set.
  3. Dê um nome fácil de lembrar ao seu edge firewall.
  4. Selecione os domínios que deseja proteger com a função.
  5. Ative a opção Edge Functions na seção Edge Firewall Modules.
  • Esta ação dá acesso a edge functions no edge firewall.
  1. Clique no botão Save.

Pronto. Agora você instanciou o edge firewall para sua função e tem acesso a edge functions em seu edge firewall.

Configure uma função no Edge Firewall

Seção intitulada Configure uma funcao no Edge Firewall

Enquanto ainda estiver na página do Edge Firewall, selecione a aba Functions e siga estas etapas:

  1. Clique no botão Add ⁠Function.
  2. Dê um nome fácil de lembrar à sua instância.
  3. No menu suspenso, selecione a função da Upstash Waiting Room.

Esta ação carregará a função, mostrando um formulário com o código-fonte desta e, logo acima dele, duas abas: Code e Args. Ao clicar na aba Code, você poderá navegar pelo código-fonte, mas não poderá alterá-lo.

  1. Na guia Args, você passará suas credenciais do Upstash e suas variáveis:
{
"url": "https://region-database.upstash.io",
"token": "YourUpstashToken",
"ttl": 10,
"capacity": 2
}

Onde:

VariávelObrigatóriaDescrição
urlSimString de URL para conectar no Upstash Redis. Acesse o console do Upstash e copie o UPSTASH_REDIS_REST_URL na página do banco de dados
tokenSimToken para acessar o banco de dados Upstash Redis. Acesse o console do Upstash e copie o UPSTASH_REDIS_REST_TOKEN na página do banco de dados
ttlSimTempo máximo, em segundos, que um usuário pode permanecer no seu site. Exemplo: 180
capacitySimNúmero máximo de conexões simultâneas permitidas em seu site. Exemplo: 10

Para concluir, você deve configurar uma regra no Rules Engine para configurar os critérios (criteria) e o comportamento (behavior) para executar a função.

Ainda na página do Edge Firewall:

  1. Selecione a aba Rules Engine.
  2. Clique no botão New Rule.
  3. Dê um nome fácil de lembrar à sua nova regra.
  4. Selecione um criteria (critério) para executar a integração.
    • Exemplo: if Request URI starts with ./.
  5. Abaixo, selecione o behavior Run Function para os criteria.
  6. Selecione a função Upstash Waiting Room de acordo com o nome que você deu antes.
  7. Clique no botão Save.

Pronto. Agora a integração Upstash Waiting Room está em execução.