Skip to content

Latest commit

 

History

History
113 lines (78 loc) · 5 KB

waiting-room.mdx

File metadata and controls

113 lines (78 loc) · 5 KB
Raw
title description meta_tags namespace permalink
Como utilizar a integração Upstash Waiting Room através do Marketplace
Gerencie picos de tráfego e evite sobrecarga em seus sites e aplicações usando uma sala de espera.
edge firewall, marketplace, securança, integrações
docs_guides_waiting_room
/documentacao/produtos/guias/waiting-room/

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 Get It Now, localizado no canto inferior direito da página.

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

:::tip Você pode procurar qualquer integração navegando pelos cards ou digitando uma palavra-chave na barra de busca. :::

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

:::caution[Atenção] Se um produto ou módulo estiver ativado, pode gerar custos relacionados ao uso. Consulte a página de preços para obter mais informações. :::

Configure uma função 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ável Obrigatória Descrição
url Sim String 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
token Sim Token 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
ttl Sim Tempo máximo, em segundos, que um usuário pode permanecer no seu site. Exemplo: 180
capacity Sim Número máximo de conexões simultâneas permitidas em seu site. Exemplo: 10

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

:::tip Você pode monitorar a atividade através do painel do Upstash. :::