Como implantar o template Upstash Rate Limit através da Azion

O template Upstash Rate Limit ajuda você a implementar rate limiting em um ambiente serverless, sem a necessidade de uma extensa configuração manual. Este template inclui configurações para limiting requests e window limit.

Funciona em conjunto com o Azion Edge Functions, sendo possível ajustar a configuração inicial com base nos args. Além disso, este template cria um novo repositório do GitHub que permite um fluxo de trabalho de implantação contínua, ou continuous deployment. Desta forma, você pode configurar e personalizar ainda mais a configuração para atender às suas necessidades, obtendo fácil gerenciamento e entrega de seu conteúdo personalizado.

Pré-requisitos

Para começar a usar este template, você precisa:

• Criar uma conta Upstash.
• Criar um banco de dados global com a melhor latência de edge disponível no Upstash Console.
• Ter uma conta no GitHub para conectar com a Azion e criar seu novo repositório.
  • Cada push será implantado automaticamente neste repositório para manter seu projeto atualizado.
• Habilitar o Edge Functions na sua conta Azion.
  • Para fazer isso:

1. Acesse o Azion Console > Account menu.
2. Selecione a opção Billing & Subscriptions.
3. Clique na aba Subscriptions.
4. Ative o switch do módulo.

Implante o template

Você pode obter e configurar seu template pelo Azion Console. Para implantá-lo facilmente no edge, clique no botão abaixo.

Configure o template

No formulário de configuração, forneça as informações para configurar sua aplicação. Preencha os campos apresentados.

Os campos identificados com asterisco são obrigatórios.

1. Conecte a Azion com sua conta no GitHub.

• Uma janela pop-up será aberta para confirmar a instalação da Azion GitHub App, uma ferramenta que conecta sua conta do GitHub com a plataforma da Azion.
• Defina suas permissões e acesso ao repositório conforme desejado.

2. Selecione o Git Scope com o qual trabalhar.
3. Defina um nome para sua edge application.

• O bucket para armazenamento e a edge function usarão o mesmo nome.
• Use um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro.

4. Complete os campos:

• Upstash Redis Rest URL *: a URL para acessar seu banco de dados Upstash usando REST.
  • Acesse o console do Upstash e copie o UPSTASH_REDIS_REST_URL na página do banco de dados.
• Upstash Redis Rest Token *: o token para autorizar o acesso ao seu banco de dados Upstash usando REST.
  • Acesse o console do Upstash e copie o UPSTASH_REDIS_REST_TOKEN na página do banco de dados.
• Request Limit: o número máximo de solicitações. Exemplo: 6.
• Window Limit: a janela de tempo para novas solicitações. Exemplo: 10 s (pode ser: “ms” | “s” | “m” | “h” | “d”).

4. Clique no botão Deploy para iniciar o processo de implantação.

Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada.

Principais configurações

O template Upstash Rate Limit cria uma nova edge application e seu domínio na Azion. Ele também cria uma edge function, para fornecer os argumentos do rate limiting, e um novo repositório em sua conta do GitHub com base em um template público que inclui uma GitHUb action para facilitar um continuous depployment.

Nesta função, as bibliotecas upstash/redis e upstash/ratelimit são integradas, conectando-se ao seu Banco de Dados Global Upstash e verificando na rota/login se está dentro dos Window e Limit configurados. A chave para os limites são os metadados ["remote_addr"].

Gerencie seu projeto

Considerando que a configuração inicial pode não ser ideal para o seu aplicativo web específico, todas as configurações podem ser personalizadas sempre que você precisar usando o Azion Console. Depois que o modelo for implantado, você também terá controle total sobre a personalização de sua conta e banco de dados do Upstash.

Para gerenciar e editar as configurações da sua edge application no Azion, siga estas etapas:

1. Acesse o Azion Console.
2. No canto superior esquerdo, selecione Products menu > Edge Application.

• Você será redirecionado para a página de Edge Application. Ela lista todas as edge applications que você criou.

3. Encontre a aplicação pelo nome que você definiu durante a execução do template e selecione-a.

• A lista é organizada em ordem alfabética. Você também pode usar a barra de busca localizada no canto superior esquerdo da lista; atualmente, ela é filtrada apenas pelo Application Name, ou nome da edge application.

Depois de selecionar a edge application em que você trabalhará, você será direcionado para uma página que contém todas as configurações que você pode configurar.

Adicione um domínio personalizado

A edge application criada durante a implantação tem um domínio Azion atribuído para torná-la acessível através do navegador. O domínio tem o seguinte formato: xxxxxxxxxx.map.azionedge.net/. No entanto, você pode adicionar um domínio personalizado para que os usuários acessem sua edge application por meio dele.