Docs 菜单

Docs 主页启动和管理 MongoDBMongoDB Atlas

与 Vercel 集成

在此页面上

  • 考虑因素
  • 添加 Vercel 集成
  • 在 Atlas UI 中管理 Vercel 集成

您可以将 Atlas 集群连接到使用 Vercel 部署的应用程序 。

使用本页完成以下任务:

  • 在Atlas 中连接 Vercel 用户和团队到组织。

  • 为这些用户和团队创建从 Vercel 项目到 Atlas 集群的 链接。

  • 启用Atlas Data API。

要将在 Vercel 中部署的无服务器函数连接到 Atlas 集群,您还可以使用 MongoDB Node.js 驱动程序 Mongoose ODM 库。

Vercel 的集成 要求您:

注意

您可以添加一个 Vercel 集成作为个人帐户用户, 然后添加另一个 Vercel 集成作为团队用户。您无法将 Vercel 中现有集成范围 从个人账户更改为团队级别账户。

要从个人 Vercel 帐户的 MongoDB 集成切换到同一 Atlas 组织中与团队范围的集成,请断开 Atlas 中现有集成的连接,然后添加与团队范围的新集成。

您可以将一个 Atlas 集群链接到 Vercel 中的多个项目 。

要配置集成,您的个人或团队 Vercel 中必须有一个或多个项目 帐户。

您可以选择用于集成的 Vercel 项目列表取决于用户或团队范围。

Vercel 部署使用 动态 IP 地址

要连接 Atlas 集群,此Atlas 集群的 IP 访问列表必须支持所有 IP 地址 (0.0.0.0/0)。如果 Atlas 没有在 Atlas 项目的 IP 访问列表中找到 0.0.0.0/0 的条目,则作为集成工作流程的一部分,Atlas 会代表您添加此条目。

当您设置集成时,Atlas 会执行以下操作,保护 Vercel 与集群的连接:

  • 创建 MONGODB_URI 环境变量,作为您将此集群链接到所有 Vercel 项目的 Atlas 集群的连接字符串。

    当应用程序未指定数据库时,MONGODB_URI 变量使用 /myFirstDatabase 作为默认数据库名称。将此名称替换为您的数据库名称,或者如果您使用库与 MongoDB 交互,请确保您的应用程序代码指定您的数据库名称。

  • 在管理员数据库中创建数据库用户vercel-admin-user ,并将内置的readWriteAnyDatabase MongoDB 数据库角色授予集群中的所有其他非系统数据库。

此过程允许您在 Atlas 中创建新帐户及其组织、项目和用户角色,然后创建新集群,或使用现有 Atlas 帐户、组织、项目和 Atlas 集群与 Vercel 集成 。

要将 Vercel 应用程序与 Atlas 集群集成,请从 Vercel 开始 用户界面。

1

转到 Vercel 中的 MongoDB Atlas 集成 Add integration,然后单击 。

2
  1. 从下拉菜单中选择一个 Vercel 范围:

    • Personal Account

    • Team

    设置集成范围后就无法更改。要切换到与所选范围不同的范围,请断开一个集成的连接,然后使用此过程创建另一个集成。

  2. 单击 Continue(连接)。

3

您可以选择特定项目或所有项目。您可以稍后编辑集成以更改项目。 项目列表取决于您在上一步中指定的用户或团队范围。

选择以下选项之一:

  • All Projects

  • Specific Projects

4
  1. 选择以下其中一个选项:

    • 如果使用 Google 账户,请按照步骤登录,或创建一个新的 Google 账户。

    • 如果使用电子邮件,则该电子邮件已填写并显示为灰色。

    • 如果贵公司使用联合身份验证,请使用贵公司的电子邮件地址。继续执行联合用户访问所需的验证步骤。

    • 如果您已经拥有 Atlas 账户,请单击 Log in now。请参阅登录 Atlas 帐户

  2. 输入您的名字和姓氏,然后选择密码。密码长度至少 8 个字符,包含唯一字符、数字或符号,并且不包含您的电子邮件地址。请参阅注册新的 Atlas 账户。

  3. 单击复选框 I accept the Privacy Policy and the Terms of Service(我接受隐私政策和服务条款)。

    查看服务条款隐私政策。

