Como usar o template Upstash GeoLocation através da Azion

Upstash GeoLocation é uma automação desenvolvida para implantar um banco de dados diretamente no edge enquanto permite a configuração de mensagens personalizadas que serão entregues de acordo com a localização geográfica do usuário.

Essas mensagens são entregues por meio de uma interface estática, baseada em HTML e gerada pelo template após a implantação.

Pré-requisitos

Antes de usar este template, você precisa:

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

Obtenha o template

Para obter o template, acesse o Azion Console e clique no botão + Create na página inicial.

Isso abrirá um modal onde você pode selecionar Templates > Upstash GeoLocation.

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.
  1. Selecione o Git Scope com o qual trabalhar.
  2. 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.
  1. 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.
  1. 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 Upstash GeoLocation cria uma nova edge application na Azion e seu domínio. Também cria uma edge function para fornecer os argumentos para o template, incluindo os argumentos para a geolocalização, um novo repositório em sua conta no GitHub com base em um template público, que inclui uma GitHub Action para facilitar o continuous deployment, e uma interface estática para exibir as mensagens.

Nesta função, a biblioteca upstash/redis é integrada, conectando-se ao seu banco de dados global no Upstash e recuperando a mensagem com base na localização do usuário. Esta localização é retirada dos metadados ["geoip_country_code"].

O template também incorpora em seu banco de dados mensagens baseadas na localização, que são recuperadas da integração com o Upstash, semelhante a este exemplo:

Terminal window
Welcome to Upstash CLI


set BR "Olá, tudo bem!"
OK
set GB "Ey up?"
OK
set US "Yo, what’s up?"
OK
set IN "Namaste"
OK

Você pode personalizar essas mensagens em seu banco de dados do Upstash para atender às suas necessidades.

Para saber como editar e personalizar as configurações de seu projeto, vá para a seção Gerenciar seu projeto na Azion.

Gerencie seu projeto na Azion

Considerando que essa configuração inicial pode não ser ideal para sua aplicação, todas as configurações podem ser personalizadas sempre que você precisar usando o Azion Console. Depois que o template 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 aplicação, 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.
  1. Encontre a edge application relacionada ao 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 aplicação 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 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 aplicação por meio dele.

Consulte o guia para configurar domínios

Contribuidores