Vercel 是一个可简化应用程序部署的开发平台。Vercel 为开发者提供了一个发现软件包和预配应用程序的市场。
MongoDB Atlas与 Vercel 的原生集成允许您:
直接从 Vercel仪表盘配置Atlas资源,并通过 Vercel 帐户托管计费。
通过预配的关联帐户访问Atlas中的资源。
为新的和现有的 Vercel 应用程序部署MongoDB Atlas集群。
从免费、专用和 Flex MongoDB集群中进行选择,并提供适合每个使用案例的选项。
创建MongoDB Atlas集群后,Vercel 会将Atlas 集群凭证和其他设置添加到 Vercel 环境中。
在 Vercel 中查找Atlas
如果您是具有任何角色的Vercel 用户,您可以通过以下方法发现Atlas :
登录 Vercel 用户界面。
在 Overview标签页下,找到右上角的 Add new 按钮,然后从下拉列表中选择 Integration。
Considerations
Vercel 中的帐户(个人或团队)
与 Vercel 的集成要求您:
使用 Vercel 中现有个人或团队帐户。
Vercel 中的项目
您可以将一个 Atlas 集群链接到 Vercel 中的多个项目。
如果您在 Vercel 中创建Atlas的原生集成, Atlas会在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 会代表您添加此条目。
注意
如果您将 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 集成,请在 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 的用户将成为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 安装,并授予该用户Atlas中的
Organization Owner角色。Atlas使组织的权限与 Vercel 中的权限保持一致。Vercel 的“管理员”和“用户”角色分别映射到 Atlas 中的Organization Owner和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 集成的连接
断开 Vercel 项目与 Atlas 集群的连接之前,为避免连接到同一 Atlas 集群的任何应用程序停机,请验证集群的用户和网络访问规则是否共享连接到此 Atlas 集群的其他项目和应用程序。
确认要断开此 Vercel 集成。
断开集成可能会导致您的 Vercel 应用程序 和连接到您与 Vercel 链接的 Atlas 集群的任何其他应用程序停机。
卸载 Vercel 集成后,我们建议AtlasOrganization Owner 确保访问权限分配和计费方式是最新的,并删除过时或不需要的访问权限,以防止MongoDB自动提醒有关逾期账单付款。
Atlas向 Vercel 提交Atlas Vercel 集成的最终 Vercel 发票,并从Atlas组织中删除 Vercel Marketplace 付款方式。
此发票不是Atlas最终发票,因为卸载后,组织可能仍会为最近的使用量产生尚未计费的额外费用。您有责任为组织添加新的付款方式,以确保可以支付任何未结的使用量。