--- name: azion-use-o-template-upstash-geolocation description: >- Upstash GeoLocation permite um gerenciamento e entrega fáceis de mensagens personalizadas, com base na localização geográfica dos usuários finais. --- # Use o template Upstash GeoLocation **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](https://console.upstash.com/). - Criar um banco de dados global para obter a melhor latência de edge disponível no [console do Upstash](https://console.upstash.com/). - Ter uma [conta no GitHub](https://github.com/signup) 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](/pt-br/documentacao/plataforma/applications/#application-accelerator) e [Functions](/pt-br/documentacao/plataforma/functions/). Isso pode gerar custos relacionados ao uso. Consulte a [página de preços](/pt-br/documentacao/fundamentos/precos/) para mais informações. > **Atenção** > > Qualquer custo gerado pelo uso do Upstash será processado e cobrado separadamente na plataforma do Upstash. Visite a [documentação do Upstash](https://docs.upstash.com/redis/features/globaldatabase#pricing) para obter mais detalhes. --- ## Implante o template Você pode obter e configurar seu template pelo Azion Console. Para implantá-lo facilmente na Azion, selecione o botão abaixo. [Implantar](https://console.azion.com/create/upstash/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 do GitHub** - Uma janela pop-up será aberta para confirmar a instalação da [Azion GitHub App](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/automacao/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** Selecione o **Git Scope** com o qual trabalhar. 3. **Defina um nome para sua aplicação** - 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. **Informe os dados do Upstash** 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. 5. **Selecione Deploy** 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. > **nota** > > O link para sua application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la na infraestrutura distribuída da Azion. Pode ser necessário aguardar alguns minutos para que a URL seja ativada e para que a página da aplicação seja efetivamente exibida no navegador. ### 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](https://github.com/aziontech/azion-samples/tree/dev/templates/javascript/upstash-geolocation), 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: ```bash 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). --- ## 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** [Acesse o Azion Console](https://console.azion.com). 2. **Selecione Applications** 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. **Selecione sua aplicação** 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. > **dica** > > Leia a documentação sobre o [gerenciamento de applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/) para obter mais detalhes. Para perguntas específicas relacionadas ao Upstash, consulte a [documentação](https://docs.upstash.com/) do Upstash. ### 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](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/).