Docs 菜单
Docs 主页
/

与 Vercel 集成

Vercel 是一个可简化应用程序部署的开发平台。Vercel 为开发者提供了一个发现软件包和预配应用程序的市场。

MongoDB Atlas与 Vercel 的原生集成允许您:

  • 直接从 Vercel仪表盘配置Atlas资源,并通过 Vercel 帐户托管计费。

  • 通过预配的关联帐户访问Atlas中的资源。

  • 为新的和现有的 Vercel 应用程序部署MongoDB Atlas集群。

  • 从免费、专用和 Flex MongoDB集群中进行选择,并提供适合每个使用案例的选项。

创建MongoDB Atlas集群后,Vercel 会将Atlas 集群凭证和其他设置添加到 Vercel 环境中。

如果您是具有任何角色的Vercel 用户,您可以通过以下方法发现Atlas :

1

Overview标签页下,找到右上角的 Add new 按钮,然后从下拉列表中选择 Integration

2

在左侧列表中,选择 Any TypeAny Category。使用页面顶部的 Search 面板搜索MongoDB,然后在 Native Integrations(原生集成)列表中选择 MongoDB Atlas

3

在 Vercel Marketplace 中所有集成的左侧列表中,选择 Categories > Storage,然后在原生集成列表中选择 MongoDB Atlas

与 Vercel 的集成要求您:

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

如果您在 Vercel 中创建Atlas的原生集成, Atlas会在Atlas中为您创建一个新的 Vercel 托管组织和项目。

Vercel 部署使用动态IP地址

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

注意

如果您将 0.0.0.0/0 CIDR 添加到项目访问列表,Atlas 会向所有直接被授予项目角色或通过团队成员间接被授予项目角色(如果团队被授予项目角色)的所有用户发送警报电子邮件。

Atlas在管理员数据库中按以下格式创建数据库用户:Vercel-Admin-[name of resource] ,并将内置readWriteAnyDatabase MongoDB 数据库角色授予Atlas 集群中的所有非系统数据库。示例,如果您的 Vercel资源名为my-first-atlas-cluster ,则Atlas创建的数据库用户为Vercel-Admin-my-first-atlas-cluster

要与 Vercel 集成,请在 Vercel Marketplace 中找到MongoDB Atlas ,然后创建一个新的MongoDB Atlas帐户,通过 Vercel 进行计费。 Vercel 中MongoDB Atlas的原生集成允许您:

  • 直接从 Vercel仪表盘配置Atlas资源,并通过 Vercel 帐户管理计费。您还可以通过预配的关联帐户直接访问权限Atlas中的资源。

  • 为新的和现有的 Vercel 应用程序部署MongoDB Atlas集群。

创建MongoDB Atlas集群后,Vercel 会将Atlas 集群凭证和其他设置添加到 Vercel 环境中。

如果您没有帐户, Atlas会为您预配帐户。Atlas帐户链接到 Vercel 安装。您有单独的凭证用于登录Atlas。

以下注意事项应用于 Vercel 中Atlas的原生集成。

  • 资源映射

    Vercel 中的“团队安装”映射到Atlas中的组织。Vercel 中已安装的产品(资源)会映射到Atlas中的项目和集群。

  • API 访问

    Vercel 需要以编程方式访问权限Atlas API,以代表用户创建和管理资源并传播环境变更。

  • 用户预配和帐户关联

    Atlas会为 Vercel 用户配置新的Atlas 用户帐户,关联现有帐户,并在您未配置Atlas凭证的情况下发送密码重置电子邮件。 用户身份验证需要Atlas凭证才能访问权限Atlas。

    最初为 Vercel团队安装Atlas Native Integration 的用户将成为AtlasOrganization Owner

  • 访问 |service|来自 Vercel

    您可以通过 Open in Atlas 按钮从 Vercel 导航到Atlas用户界面。使用Atlas凭证登录后, Atlas会将您重定向到相应的Atlas资源。

    • 具有现有Atlas帐户的用户。从 Vercel 访问Atlas时,Vercel 会提示拥有现有Atlas帐户的用户确认将其Atlas帐户链接到 Vercel 安装。在用户确认关联并使用Atlas凭证登录以证明其身份后, Atlas会将用户的Atlas帐户链接到其 Vercel 安装。

    • 新用户。Atlas为新用户配置一个帐户并发送密码重置电子邮件,以便用户可以配置密码并证明其身份。Atlas获得用户的凭证后,会将用户的Atlas帐户链接到其 Vercel 安装,并授予该用户Atlas中的Organization Owner角色。Atlas使组织的权限与 Vercel 中的权限保持一致。Vercel 的“管理员”和“用户”角色分别映射到 Atlas 中的 Organization OwnerOrganization Read Only 角色。

    如果 Vercel团队中的任何用户使用原生集成安装额外的Atlas集群, Atlas不会自动将这些用户添加到为 Vercel团队创建的Atlas组织中。Atlas组织所有者必须确保所有需要访问权限Atlas组织的Vercel团队用户都拥有该权限。这也适用于在初始安装原生集成后加入 Vercel团队的Vercel团队新用户。

    使用以下方法之一确保Atlas将其他 Vercel 团队用户添加到Atlas组织:

    • Vercel团队用户可以通过 Vercel用户界面访问权限Atlas用户界面中的Atlas组织。如果他们还不是Atlas用户, Atlas会为其配置帐户,并分配给Atlas组织以进行原生集成。

    • Atlas组织所有者可以邀请Atlas用户加入Atlas组织。

  • 环境变量

    原生集成会自动配置 MONGODB_URI 环境变量,以实现安全的数据库连接。有关环境变量的完整列表,请参阅Atlas原生集成的 Vercel用户界面。

  • 帐单

    Vercel 原生集成从 Vercel 用户界面创建新的Atlas组织,该用户用户界面会自动连接到 Vercel Marketplace 计费计划,作为Atlas组织的有效付款方式。按每个Atlas组织计费,包括组织中所有MongoDB Atlas集群和服务的集体账单。在 Vercel 和Atlas中,您可以看到Atlas组织的 Vercel Marketplace 账单确认以及每日使用成本。

  • 安全性

    对于您通过 Vercel 中的原生集成创建的Atlas集群, Atlas通过SCRAM身份验证与IP名单确保安全连接。

  • 删除或卸载原生集成

    卸载 Vercel 集成后,我们建议Atlas组织所有者确保访问权限分配和计费方式是最新的,并删除过时或不需要的访问权限,以防止MongoDB自动提醒有关逾期账单付款。Atlas向 Vercel 提交Atlas的最终 Vercel 发票,并从Atlas组织中删除 Vercel Marketplace 付款方式。

    此发票不是Atlas最终发票,因为卸载后,组织可能仍会为最近的使用量产生尚未开具账单的额外费用。您有责任为组织添加新的付款方式,以确保可以支付任何未结的使用量。

    尽管您可以随时删除Atlas中的资源,但无法从Atlas用户界面卸载或取消链接原生集成。如果删除Vercel关联集群,则会反映在 Vercel用户界面中。

  • Next.js 的 Vercel用户界面入门

    适用于原生集成的 Vercel用户界面包含 Next.js 和Atlas入门说明。

  • 部署模板

    原生集成的 Vercel用户界面包括部署模板。这些模板包括示例代码和配置文件,可帮助您开始在 Vercel 中使用Atlas项目。

