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 os recursos do Atlas do Vercel por meio de um fluxo de login nativo, com o Atlas criando ou vinculando a conta Atlas necessária para você.
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:
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, a lista de acesso IP do 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 a qualquer lista de acesso do projeto qualquer CIDR IPv4 /0, como 0.0.0.0/0 ou 10.0.0.0/0, o Atlas enviará um e-mail de alerta a todos os usuários que receberam uma função diretamente no projeto ou indiretamente uma função por meio de associação da equipe (se a equipe receber uma função no projeto).
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 integrada 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 denominado my-first-atlas-cluster, o usuário de banco de dados que o Atlas criará será Vercel-Admin-my-first-atlas-cluster.
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, vinculação de contas e logon único
Use Open in MongoDB Atlas na IU do Vercel para acessar a organização, o projeto ou o cluster do Atlas associado ao seu recurso gerenciado pelo Vercel. Se você ainda não tiver uma conta do Atlas, o Atlas provisionará uma nova conta do Atlas quando você abrir o Atlas no Vercel. Você não precisa criar credenciais separadas do Atlas para acessar seus recursos do Atlas gerenciados pelo Vercel.
Se você já tiver uma conta Atlas que usa um nome de usuário e senha, o Atlas solicitará pela primeira vez que você vincule sua conta Atlas ao Vercel. Depois de vincular sua conta, você pode continuar a fazer login diretamente no Atlas com suas credenciais Atlas existentes ou retornar ao Atlas do Vercel com Open in MongoDB Atlas. Na maioria dos casos, os usuários podem fazer login no Atlas usando suas credenciais Vercel (SSO). No entanto, os usuários Atlas existentes que se conectam com o Google ou Github, e os usuários cujas organizações configuraram o SSO corporativo, devem continuar a acessar o Atlas com seu método de login Atlas existente por meio da página de login da conta Atlas.
O usuário que instala inicialmente a Integração Nativa do Atlas para a equipe Vercel se torna o Atlas
Organization Owner.Acessando o Atlas da Vercel
Você pode navegar para a IU do Atlas a partir do Vercel por meio de um botão Open in MongoDB Atlas.
Usuários com contas Atlas existentes. Ao acessar o Atlas do Vercel, o Vercel solicita aos usuários com contas Atlas existentes que vinculem sua conta Atlas à instalação do Vercel. Após a confirmação, os usuários podem fazer login no Atlas com suas credenciais Vercel (SSO) ou continuar com suas credenciais Atlas.
Os usuários existentes do Atlas que fazem login no Atlas com Google, Github ou SSO corporativo não podem usar suas credenciais do Vercel para fazer login.
Novos usuários. Quando um novo usuário clica em Open in Atlas, o Atlas provisiona uma conta e usa suas credenciais do Vercel para fazer login. O Atlas vincula a conta do 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 IU 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.