--- name: azion-como-implantar-o-mongodb-atlas-boilerplate description: >- Este template ajuda você a implantar uma aplicação integrada com o MongoDB Atlas na Azion e gerenciá-la via API. --- # Como implantar o MongoDB Atlas Boilerplate O **MongoDB Atlas Boilerplate** permite que você implante uma aplicação integrada com o MongoDB Atlas na Azion. Além disso, devido à integração com a Atlas Data API, você pode criar, recuperar, atualizar e excluir itens em suas coleções por meio de requisições HTTPS padrão. Ao usar a **Azion Web Platform** para executar seu banco de dados, seus dados e ativos digitais se beneficiam das capacidades de edge computing, incluindo entrega mais rápida, menor latência e segurança aprimorada. --- ## Pré-requisitos Antes de usar este template, você precisa: - Criar uma [conta na MongoDB](https://www.mongodb.com/cloud/atlas/register). - Criar um [cluster](https://www.mongodb.com/docs/atlas/create-database-deployment/) e adicionar um novo *database*. - Criar uma *collection* para ser usada com este template. - Ativar o serviço [Atlas Data API](https://www.mongodb.com/docs/atlas/app-services/data-api/). - Gerar a API key no [Atlas Service](https://www.mongodb.com/docs/atlas/app-services/authentication/api-key/#std-label-api-key-authentication). - 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 da MongoDB será processado e cobrado separadamente na plataforma da MongoDB. Visite a [documentação da MongoDB](https://www.mongodb.com/docs/atlas/) 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/mongodb-atlas/mongodb-atlas) --- ## 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. **Preencha os campos** - **Application Name** \*: o nome da sua aplicação na Azion. - 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. - **Atlas API Token** \*: o token para autorizar a conexão com a Atlas Data API. - **Atlas API URL** \*: a URL do endpoint atribuído para conectar com a Atlas Data API. - **Collection Name** \*: o nome da *collection* criada no *database* especificado. - **Database Name** \*: o nome do *database* criado na *data source* da MongoDB Atlas. - **dataSource Name** \*: o nome da *data source* ou cluster criada na MongoDB Atlas. 4. **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 Ao implantar este template, o script cria: - Uma application para executar seu projeto e gerenciar todas as suas configurações. - Um domínio da Azion para acessar application. Você também pode configurar um domínio personalizado para ser executado nesta aplicação. - Uma function contendo lógica personalizada. - Um repositório no GitHub para o seu projeto. O repositório inclui uma GitHub Action que, ao ser ativada, garante um fluxo de trabalho de implantação contínua. A execução deste template também inclui integração com o MongoDB Atlas e Atlas Data API, atuando como um middleware para gerenciar e acessar seu banco de dados. --- ## Gerencie o template 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. Para gerenciar e editar as configurações da sua aplicação, siga estas etapas: 1. **Acesse 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 application** Encontre a aplicação 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. ### 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/).