Migrar hospedagem estática para Netlify
Nesta página
- Antes de começar
- Interface do usuário da Netlify
- Importar de um repositório Git
- Implantar arquivos locais
- CLI da Netlify
- Configurar a CLI Netlify
- Conecte-se à Netlify
- Implementar manualmente com a CLI
- Configurar o sistema contínuo
- Encerrar a hospedagem do Atlas App Services
- Próximos passos
- 404 Página e Redirecionamentos
- Atualizar registros DNS
- Saiba mais sobre como a Netlify gerencia o cache de CDN
- Convide sua equipe
Importante
Consulte sempre a documentação oficial do MongoDB Atlas e da Netlify para obter as informações mais atualizadas e precisas. Etapas específicas podem variar dependendo dos detalhes do seu projeto e das tecnologias utilizadas.
A Netlify é adequada para hospedar sites estáticos e aplicativos de página única (SPAs) e, portanto, será compatível com seu Atlas App Services existente.
A Netlify oferece métodos diferentes para implantar seus sites estáticos, dependendo de suas necessidades. Conectar o CI/CD da Netlify ao seu repositório Git é o ideal, mas você também pode implantar usando CLI, API ou até mesmo arrastar e soltar. Abaixo está uma visão geral dos métodos que podem ser mais úteis para desenvolvedores que usam atualmente o alojamento MongoDB Atlas . Consulte a documentação completa da Netlify sobre como adicionar um novo site para explorar todas as opções em detalhes.
Antes de começar
Como precaução, certifique-se de ter um backup do seu aplicativo e dos dados antes de fazer alterações significativas.
Um repositório git com o código do seu website. O CI/CD da Netlify se integra perfeitamente a muitos fornecedores Git populares . Mesmo que você não esteja usando o CI/CD da Netlify, é altamente recomendável usar um sistema de controle de versão.
Uma conta Netlify. A criação de uma nova conta Netlify é gratuita e o fluxo de inscrição deve, opcionalmente, orientá-lo durante o processo a seguir. A camada grátis deve cobrir seus requisitos de hospedagem ao migrar da hospedagem do MongoDB Atlas. Se você precisar de mais serviços e recursos, consulte os planos Pro e Enterprise da Netlify.
Interface do usuário da Netlify
Você pode usar a interface do usuário da Netlify para criar e gerenciar projetos.
Importar de um repositório Git
Você pode importar um projeto existente de um repositório Git e implantá-lo no Netlify. Quando você importa seu repositório de projeto existente, a implementação contínua da Netlify atualizará automaticamente seu site cada vez que você enviar alterações. Para configurar usando a Netlify CLI, consulte a seção Netlify CLI nesta página.
Para criar um novo site a partir de um repositório Git usando a UI da Netlify:
Go para a página "Site" da equipe da Netlify, abra o menu "Adicionar novo site" e selecione "Importar um projeto existente".
Selecione o provedor Git onde seu projeto está hospedado.
Selecione o repositório existente do seu projeto.
Ajuste o site e construa as configurações.
Implantar arquivos locais
Se você tiver um projeto existente em seu computador local que não esteja vinculado a um repositório Git, poderá implantar manualmente seu site usando a zona de distribuição suspensa da Netlify.
Go a página “Site” da sua equipe, abra o menu “Adicionar novo site” e selecione “Implantar manualmente”. Arraste e solte a pasta de saída do seu site para a zona de implantação para implantar seu site.
CLI da Netlify
A interface de linha de comando (CLI) da Netlify permite configurar o sistema contínuo diretamente da linha de comando. Você pode usar a Netlify CLI para executar um servidor de desenvolvimento local que você pode compartilhar com outras pessoas, execute uma construção local e plug-ins e implemente seu site manualmente.
Observação
As instruções a seguir são abreviadas para que você comece a migrar da hospedagem do MongoDB Atlas. Para configuração avançada, consulte a documentação completa da Netlify para começar a usar a Netlify CLI.
Conecte-se à Netlify
A Netlify CLI usa um token de acesso para se autenticar com a Netlify. Para autenticar e obter um token de acesso usando a linha de comando, digite o seguinte comando em qualquer diretório:
netlify login
Isso abrirá uma janela do navegador solicitando que você faça login com a Netlify e conceda acesso à Netlify CLI.
Implementar manualmente com a CLI
Para distribuir seu aplicativo manualmente, sem o sistema contínuo, execute o seguinte comando no diretório do projeto:
netlify deploy
Na primeira vez que você executar o comando, a Netlify CLI solicitará que você selecione um site existente ou crie um novo, vinculando o site para todos os sistemas futuros.
Configurar o sistema contínuo
Para repositórios armazenados no GitHub.com, você pode usar o Netlify CLI para conectar seu repositório executando o seguinte comando em seu repositório local:
netlify init
A Netlify CLI precisará de acesso para criar uma chave de sistema e um webhook no repositório. Ao executar o comando acima, você será solicitado a fazer login na sua conta do Github , que criará um token de acesso em nível de conta. O token de acesso será armazenado no Netlify CLI config.json. Sua senha de acesso nunca será armazenada.
Encerrar a hospedagem do Atlas App Services
Depois de verificar se o seu aplicativo foi implementado com sucesso na Netlify, exclua os arquivos hospedados do aplicativo Atlas App Services. Lembre-se de que a hospedagem de domínios no Atlas App Services não será mais executada a partir de 12 de março de 2025.
Próximos passos
Se precisar de suporte adicional para os serviços da Netlify, entre em contato com a equipe de suporte.
404 Página e Redirecionamentos
Você pode configurar uma página 404 personalizada para todos os caminhos que não resolvem para um arquivo estático. Isso não requer nenhuma regra de redirecionamento. Se você adicionar uma página 404.html ao seu site, ela será escolhida e exibida automaticamente para qualquer caminho com falha.
As regras de redirecionamento da Netlify aceitam várias opções para personalizar a forma como os caminhos são correspondidos e redirecionados usando a sintaxe do arquivo _redirects (consulte exemplos).
Atualizar registros DNS
Se o seu domínio estiver atualmente apontado para o MongoDB Atlas e você quiser usar o mesmo domínio com a Netlify, atualize seus registros DNS para apontarem para a Netlify. Consulte a documentação da Netlify sobre como configurar o DNS externo.
Saiba mais sobre como a Netlify gerencia o cache de CDN
As respostas de ativos estáticos na Netlify são armazenadas em cache nos nós de borda globais da Netlify e automaticamente invalidadas sempre que um sistema altera o conteúdo. As respostas de ativos estáticos só podem ser alteradas com novas implementações. Para um controle mais avançado do cache, consulte a documentação da Netlify sobre infraestrutura global de cache.
Convide sua equipe
Se você precisar adicionar alguém à equipe, poderá configurar controles de acesso baseados em funções que permitem que o administrador assuma o controle e conceda acesso aos membros da equipe. Consulte a documentação da Netlify sobre gerenciamento de equipes.