Vercel 是一个可简化应用程序部署的开发平台。 Vercel 为开发者提供了一个发现软件包和预配应用程序的市场。
使用此页面上的说明执行以下操作：
开始使用 Vercel 和MongoDB Atlas ，并使用MongoDB Atlas构建您的下一个项目。
从免费、专用和 Flex MongoDB集群中进行选择，并提供适合每个使用案例的选项。
原生集成和可连接帐户
您可以通过以下方式与 Vercel 集成：
原生集成
在此模式下，您在 Vercel Marketplace 中找到MongoDB Atlas ，然后创建新的MongoDB Atlas帐户，并通过 Vercel 进行计费。 Vercel 中MongoDB Atlas的原生集成允许您：
直接从 Vercel仪表盘配置Atlas资源，并通过 Vercel 帐户托管计费。您还可以通过预配的关联帐户直接访问权限Atlas中的资源。
为新的和现有的 Vercel 应用程序部署MongoDB Atlas集群。
创建MongoDB Atlas集群后，Vercel 会将Atlas 集群凭证和其他设置添加到 Vercel 环境中。要学习；了解有关原生集成的更多信息，请参阅 Vercel 原生集成。
可连接帐户集成
此模式将指导您在Atlas中设置帐户，以连接现有的 Vercel 项目。
“可连接帐户集成”模式允许您将现有Atlas帐户链接到您的 Vercel 帐户，但要求您在 Vercel用户界面之外管理您的Atlas帐户、计费和资源创建。相比之下，原生集成模式允许您直接从 Vercel用户界面创建和管理Atlas资源，并通过 Vercel 帐户托管计费。
重要
虽然继续支持可连接帐户集成，但我们建议您仅使用它来将现有Atlas资源连接到 Vercel。要同时使用 Vercel 和MongoDB Atlas以获取新的Atlas资源并获得最佳开发者体验，请使用 Vercel 原生集成。
在 Vercel 中查找Atlas
如果您是具有任何角色的Vercel 用户，您可以通过以下方法发现Atlas ：
登录 Vercel用户界面。
在 Overview标签页下，找到右上角的 Add new 按钮，然后从下拉列表中选择 Integration。
Considerations
Vercel 中的帐户（个人或团队）
与 Vercel 的集成要求您：
Vercel 中的项目
您可以将一个 Atlas 集群链接到 Vercel 中的多个项目。
如果您在 Vercel 中创建Atlas的原生集成， Atlas会在Atlas中为您创建一个新的 Vercel 托管组织和项目。
如果您使用Atlas与 Vercel 的可连接帐户集成，则您的个人或团队Vercel 帐户中必须有一个或多个项目，然后才能将它们链接到Atlas集群。
您可以选择用于集成的 Vercel 项目列表取决于用户或团队范围。
Atlas 中的 IP 访问列表和 Vercel 中的 IP 允许列表
Vercel 部署使用动态IP地址。
要连接到 Atlas 集群，Atlas 集群的 IP 访问列表必须支持所有 IP 地址 (0.0.0.0/0)。如果 Atlas 没有在 Atlas 项目的 IP 访问列表中找到 0.0.0.0/0 的条目，则作为集成工作流程的一部分，Atlas 会代表您添加此条目。
如果您使用Atlas与 Vercel 的原生集成， Atlas会在管理员数据库中按以下格式创建数据库用户：
Vercel-Admin-[name of resource]，并将内置的readWriteAnyDatabase MongoDB 数据库角色授予Atlas 集群中的所有其他非系统数据库。示例，如果您的 Vercel资源名为my-first-atlas-cluster，则Atlas创建的数据库用户为Vercel-Admin-my-first-atlas-cluster。如果您设立Atlas与 Vercel 的可连接帐户集成， Atlas会按以下方式保护您的 Vercel 连接到集群： Atlas会创建一个
MONGODB_URI环境变量，作为您将此集群链接到的所有 Vercel 项目的Atlas集群的连接字符串。当应用程序未指定数据库时，
MONGODB_URI变量使用/myFirstDatabase作为默认数据库名称。将此名称替换为您的数据库名称，或者如果您使用库与 MongoDB 交互，请确保您的应用程序代码指定您的数据库名称。Atlas在管理员数据库中创建数据库用户
vercel-admin-user，并将内置readWriteAnyDatabase MongoDB 数据库角色授予Atlas 集群中的所有其他非系统数据库。
Vercel 原生集成
您可以在 Vercel Marketplace 中创建Atlas的原生集成，直接从 Vercel仪表盘预配Atlas资源，并通过 Vercel 帐户托管计费。您还可以通过预配的关联帐户直接访问权限Atlas中的资源。
如果您没有帐户， Atlas会为您预配帐户。 Atlas帐户链接到 Vercel 安装。您有单独的凭证用于登录Atlas。
注意事项：原生集成
以下注意事项应用于 Vercel 中Atlas的原生集成。此外，请参阅应用于两种集成模式的注意事项。
资源映射
Vercel 中的“团队安装”映射到Atlas中的组织。 Vercel 中已安装的产品（资源）会映射到Atlas中的项目和集群。
API 访问
Vercel 需要以编程方式访问权限Atlas API，以代表用户创建和管理资源并传播环境变更。
用户预配和帐户关联
Atlas会为 Vercel 用户配置新的Atlas 用户帐户，关联现有帐户，并在您未配置Atlas凭证的情况下发送密码重置电子邮件。用户身份验证需要Atlas凭证才能访问权限Atlas。
最初为 Vercel团队安装Atlas Native Integration 的用户将成为Atlas
Organization 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
Organization Owner安装，并授予该用户Atlas中的 角色。 Atlas使组织的权限与 Vercel 中的权限保持一致。Organization OwnerVercel 的“管理员”和“用户”角色分别映射到Atlas中的Organization 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原生集成，请执行以下操作：
选择集群地区。
显示 Vercel 地区列表。在大多数情况下，这些区域映射到MongoDB Atlas区域。如果您选择的 Vercel地区没有相应的Atlas地区，Atlas会选择与您所选 Vercel地区最接近的地区。
选择安装计划：免费或付费。
免费计划 $0
无需信用。您只能使用此计划创建免费的MongoDB Atlas集群。
付费套餐
需提供信用卡。您可以使用此计划创建免费、灵活和专用集群。您只需为 Flex 和 Dedicated 集群付费。
如果您选择 Flex 或 Dedicated Atlas 集群，则“免费”计划将灰显。如果您的 Vercel团队的任何成员将本机集成与免费计划结合使用，并选择创建“灵活”或“专用”集群，则该计划将更改为“付费”计划。即使您卸载非免费的MongoDB Atlas 群集，该计划仍将是付费计划。要将计划更改为免费计划，请卸载原生集成，然后选择免费集群和免费计划再次安装。要学习；了解如何卸载任何原生集成，请参阅 Vercel 文档。
现在，您可以使用 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 集群与 Vercel 集成。
要将您在 Vercel 中部署的无服务器函数连接 Atlas 集群，您还可以使用 MongoDB Node.js 驱动程序或 Mongoose ODM 库。
要将 Vercel 应用程序与 Atlas 集群集成，请从 Vercel UI 开始。
注意
导航到 MongoDB Atlas 集成。
转到 Vercel 中的MongoDB Atlas 集成，然后单击 Add integration。
选择集成范围（用户或团队）。
从下拉菜单中选择一个 Vercel 范围：
Personal Account
Team
设置集成范围后无法更改。要切换到与所选范围不同的范围，请断开一个集成并使用此步骤创建另一个集成。
单击 Continue（连接）。
如果您还没有账户，请创建您的 MongoDB 账户。
选择以下其中一个选项：
如果使用 Google 账户，请按照步骤登录，或创建一个新的 Google 账户。
如果使用电子邮件，则该电子邮件已填写并显示为灰色。
如果贵公司使用联合身份验证，请使用贵公司的电子邮件地址。继续执行联合用户访问所需的验证步骤。
如果您已经拥有 Atlas 账户，请单击 Log in now。请参阅登录 Atlas 帐户。
输入您的名字和姓氏，然后选择密码。密码长度至少 8 个字符，包含唯一字符、数字或符号，并且不包含您的电子邮件地址。请参阅注册新的 Atlas 账户。
单击复选框 I accept the Privacy Policy and the Terms of Service（我接受隐私政策和服务条款）。
选择要与 Vercel 集成的 Atlas 组织。
从下拉列表中选择 Atlas 组织，或创建新的 Atlas 组织。
单击 Continue（连接）。
确认对 Atlas 组织的访问权限。
Atlas 为您创建组织。单击 I Acknowledge，确认您授予 Vercel 对 Atlas 组织的访问权限。
要删除此 Vercel 集成对 MongoDB Atlas 组织的访问权限，您必须断开此集成。
从下拉列表中选择要与 Vercel 集成的 Atlas 项目，或创建新项目。
创建新的免费层级集群，或将现有集群链接到一个或多个 Vercel 项目。
如果您已经拥有 Atlas 帐户，则可以选择现有的组织和项目， 然后选择现有的集群。
确保您拥有 Atlas Project Owner 角色。
从映射左侧的下拉列表中选择 Atlas 集群。
从右侧的下拉列表中选择一个或多个 Vercel 项目。您可以将一个 Atlas 集群映射到一个或多个 Vercel 项目。下拉菜单显示一个项目或所有项目，具体取决于您在此过程中为此集成所做的选择。稍后，您可以将更多的 Vercel 项目链接到此集成中的同一 Atlas 集群。
0.0.0.00如果所选项目在Atlas访问权限列表中没有./ 条目， Atlas会要求您确认您正在创建的Atlas 集群由于 Vercel 中的动态IP地址而具有完全访问权限。 Atlas会向您发送一封电子邮件，告知您这些信息。
如果您没有 Atlas 集群，请创建新集群。您稍后可以修改所创建的集群。
确保您拥有 Atlas
Project Owner角色。Atlas 会创建一个新的免费套餐集群，并将其链接到您选择的 Vercel 项目。 您稍后可以将更多 Vercel 项目链接到同一个 Atlas 集群。
单击，确认这些声明：
管理可连接帐户集成
注意
本节中的所有过程均已弃用。现有的“可连接帐户”集成将继续有效。对于新的集成，请改用与 Vercel 的原生集成。
要管理可连接帐户与 Vercel 的集成，请执行以下操作：
在 Atlas 中，转到 Organization Settings（项目设置）页面。
警告： 导航改进正在进行中
我们目前正在推出改进的全新导航体验。如果以下步骤与Atlas用户界面中的视图不匹配，请参阅预览文档。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
将另一个Atlas集群链接到可连接帐户集成
注意
本节中的所有过程均已弃用。现有的“可连接帐户”集成将继续有效。对于新的集成，请改用与 Vercel 的原生集成。
要将组织中的其他集群链接到 Vercel 中的项目，请执行以下操作：
注意
对已配置的“可连接帐户”集成使用此步骤。
在 Atlas 中，转到 Organization Settings（项目设置）页面。
警告： 导航改进正在进行中
我们目前正在推出改进的全新导航体验。如果以下步骤与Atlas用户界面中的视图不匹配，请参阅预览文档。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
将另一个 Atlas 集群链接到一个或多个 Vercel 项目。
单击 Link Clusters（连接）。
Add Another Cluster Link with Vercel 窗口打开并显示您的 Atlas 组织。
选择一个 Atlas 项目。
选择左侧下拉列表中未链接到 Vercel 的集群。如果您的项目没有其他 Atlas 集群，可以创建一个。
在右侧下拉列表中，选择一个或多个 Vercel 项目。
单击 Save（连接）。
您将收到 Atlas 发送的一封确认电子邮件，其中包含集成的 详细信息。
一个链接的新 Atlas 集群出现在链接集群列表中。
如需将组织内另一个 Atlas 项目的集群链接到 Vercel， 请重复该项目的此过程。
编辑或删除指向 Atlas 集群的链接
注意
本节中的所有过程均已弃用。现有的“可连接帐户”集成将继续有效。对于新的集成，请改用与 Vercel 的原生集成。
您可以添加或删除链接到 Atlas 集群的 Vercel 项目。
在 Atlas 中，转到 Organization Settings（项目设置）页面。
警告： 导航改进正在进行中
我们目前正在推出改进的全新导航体验。如果以下步骤与Atlas用户界面中的视图不匹配，请参阅预览文档。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
如需删除与所有 Vercel 项目的链接，请单击链接的 Atlas 项目旁边的 Unlink（取消链接）。
Atlas 要求您确认是否要取消集群与项目的链接。要确认，请单击 Unlink 。Atlas 会删除在您将项目链接到 Atlas 集群时为 Vercel 项目创建的环境变量。
如果取消所有项目的链接，Atlas 的行为如下。其：
不会删除为该集成创建的数据、 数据库用户或 IP 访问列表。
不会删除集群或集成，即使 Atlas 用户界面可能显示您的集成中没有关联集群。要禁用集成，必须断开 Vercel 的连接。
断开与 Vercel 集成的连接
注意
本节中的所有过程均已弃用。现有的“可连接帐户”集成将继续有效。对于新的集成，请改用与 Vercel 的原生集成。
断开 Vercel 项目与 Atlas 集群的连接之前，为避免连接到同一 Atlas 集群的任何应用程序停机，请验证集群的用户和网络访问规则是否共享连接到此 Atlas 集群的其他项目和应用程序。
在 Atlas 中，转到 Organization Settings（项目设置）页面。
警告： 导航改进正在进行中
我们目前正在推出改进的全新导航体验。如果以下步骤与Atlas用户界面中的视图不匹配，请参阅预览文档。
如果尚未显示，组织从导航栏中的Organizations菜单。
单击 Organizations 菜单旁边的 Organization Settings 图标。
显示“组织设置”页面。
转到 Organization Integrations（快速入门）页面。
单击侧边栏中的 Integrations（支持）。
显示组织集成页面。
确认要断开此 Vercel 集成。
Atlas 会要求您确认是否要断开 Atlas 组织与 Vercel 的连接。
断开集成可能会导致您的 Vercel 应用程序 和连接到您与 Vercel 链接的 Atlas 集群的任何其他应用程序停机。
要确认，请以大写字母输入 Disconnect Vercel ，然后单击 Disconnect Vercel （断开 Vercel 连接）。
Atlas 通过删除 Vercel 项目的环境变量来删除集成， 环境变量创建于您将项目链接到 Atlas 集群时。
Vercel 还删除了集成，并且不再显示在 Vercel 用户界面中。
断开 Vercel 集成后，如果您尚未删除用户或访问列表，那么您可以：
注意
删除 Vercel 用户界面中的集成时，Atlas 也会删除集成，因此无需在 Atlas 用户界面中断开集成。