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
Seção intitulada Pre-requisitosPara começar a usar esta integração, você precisa:
- Criar uma conta no Upstash.
- Criar um banco de dados global para obter a melhor latência de edge disponível no console do Upstash.
Obtenha a integração
Seção intitulada Obtenha a integracaoPara instalar esta integração:
- Acesse Azion Console > Marketplace.
- Na página inicial do Marketplace, selecione o cartão da Upstash Waiting Room.
- 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.
Configure a integração
Seção intitulada Configure a integracaoDepois de instalar a integração Upstash Waiting Room, você precisará concluir as etapas explicadas abaixo para configurá-la.
Configure uma regra no Edge Firewall
Seção intitulada Configure uma regra no Edge FirewallSiga estes passos:
- No canto superior esquerdo, abra o Products menu e selecione Edge Firewall na seção SECURE.
- Clique no botão Add Rule Set.
- Dê um nome fácil de lembrar ao seu edge firewall.
- Selecione os domínios que deseja proteger com a função.
- Ative a opção Edge Functions na seção Edge Firewall Modules.
- Esta ação dá acesso a edge functions no edge firewall.
- 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 FirewallEnquanto ainda estiver na página do Edge Firewall, selecione a aba Functions e siga estas etapas:
- Clique no botão Add Function.
- Dê um nome fácil de lembrar à sua instância.
- 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.
- Na guia Args, você passará suas credenciais do Upstash e suas variáveis:
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
Seção intitulada Configure uma regra no Rules EnginePara 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:
- Selecione a aba Rules Engine.
- Clique no botão New Rule.
- Dê um nome fácil de lembrar à sua nova regra.
- Selecione um criteria (critério) para executar a integração.
- Exemplo: if
Request URI
starts with./
.
- Exemplo: if
- Abaixo, selecione o behavior Run Function para os criteria.
- Selecione a função Upstash Waiting Room de acordo com o nome que você deu antes.
- Clique no botão Save.
Pronto. Agora a integração Upstash Waiting Room está em execução.