Integração com o Vercel
Nesta página
Você pode conectar seus Atlas clusters a aplicativos que você implanta usando 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ê:
Criar uma nova conta pessoal ou criar uma nova equipe em 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 Atlas cluster a mais de um projeto no Vercel.
Para configurar a integração, você deve ter um ou mais projetos em seu Vercel pessoal ou de equipe conta.
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
Vercel sistemas 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.
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 criar uma nova conta no Atlas com sua organização, projeto e função de usuário e, em seguida, criar um novo cluster, ou utilizar uma conta do Atlas existente, organização, projeto e Atlas cluster para integração com o Vercel.
Para integrar os aplicativos do Vercel aos Atlas cluster, você começa no Vercel UI.
Navegue até a integração do Atlas MongoDB.
Vá para Integração do MongoDB Atlas 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). 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.
Crie um novo cluster de camada grátis ou vincule um cluster existente a um ou mais projetos do Vercel.
Clique em Return to Vercel e confirme os detalhes da integração.
O Atlas envia um e-mail de confirmação com os detalhes da sua integração. A janela de integração é fechada ,e você retorna à UI do Vercel, onde pode atualizar os projetos do Vercel nessa integração.
Gerenciar uma Integração do Vercel na UI do Atlas
Para gerenciar a integração com o Vercel, use a Integrations página para sua organização no Atlas.
Selecione sua organização no menu Organizations na barra de navegação.
Clique em Integrations na barra lateral e selecione Vercel.
A partir daqui, você pode executar estas tarefas:
Vincular clusters adicionais do Atlas
Para vincular clusters adicionais na sua organização a projetos no Vercel, use o Link clusters botão na Integrations página do Atlas para o 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.
Vá para sua organização.
Selecione sua organização no menu Organizations na barra de navegação.
Acesse sua integração com o Vercel.
Clique em Integrations na barra lateral.
Selecione Vercel.
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.
Acesse sua integração com o Vercel.
Clique em Integrations na barra lateral.
Selecione Vercel.
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 UI do Atlas mostre que você não tem clusters vinculados em sua integração. Para desabilitar a integração, você deve desconectar o Vercel.
Clique em Save.
Desconectar uma integração do Vercel
Antes de desconectar o Vercel projetos do Atlas cluster, para evitar o tempo de inatividade de qualquer aplicativo conectado aos mesmos Atlas clusters, 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.
Acesse sua integração com o Vercel na UI do Atlas.
Clique em Integrations na barra lateral.
Selecione Vercel.
Clique em Disconnect Vercel.
Nesta etapa, clique em para solicitar ao Atlas para executar estas tarefas opcionais para você:
Delete the database users created as part of this integration
Delete the network access rules created as part of this integration
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.