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:
- 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
Para 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 Install.
Você verá uma mensagem indicando que sua integração foi instalada com sucesso.
- Acesse Real-Time Manager (RTM) > 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
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:
- No canto superior esquerdo, abra o Products menu e selecione Edge Firewall na seção Secure.
- Clique no botão + Edge Firewall.
- 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.
- 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
Enquanto ainda estiver na página do Edge Firewall:
- Selecione a aba Functions Instances e siga estas etapas:
- Clique no botão + Function Instance.
- Dê um nome fácil de lembrar à sua instância.
- No menu suspenso, selecione a função da Upstash Waiting Room.
- Na caixa Arguments, 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 |
- Clique no botão Save.
- 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:
{ "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 |
- 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:
- Selecione a aba Rules Engine.
- Clique no botão + Rule Engine.
- 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.
- 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.