Integração com o Vercel
Nesta página
A Data API do Atlas App Services foi descontinuada. Ela chegará ao fim da vida útil e será removida em 30 de setembro de 2025. Consulte a página de descontinuação na documentação do App Services para obter detalhes.
Você pode conectar seus clusters do Atlas a aplicativos que você implanta usando o Vercel.
Use esta página para concluir as seguintes tarefas:
Conecte usuários e equipes da Vercel às organizações no Atlas.
Crie links de projetos do Vercel para esses usuários e equipes para Atlas clusters.
Habilite a Atlas Data API.
Para conectar as funções sem servidor implantadas no Vercel a clusters do Atlas, você também pode usar o driver do MongoDB Node.js ou a biblioteca ODM do Mongoose.
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.
Observação
Você pode adicionar uma integração do Vercel como um usuário de conta pessoal e adicionar outra integração do Vercel como um usuário de equipe. Você não pode alterar o escopo de uma integração existente de uma conta pessoal para uma conta de nível de equipe no Vercel.
Para mudar de uma integração MongoDB para uma conta pessoal do Vercel para uma integração com um escopo de equipe na mesma organização Atlas, desconecte uma integração existente no Atlas e adicione uma nova integração com um escopo de equipe.
Projetos na Vercel
Você pode vincular um cluster do Atlas a mais de um projeto no Vercel.
Para configurar a integração, você deve ter um ou mais projetos em sua conta pessoal ou equipe do Vercel.
A lista de projetos do Vercel que você pode escolher para a integração depende do escopo do usuário ou da equipe.
Listas de acesso IP no Atlas e listas de permissão IP no Vercel
Implantações 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.
Quando você configura a integração, o Atlas executa estas ações para proteger suas conexões do Vercel para o cluster:
Cria uma variável de ambiente
MONGODB_URIque serve como a cadeia de conexão do agrupamento do Atlas para todos os projetos do Vercel aos quais você vincula este cluster.Quando seu aplicativo não especifica um banco de dados, a variável
MONGODB_URIutiliza/myFirstDatabasecomo o nome do banco de dados padrão. Substitua esse nome pelo nome do banco de dados ou, se você usar uma biblioteca para fazer interface com o MongoDB, verifique se o código do aplicativo especifica o nome do banco de dados.Cria um usuário de banco de dados,
vercel-admin-user, no banco de dados admin e concede a função de banco de dados interna readWriteAnyDatabase MongoDB a todos os outros bancos de dados que não são do sistema no cluster.
Adicionar uma integração da Vercel
Esse procedimento permite a você criar uma nova conta no Atlas com sua organização, projeto e função de usuário, e então criar um novo cluster, ou utilizar uma conta do Atlas existente, organização, projeto e cluster do Atlas para integração com o Vercel.
Para integrar os aplicativos do Vercel aos clusters do Atlas, você começa na IU do Vercel.
Navegue até a integração do Atlas MongoDB.
Vá até Integração do Atlas do MongoDB no Vercel e clique em Add integration.
Escolha o escopo da sua integração (usuário ou equipe).
Escolha um dos escopos do Vercel no menu suspenso:
Personal Account
Team
Depois de definir o escopo de sua integração, você não poderá alterá-lo. Para mudar para um escopo diferente do escopo escolhido, desconecte uma integração e crie outra usando este procedimento.
Clique em Continue.
Selecione projetos do Vercel para vincular a Atlas cluster.
Você pode escolher projetos específicos ou todos os projetos. Posteriormente, você pode editar a integração para alterar os projetos. A lista de projeto depende do escopo do usuário ou da equipe que você especificou na etapa anterior.
Selecione uma das seguintes opções:
All Projects
Specific Projects
Crie sua conta MongoDB, se ainda não tiver uma.
Escolha uma das seguintes opções:
Se você estiver usando suas Contas do Google, siga as etapas para fazer login ou crie uma nova conta do Google.
Se você estiver usando seu e-mail, ele já está preenchido e esmaecido.
Se sua empresa usa autenticação federada, use o endereço de e-mail da empresa. Continue com as etapas de verificação necessárias para seu acesso de usuário federado.
Se você já tiver uma conta do Atlas, clique em Log in now. Consulte Iniciar sessão na sua conta do Atlas.
Insira seu nome e sobrenome e escolha uma senha. Uma senha deve conter pelo menos 8 caracteres, incluindo caracteres, números ou símbolos únicos e não conter seu endereço de e-mail. Consulte Registrar uma nova conta do Atlas.
Clique na caixa de seleção I accept the Privacy Policy and the Terms of Service.
Leia os Termos de Serviço e a Política de Privacidade.
Selecione uma organização do Atlas para integrar com o Vercel.
Selecione uma organização Atlas no menu suspenso ou crie uma nova organização Atlas.
Clique em Continue.
Confirme o acesso à sua organização Atlas.
O Atlas cria uma organização para você. Clique em I Acknowledge para confirmar que você concede acesso ao Vercel à sua organização Atlas.
Para remover o acesso desta integração do Vercel à sua organização MongoDB Atlas, você deve desconectar esta integração.
Selecione um projeto do Atlas para integrar com o Vercel a partir da lista suspensa ou crie um novo projeto.
(Opcional). Ative o botão Enable the Atlas Data API. Habilitar a Atlas Data API permite que você use HTTPS para se conectar aos bancos de dados do Atlas nessa organização.
Crie um novo cluster de camada grátis ou vincule um cluster existente a um ou mais projetos do Vercel.
Se já tiver uma conta do Atlas, você poderá escolher uma organização e um projeto e depois escolher um cluster existente.
Confirme se você tem o role Project Owner do Atlas.
Escolha um Atlas cluster no menu suspenso no lado esquerdo do mapeamento.
Escolha um ou mais projetos Vercel no menu suspenso à direita. Você pode mapear um cluster do Atlas para um ou mais projetos Vercel. O menu suspenso mostra um projeto ou todos os projetos, dependendo do que você escolheu para esta integração anteriormente neste procedimento. Você pode mais tarde vincular mais projetos Vercel ao mesmo cluster Atlas nesta integração.
Se o projeto selecionado não tiver a entrada 0.0.0.0./0 na lista de acesso do Atlas, o Atlas solicita que você reconheça que está criando um cluster do Atlas com acesso total devido a endereços IP dinâmicos em Vercel. O Atlas enviará a você um e-mail contendo estas informações.
Crie um novo cluster se não tiver um cluster Atlas. Posteriormente, você pode modificar o cluster que criou.
Confirme se você tem o role
Project Ownerdo Atlas.O Atlas cria um novo cluster de nível gratuito e o vincula aos projetos Vercel que você selecionou. Posteriormente, você pode vincular mais projetos do Vercel ao mesmo cluster do Atlas nesta integração.
Clique em para reconhecer estas declarações:
A lista de acesso IP contém 0.0.0.0/0, que abre o acesso de entrada aos clusters do Atlas em projetos selecionados do Atlas para todos os endereços IP.
Sua implantação Vercel requer esse acesso porque usa endereçosIP dinâmicos para se conectar ao Atlas.
Gerenciar uma Integração do Vercel na UI do Atlas
Para gerenciar a integração com o Vercel:
No Atlas, acesse a página Organization Settings.
Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.
Clique no ícone Organization Settings próximo ao menu Organizations.
A página Configurações da organização é exibida.
Acesse a página Organization Integrations.
Clique em Integrations na barra lateral.
A página Integrações da organização é exibida.
Vincular clusters adicionais do Atlas
Para vincular clusters adicionais em sua organização a projetos no Vercel:
Observação
Use este procedimento para uma integração já configurada. Para configurar uma integração inicial, consulte Adicionar uma integração do Vercel.
No Atlas, acesse a página Organization Settings.
Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.
Clique no ícone Organization Settings próximo ao menu Organizations.
A página Configurações da organização é exibida.
Acesse a página Organization Integrations.
Clique em Integrations na barra lateral.
A página Integrações da organização é exibida.
Vincular outro Atlas cluster a um ou mais projetos do Vercel.
Clique em Link Clusters.
A janela Add Another Cluster Link with Vercel abre e mostra a sua organização Atlas.
Selecione um projeto do Atlas.
Na lista suspensa à esquerda, selecione um cluster não vinculado ao Vercel. Se o seu projeto não tiver outro cluster do Atlas, você poderá criar um.
Na lista suspensa à direita, selecione um ou mais projetos do Vercel.
(Opcional). Alterne a chave Enable the Atlas Data API. Habilitar a Atlas Data API permite a você utilizar o HTTPS para conectar aos bancos de dados do Atlas nesta organização.
Clique em Save.
Você recebe um e-mail de confirmação do Atlas com os detalhes da sua integração.
Um novo cluster do Atlas vinculado aparece na lista de agrupamentos vinculados.
Para vincular um cluster de outro projeto do Atlas em sua organização ao Vercel, repita esse procedimento para o projeto.
Editar ou remover links para Atlas clusters
Você pode adicionar ou remover projetos do Vercel que vinculou a um Atlas cluster.
No Atlas, acesse a página Organization Settings.
Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.
Clique no ícone Organization Settings próximo ao menu Organizations.
A página Configurações da organização é exibida.
Acesse a página Organization Integrations.
Clique em Integrations na barra lateral.
A página Integrações da organização é exibida.
Para adicionar ou remover alguns projetos do Vercel, clique em Edit próximo ao projeto do Atlas vinculado.
O Atlas exibe projetos Vercel vinculados existentes.
Edite os links existentes, na lista do lado direito, escolhendo um projeto no menu suspenso. Você pode:
Clique em ao lado de um projeto do Vercel na lista para adicioná-lo à integração deste cluster.
Clique em para remover alguns projetos da Vercel desta integração.
(Opcional). Alterne a chave Enable the Atlas Data API. Habilitar a Atlas Data API permite a você utilizar o HTTPS para conectar aos bancos de dados do Atlas nesta organização.
Para remover links para todos os projetos do Vercel, clique em Unlink próximo ao projeto do Atlas vinculado.
O Atlas solicita que você confirme que deseja desvincular o cluster dos projetos. Para confirmar, clique em Unlink. O Atlas remove as variáveis de ambiente para projetos do Vercel criadas quando você vinculou os projetos a um Atlas cluster.
Se você desvincular todos os projetos, o Atlas se comportará da seguinte maneira. Isso é:
Não remove seus dados, usuários do banco de dados ou listas de acesso IP que você criou para essa integração.
Não exclui o cluster ou a integração, mesmo que a IU do Atlas mostre que você não tem clusters vinculados em sua integração. Para desabilitar a integração, você deve desconectar o Vercel.
Desconectar uma integração do Vercel
Antes de desconectar os projetos do Vercel dos clusters do Atlas, 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 esses clusters do Atlas.
No Atlas, acesse a página Organization Settings.
Se ainda não estiver exibido, selecione sua organização desejada no Menu Organizations na barra de navegação.
Clique no ícone Organization Settings próximo ao menu Organizations.
A página Configurações da organização é exibida.
Acesse a página Organization Integrations.
Clique em Integrations na barra lateral.
A página Integrações da organização é exibida.
Confirme que você deseja desconectar esta integração do Vercel.
O Atlas solicita que você confirme que pretende desligar a sua organização Atlas 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.
Para confirmar, insira as palavras Disconnect Vercel em letras maiúsculas e clique em Disconnect Vercel.
O Atlas remove a integração removendo as variáveis de ambiente para projetos Vercel criados quando você vinculou os projetos a um Atlas cluster.
O Vercel também remove a integração e não é mais exibido na UI do Vercel.
Depois de desconectar a integração com o Vercel, se não tiver excluído usuários, listas de acesso ou chaves da Atlas Data API, você pode:
Observação
Quando você remove uma integração na IU do Vercel, o Atlas também remove a integração, e você não precisa desconectar a integração na IU do Atlas.