5
  1. 从下拉列表中选择 Atlas 组织,或创建新的 Atlas 组织

  2. 单击 Continue(连接)。

  3. 确认对 Atlas 组织的访问权限。

    Atlas 为您创建组织。单击 I Acknowledge,确认您授予 Vercel 对 Atlas 组织的访问权限。

    要删除此 Vercel 集成对 MongoDB Atlas 组织的访问权限,您必须断开此集成的连接。

  4. 从下拉列表中选择要与 Vercel 集成的 Atlas 项目,或创建新项目

  5. (可选)。切换Enable the Atlas Data API开关。启用Atlas Data API后,您可以使用 HTTPS连接到该组织中的 Atlas 数据库。

6
7

Atlas 向您发送一封确认电子邮件,其中包含集成的详细信息。 集成窗口关闭,您将返回到 Vercel 用户界面, 您可以在其中更新此集成中的 Vercel 项目。

管理与 Vercel 的集成 Integrations,使用 Atlas 中 组织 的 页面。

1

将组织中的其他集群链接到 Vercel 中的项目 Link clustersIntegrations,使用 Vercel 的 Atlas 页面上的 按钮。

注意

对已配置的集成使用此步骤。要配置初始集成,请参阅添加 Vercel 集成。

1

从导航栏的 Organizations 菜单中选择您的组织。

2
  1. 单击侧边栏中的 Integrations(支持)。

  2. 选择 Vercel

3

单击 Link Clusters(连接)。

Add Another Cluster Link with Vercel 窗口打开并显示您的 Atlas 组织。

  1. 选择一个 Atlas 项目。

  2. 选择左侧下拉列表中未链接到 Vercel 的集群。如果您的项目没有其他 Atlas 集群,可以创建一个

  3. 在右侧下拉列表中,选择一个或多个 Vercel 项目。

  4. (可选)。切换Enable the Atlas Data API开关。启用Atlas Data API后,您就可以使用HTTPS连接到该组织中的 Atlas 数据库。

  5. 单击 Save(连接)。

您将收到 Atlas 发送的一封确认电子邮件,其中包含集成的 详细信息。

一个链接的新 Atlas 集群出现在链接集群列表中。

如需将组织内另一个 Atlas 项目的集群链接到 Vercel, 请重复该项目的此过程。

您可以添加或删除链接到 Atlas 集群的 Vercel 项目。

1

单击侧边栏中的 Integrations(支持)。

  1. 选择 Vercel

2

Atlas 显示现有的链接 Vercel 项目。

  1. 编辑右侧列表中的现有链接,从下拉列表中选择一个项目。 你可以执行以下操作:

    • 单击列表中 Vercel 项目旁边的,将其添加到该集群的集成中。

    • 点击 从此集成中删除一些 Vercel 项目。

  2. (可选)。切换Enable the Atlas Data API开关。启用Atlas Data API后,您就可以使用HTTPS连接到该组织中的 Atlas 数据库。

3

Atlas 要求您确认是否要取消集群与项目的链接。要确认,请单击 Unlink 。Atlas 会删除在您将项目链接到 Atlas 集群时为 Vercel 项目创建的环境变量。

如果取消所有项目的链接,Atlas 的行为如下。其:

  • 不会删除为该集成创建的数据、 数据库用户或 IP 访问列表。

  • 即使 Atlas 用户界面可能显示集成中没有关联集群,也不会删除集群或集成。要禁用集成,必须断开 Vercel 的连接。

4

在断开 Vercel 的 连接之前 项目,为避免连接到同一 Atlas 集群的任何应用程序停机,请验证集群的用户和网络访问规则不会共享连接到此 Atlas 集群的其他项目和应用程序。

1
  1. 单击侧边栏中的 Integrations(支持)。

  2. 选择 Vercel

2

在此步骤中,单击 以请求 Atlas 为您完成这些可选任务:

  • Delete the database users created as part of this integration

  • Delete the network access rules created as part of this integration

3

Atlas 会要求您确认是否要断开 Atlas 组织与 Vercel 的连接。

断开集成可能会导致您的 Vercel 应用程序 和连接到您与 Vercel 链接的 Atlas 集群的任何其他应用程序停机。

要确认,请以大写字母输入 Disconnect Vercel ,然后单击 Disconnect Vercel (断开 Vercel 连接)。

Atlas 通过删除 Vercel 项目的环境变量来删除集成, 环境变量创建于您将项目链接到 Atlas 集群时。

Vercel 还删除了集成,并且不再显示在 Vercel 用户界面中。

断开 Vercel 集成后,如果您没有删除用户、访问列表或Atlas Data API密钥,您可以:

注意

当您在 Vercel 用户界面中删除集成时,Atlas 也会删除该集成,并且您无需在 Atlas 用户界面中断开集成

← 探索 MongoDB 合作伙伴生态系统