要在 Vercel 中添加MongoDB Atlas原生集成,请执行以下操作:

1
  1. GoVercel Marketplace,使用搜索或 Storage 的左侧类别过滤在原生集成列表中找到 MongoDB Atlas

  2. 单击MongoDB Atlas页面中的 Install 进行集成,或单击 Vercel用户界面页面右上角的 Install 进行集成。

2

单击 Accept and Create(连接)。

3

选择免费、灵活或专用Atlas 集群:

  • 免费($0,存储:512 MB, RAM:共享,vCPU:共享)

  • Flex(0.011 美元/小时、存储:最高 5 GB, RAM:共享,vCPU:共享)

  • 专用(0.08 美元/小时、存储:10 GB, RAM:2 GB,vCPU:2 xCPU)

重要

所有安装计划都提供免费集群。灵活和专用集群仅适用于付费安装计划。

4

显示 Vercel 地区列表。在大多数情况下,这些区域映射到MongoDB Atlas区域。如果您选择的 Vercel地区没有相应的Atlas地区,Atlas会选择与您所选 Vercel地区最接近的地区。

5
  • 免费计划 $0

    无需信用。您只能使用此计划创建免费的MongoDB Atlas集群。

  • 付费套餐

    需提供信用卡。您可以使用此计划创建免费、灵活和专用集群。您只需为 Flex 和 Dedicated 集群付费。

如果您选择 Flex 或 Dedicated Atlas 集群,则“免费”计划将灰显。如果您的 Vercel团队的任何成员将本机集成与免费计划结合使用,并选择创建“灵活”或“专用”集群,则该计划将更改为“付费”计划。即使您卸载非免费的MongoDB Atlas 群集,该计划仍将是付费计划。要将计划更改为免费计划,请卸载原生集成,然后选择免费集群和免费计划再次安装。要学习;了解如何卸载任何原生集成,请参阅Vercel 文档。

6

Vercel 会生成一个名称,您可以选择该名称,也可以输入自己的名称。

7
8

Vercel用户界面显示 Initializing,然后显示 Available。这意味着您的MongoDB Atlas 群集已可供使用。

现在,您可以使用 Vercel 中Atlas的原生集成来:

  • 连接到 Vercel项目。

  • 拉取最新的环境变量。

如果不再需要此MongoDB Atlas 群集,则可以卸载原生集成,从而删除MongoDB Atlas数据库。有关说明,请参阅Vercel 文档。

您还可以删除数据库(资源),而无需卸载整个集成。如果您希望保留集成以在将来创建其他资源,或者您在同一集成中还有其他资源,则此功能非常有用。

如果删除Vercel 链接的Atlas 集群,则您在 Vercel 中链接到此集群的任何项目将无法再访问权限此数据库集群。在继续卸载和删除Atlas 集群之前,请确保此Atlas 集群不再被任何项目或应用程序使用。

如果您在使用 Vercel 与MongoDB Atlas原生集成时运行问题,请通过MongoDB vercel-integation-support@mongodb.com联系Vercel 集成支持部门。

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

1

导航到 Vercel 帐户设置并找到MongoDB Atlas集成。

3

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

卸载 Vercel 集成后,我们建议AtlasOrganization Owner 确保访问权限分配和计费方式是最新的,并删除过时或不需要的访问权限,以防止MongoDB自动提醒有关逾期账单付款。

Atlas向 Vercel 提交Atlas Vercel 集成的最终 Vercel 发票,并从Atlas组织中删除 Vercel Marketplace 付款方式。

此发票不是Atlas最终发票,因为卸载后,组织可能仍会为最近的使用量产生尚未计费的额外费用。您有责任为组织添加新的付款方式,以确保可以支付任何未结的使用量。

4

断开与 Vercel 集成的连接后,您可以:

注意

当您在 Vercel用户界面中删除集成时, Atlas也会删除集成。

在此页面上