Use o template Upstash GeoLocation

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:

• 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.
• 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.
• O template usa Application Accelerator e Functions. Isso pode gerar custos relacionados ao uso. Consulte a página de preços para mais informações.

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

• O bucket para armazenamento e a 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.

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 Upstash GeoLocation cria uma nova application na Azion e seu domínio. Também cria uma 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:

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

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

3. Encontre a 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 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 ajustar.

Adicione um domínio personalizado

A application criada tem um Azion Workload Domain 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.