Vercel é uma plataforma de desenvolvimento que simplifica o sistema de aplicação. A Vercel tem um mercado para desenvolvedores descobrirem pacotes de software e provisionar aplicativos.
A Integração Nativa do MongoDB Atlas com Vercel permite a você:
Provisione os recursos do Atlas diretamente do painel do Vercel, com faturamento gerenciado por meio da sua conta do Vercel.
Acesse recursos no Atlas por meio de uma conta vinculada provisionada.
Implemente clusters MongoDB Atlas para aplicativos Vercel novos e existentes.
Escolha entre clusters MongoDB gratuitos, dedicados e flexíveis, com opções para cada caso de uso.
Após criar os clusters do MongoDB Atlas , o Vercel adiciona suas credenciais do Atlas cluster e outras configurações aos seus ambientes do Vercel.
Encontrar Atlas no Vercel
Se você é um usuário do Vercel com qualquer função, poderá descobrir o Atlas por meio dos seguintes métodos:
Faça login na Vercel IU.
Na aba Overview localize o botão Add new no canto superior direito e na lista suspensa, selecione Integration.
Considerações
Contas no Vercel (Pessoal ou Equipe)
A integração com o Vercel exige que você:
Crie uma nova conta pessoal ou crie uma nova equipe no Vercel.
Use uma conta pessoal ou equipe existente no Vercel.
Projetos na Vercel
Você pode vincular um Atlas cluster a mais de um projeto no Vercel.
Se você criar uma Integração Nativa do Atlas no Vercel, o Atlas criará uma nova organização e projeto gerenciados pelo Vercel no Atlas para você.
Listas de acesso IP no Atlas e listas de permissão IP no Vercel
Os sistemas da Vercel usam endereços IP dinâmicos.
Para se conectar a um cluster Atlas, alista de acesso IP do seu cluster Atlas deve permitir todos os endereços IP (0.0.0.0/0). Se o Atlas não encontrar uma entrada para 0.0.0.0/0 na lista de acesso IP do seu projeto Atlas, o Atlas a adicionará em seu nome, como parte do fluxo de trabalho de integração.
Observação
Se você adicionar o CIDR 0.0.0.0/0 a uma lista de acesso ao projeto, o Atlas enviará um e-mail de alerta para todos os usuários que receberam uma função diretamente no projeto ou receberam uma função indiretamente por meio da associação da equipe (se a equipe receber uma função no projeto).
O Atlas cria um usuário de banco de dados no seguinte formato: Vercel-Admin-[name of resource] no banco de dados admin e concede a função de banco de dados interna readWriteAnyDatabase MongoDB a todos os bancos de dados que não são do sistema no Atlas cluster. Por exemplo, se o recurso do Vercel for my-first-atlas-cluster denominado, o usuário de banco de dados que o Atlas criará Vercel-Admin-my-first-atlas-cluster será.
Integração nativa do Vercel
Para integrar com o Vercel, localize o MongoDB Atlas no Vercel Marketplace e crie uma nova conta do MongoDB Atlas com faturamento realizado pelo Vercel. Uma integração nativa do MongoDB Atlas no Vercel permite a você:
Provisione os recursos do Atlas diretamente do painel do Vercel e gerencie o faturamento por meio da sua conta do Vercel. Você também pode acessar diretamente os recursos no Atlas por meio de uma conta vinculada provisionada.
Implemente clusters MongoDB Atlas para aplicativos Vercel novos e existentes.
Após criar os clusters do MongoDB Atlas , o Vercel adiciona suas credenciais do Atlas cluster e outras configurações aos seus ambientes do Vercel.
O Atlas provisiona a conta para você se você não tiver uma. A conta do Atlas está vinculada à instalação do Vercel. Você tem credenciais separadas para entrar no Atlas.
Considerações: integração nativa
As seguintes considerações se aplicam à Integração Nativa do Atlas no Vercel.
Mapeamento de recursos
Uma " instalação de equipe " no Vercel mapeia uma organização no Atlas. Um produto instalado (recurso) no Vercel mapeia para um projeto e cluster no Atlas.
Acesso à API
A Vercel requer acesso programático às APIs do Atlas para criar e gerenciar recursos em nome dos usuários e propagar mudanças ambientais.
Provisionamento de usuários e vinculação de contas
O Atlas provisiona novas contas de usuário do Atlas para usuários do Vercel, vincula contas existentes e envia um e-mail de redefinição de senha se você não configurar as credenciais do Atlas . A autenticação do usuário requer credenciais do Atlas para acessar o Atlas.
O usuário que instala inicialmente a Integração Nativa do Atlas para a equipe Vercel se torna o Atlas
Organization Owner.Acessando |service| da Vercel
Você pode navegar até a UI do Atlas a partir de Vercel por meio de um botão Open in Atlas. Depois de fazer login com suas credenciais do Atlas , o Atlas redirecionará você para o recurso Atlas correspondente.
Usuários com contas Atlas existentes. Ao acessar o Atlas a partir do Vercel, o Vercel solicita aos usuários com contas Atlas existentes que confirmem a vinculação de sua conta Atlas à instalação do Vercel. Depois que os usuários confirmam a vinculação e fazem login com as credenciais do Atlas para provar sua identidade, o Atlas vincula as contas Atlas dos usuários à instalação do Vercel.
Novos usuários. O Atlas provisiona uma conta para novos usuários e envia um e-mail de redefinição de senha para que os usuários possam configurar suas senhas e provar sua identidade. Depois de obter as credenciais do usuário, o Atlas Atlas a conta Atlas do usuário à instalação do Vercel e concede a esse usuário a função
Organization Ownerno Atlas. O Atlas mantém as permissões da organização alinhadas com as permissões no Vercel. As funções "Admin" e "Usuário" do Vercel são mapeadas para as funçõesOrganization OwnereOrganization Read Onlyno Atlas, respectivamente.
Se algum usuário da equipe do Vercel instalar Atlas clusters adicionais usando a integração nativa, o Atlas não adicionará automaticamente esses usuários à organização Atlas criada para a equipe do Vercel. O proprietário da organização Atlas deve garantir que todos os usuários da equipe Vercel que precisam de acesso à organização Atlas o tenham. Isso também se aplica a novos usuários da equipe Vercel que ingressam na equipe Vercel após a instalação inicial da Integração Nativa.
Use um dos seguintes métodos para garantir que o Atlas adicione mais usuários da equipe Vercel à Atlas Organization:
Os usuários da equipe do Vercel podem acessar a organização Atlas na UI do Atlas por meio da UI do Vercel. se ainda não forem usuários do Atlas , o Atlas provisionará contas para eles, com atribuição à organização Atlas para a Integração Nativa.
O proprietário da Organização Atlas pode convidar usuários do Atlas para a Organização Atlas .
Variáveis de ambiente
A integração nativa configura automaticamente a variável de ambiente do
MONGODB_URIpara conexões de banco de dados seguras. Para obter a lista completa de variáveis de ambiente, consulte a UI do Vercel para a Integração Nativa do Atlas.Cobrança
A Integração Nativa do Vercel cria uma nova Organização Atlas a partir da UI do Vercel, que é automaticamente conectada a um plano de faturamento do Vercel Marketplace como o método de pagamento ativo para a Organização Atlas . O Faturamento ocorre por uma organização Atlas e inclui uma fatura coletiva para todos os clusters e serviços do MongoDB Atlas na Organização. Em Vercel e Atlas, você pode visualizar uma confirmação do faturamento do Vercel Marketplace para a Organização Atlas , bem como os custos de uso diário.
Segurança
O Atlas garante conexões seguras por meio da autenticação SCRAM com listas de permissões de IP para os Atlas clusters que você cria por meio da Integração Nativa no Vercel.
Exclusão ou desinstalação da integração nativa
Após desinstalar uma integração com o Vercel, recomendamos que o proprietário da Atlas Organization garanta que as atribuições de acesso e os métodos de cobrança estejam atualizados e remova o acesso obsoleto ou indesejado para evitar alertas automatizados do MongoDB sobre pagamentos de cobrança atrasados. O Atlas envia uma fatura final do Vercel para o Atlas para a Vercel e remove o método de pagamento do Vercel Marketplace da Organização Atlas .
Esta fatura não é uma fatura final do Atlas , pois ainda pode haver cobranças adicionais incorridas pela Organização após a desinstalação do uso mais recente que pode não ter sido cobrada ainda. Você é responsável por adicionar um novo método de pagamento à Organização para garantir que qualquer uso pendente possa ser pago.
Você não pode desinstalar ou desvincular a integração nativa da UI do Atlas , embora você sempre possa excluir seus recursos no Atlas. Se você excluir um cluster vinculado ao Vercel, isso se refletirá na UI do Vercel.
Introdução à UI do Vercel para Next.js
A UI do Vercel para a Integração Nativa inclui instruções para começar a usar o Next.js e o Atlas.
Modelos de sistemas
A UI do Vercel para a Integração Nativa inclui modelos de sistemas. Esses modelos incluem código de exemplo e arquivos de configuração para ajudá-lo a começar com seus projetos Atlas no Vercel.
Adicionar uma integração nativa
Para adicionar a integração nativa do MongoDB Atlas no Vercel:
Instale a integração nativa do MongoDB Atlas .
Vá para o Vercel Marketplace e use a pesquisa ou o filtro de categoria do lado esquerdo para Storage localizar MongoDB Atlas na lista de integrações nativas.
Clique em Install na página do MongoDB Atlas para a integração ou clique em Install no canto superior direito da página da UI do Vercel para a integração.
Escolha uma camada do cluster.
Escolha um Atlas cluster gratuito, flexível ou dedicado:
Grátis ($0, Armazenamento: 512 MB, RAM: Compartilhada, vCPU: Compartilhada)
Flex (US$0.011/hora, Armazenamento: até 5 GB, RAM: compartilhada, vCPU: compartilhada)
Dedicado (US$0.08/hora, Armazenamento: 10 GB, RAM: 2 GB, vCPU: 2xCPUs)
Importante
Clusters gratuitos estão disponíveis em todos os planos de instalação. Os clusters flexíveis e dedicados estão disponíveis apenas em planos de instalação pagos.
Escolha uma região de cluster.
Uma lista de regiões do Vercel é exibida. Estas regiões mapeiam para regiões do MongoDB Atlas na maioria dos casos. Se você escolher uma região do Vercel que não tenha uma região do Atlas correspondente, o Atlas escolherá a região mais próxima da região do Vercel que você selecionou.
Selecione um plano de instalação: Gratuito ou Pago.
Plano gratuito $0
Não é necessário cartão de crédito. Você só pode criar clusters MongoDB Atlas gratuitos com este plano.
Plano pago
O cartão de crédito é necessário. Você pode criar clusters gratuitos, flexíveis e dedicados com este plano. Você só será cobrado por clusters flexíveis e dedicados.
Se você escolher um Atlas cluster Flex ou Dedicado, o plano Grátis ficará acinzentado. Se algum membro da sua equipe do Vercel usar essa Integração Nativa com um plano Gratuito e optar por criar um cluster Flex ou Dedicado, o plano mudará para um plano Pago. Mesmo que você desinstalar um cluster do MongoDB Atlas que não é gratuito, o plano permanecerá como um plano Pago. Para alterar o plano para um plano Gratuito, desinstale a Integração Nativa e instale-a novamente escolhendo um cluster Gratuito e um plano Gratuito. Para saber como desinstalar qualquer integração nativa, consulte a documentação do Vercel.
Agora você pode utilizar a Integração Nativa do Atlas no Vercel para:
Conecte-se a um projeto do Vercel.
Puxe suas variáveis de ambiente mais recentes.
Se você não precisar mais desse cluster do MongoDB Atlas , poderá desinstalar a integração nativa e, com isso, excluir um banco de dados do MongoDB Atlas . Para obter instruções, consulte a documentação do Vercel.
Você também pode excluir o banco de dados (o recurso), sem desinstalar toda a integração. Isso é útil se você quiser manter a integração para criar outros recursos no futuro, ou se tiver outros recursos na mesma integração.
Se você excluir um Atlas cluster vinculado ao Vercel, todos os projetos que você vinculou a esse cluster no Vercel não terão mais acesso a esse cluster de banco de dados . Antes de prosseguir com a desinstalação e exclusão do Atlas cluster, certifique-se de que este Atlas cluster não esteja mais em uso por nenhum projeto ou aplicação.
Entre em contato com o suporte
Se você tiver problemas ao usar uma integração nativa do Vercel com o MongoDB Atlas, entre em contato com o suporte de integração do Vercel em MongoDB vercel-integration-support@mongodb.com.
Desconectar uma integração do Vercel
Antes de desconectar os projetos do Vercel dos Atlas clusters, para evitar tempo de inatividade para quaisquer aplicativos conectados aos mesmos clusters do Atlas, verifique se os usuários do cluster e as regras de acesso à rede não compartilham outros projetos e aplicativos conectados a esse Atlas cluster.
Clique em para desinstalar ou remover a integração.
Siga as instruções da interface do usuário do Vercel para desinstalar a integração. Para obter instruções detalhadas, consulte a documentação do Vercel.
Confirme que você deseja desconectar esta integração do Vercel.
A desconexão da integração pode resultar em tempo de inatividade para seus aplicativos Vercel e quaisquer outros aplicativos que se conectem aos Atlas clusters que você vinculou ao Vercel.
Após desinstalar uma integração com o Vercel, recomendamos que o Atlas Organization Owner garanta que as atribuições de acesso e os métodos de cobrança estejam atualizados e remova o acesso obsoleto ou indesejado para evitar avisos automatizados do MongoDB sobre pagamentos de cobrança atrasados.
O Atlas envia uma fatura final do Vercel para a integração do Atlas Vercel ao Vercel e remove o método de pagamento do Vercel Marketplace da Organização Atlas .
Esta fatura não é uma fatura final do Atlas , pois ainda pode haver cobranças adicionais incorridas pela organização após a desinstalação do uso mais recente que pode não ter sido cobrada ainda. Você é responsável por adicionar uma nova forma de pagamento à organização para garantir que qualquer uso pendente possa ser pago.