title | description | meta_tags | namespace | permalink |
---|---|---|---|---|
Como implantar o MongoDB Atlas Boilerplate |
Este template ajuda você a implantar uma aplicação integrada com o MomgoDB Atlas no edge e gerenciá-la via API. |
templates, guides, Azion Marketplace |
docs_guides_mongodb_template |
/documentacao/produtos/guias/mongodb-atlas/ |
import Badge from '~/components/Badge.astro';
PreviewO MongoDB Atlas Boilerplate permite que você implante uma aplicação integrada com o MomgoDB Atlas no edge da 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 Plataforma de Edge da Azion 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.
Antes de usar este template, você precisa:
- Criar uma conta na MongoDB.
- Criar um cluster e adicionar um novo database.
- Criar uma collection para ser usada com este template.
- Ativar o serviço Atlas Data API.
- Gerar a API key no Atlas Service.
- 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.
- Habilitar o Edge Functions e o Application Accelerator na sua conta Azion.
- Para fazer isso:
- Acesse o Azion Console > Account menu.
- Selecione a opção Billing & Subscriptions.
- Clique na aba Subscriptions.
- Ative o switch do módulo.
:::caution[Atenção] Se esses módulos estiverem ativados, a execução deste template poderá gerar custos relacionados ao uso. Consulte a página de preços para obter mais informações.
Qualquer custo gerado pelo uso da MongoDB será processado e cobrado separadamente na plataforma da MongoDB. Visite a documentação da MongoDB para obter mais detalhes. :::
Para obter o MongoDB Atlas Boilerplate, acesse o Azion Console e clique no botão + Create na página inicial.
Isso abrirá um modal onde você pode selecionar Templates > MongoDB Atlas Boilerplate.
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.
- 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.
- Selecione o Git Scope com o qual trabalhar.
- Complete os campos:
- Application Name *: o nome da sua aplicação na Azion.
- 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.
- Atlas API Token *: o token para autorizar a conexão com a AtlasData 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.
- Clique no botão Save 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.
:::note O link para sua edge application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la nas edge locations 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. :::
Ao implantar este template, o script cria:
- Uma edge application para executar seu projeto e gerenciar todas as suas configurações.
- Um domínio da Azion para acessar edge application. Você também pode configurar um domínio personalizado para ser executado nesta aplicação.
- Uma edge 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 Mongo DB Atlas e Atlas Data API, atuando como um middleware para gerenciar e acessar seu banco de dados.
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:
- Acesse o Azion Console.
- 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.
- 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 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.
:::tip Leia a documentação sobre o gerenciamento de edge applications para obter mais detalhes. :::
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.
import Button from '~/components/Button.astro';
import ContributorList from '~/components/ContributorList.astro'
Contribuidores Contributor