Use o template Upstash GeoLocation
Upstash GeoLocation permite um gerenciamento e entrega fáceis de mensagens personalizadas, com base na localização geográfica dos usuários finais.
Upstash GeoLocation é uma automação desenvolvida para implantar um banco de dados diretamente na Azion 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 na Azion, selecione o botão abaixo.
ImplantarConfigure 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.
- 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.
Selecione o Git Scope com o qual trabalhar.
- 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.
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_URLna página do banco de dados.
- Acesse o console do Upstash e copie o
- 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_TOKENna página do banco de dados.
- Acesse o console do Upstash e copie o
Selecione o 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:
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.
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.
Para mais informações, consulte Adicione um domínio a um workload.