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.

Pré-requisitos

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

Obtenha a integração

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 Install.

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

Configure a integração

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

Configure uma regra no Edge Firewall

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 + Edge Firewall.
  3. Dê um nome fácil de lembrar ao seu edge firewall.
  4. Ative a opção Edge Functions na seção 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

Enquanto ainda estiver na página do Edge Firewall:

  1. Selecione a aba Functions Instances e siga estas etapas:
  2. Clique no botão + Function Instance.
  3. Dê um nome fácil de lembrar à sua instância.
  4. No menu suspenso, selecione a função da Upstash Waiting Room.
  5. Na caixa Arguments, você passará suas credenciais do Upstash e suas variáveis:
{ "url": "https://region-database.upstash.io", "token": "YourUpstashToken", "ttl": 10, "ttl_wait": 180, "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
ttl_waitSimTempo máximo, em segundos, que um usuário pode permanecer inativo na sala de espera (por exemplo, ao fechar a aba/janela do site) sem perder seu lugar. Exemplo: 180
capacitySimNúmero máximo de conexões simultâneas permitidas em seu site. Exemplo: 10
  1. Clique no botão Save.

Configure uma regra no Rules Engine

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 + Rule Engine.
  3. Dê um nome fácil de lembrar à sua nova regra.
  4. Selecione um criteria (critério) para executar a integração.
  • Exemplo: if Host matches yourdomain.com.
  1. Abaixo, selecione um behavior (comportamento) para os criteria (critérios). Neste caso, será Run Function.
    • Selecione a função adequada de acordo com o nome que você deu na etapa de instanciação.
  2. Clique no botão Save.

Agora, no Console, você deve configurar seu domínio para que ele seja protegido pelo seu edge firewall.

  1. No Products menu, selecione Domains.
  2. Clique no domínio que você deseja proteger com sua função Upstash Waiting Room.
  3. Na seção Settings, clique no seletor de Edge Firewall e escolha o edge firewall que você acabou de criar.
  4. Clique no botão Save.

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

Contribuidores