Vercel 是一个可简化应用程序部署的开发平台。Vercel 为开发者提供了一个发现软件包和预配应用程序的市场。
MongoDB Atlas与 Vercel 的原生集成允许您:
直接从 Vercel仪表盘配置Atlas资源,并通过 Vercel 帐户托管计费。
通过原生登录流程从 Vercel 访问 Atlas 资源,Atlas 将为您创建或链接所需的 Atlas 帐户。
为新的和现有的 Vercel 应用程序部署MongoDB Atlas集群。
从免费、专用和 Flex MongoDB集群中进行选择,并提供适合每个使用案例的选项。
创建MongoDB Atlas集群后,Vercel 会将Atlas 集群凭证和其他设置添加到 Vercel 环境中。
在 Vercel 中查找Atlas
如果您是具有任何角色的Vercel 用户,您可以通过以下方法发现Atlas :
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 会代表您添加此条目。
注意
如果您将任何 IPv4 /0 CIDR(例如 0.0.0.0/0 或 10.0.0.0/0)添加到项目访问列表中,Atlas 会向所有直接被授予该项目角色的用户发送告警邮件;对于通过团队成员身份间接获得项目角色的用户(前提是该团队已被授予项目角色),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,以代表用户创建和管理资源并传播环境变更。
用户预配、帐户关联和单点登录
在 Vercel 用户界面中使用 Open in MongoDB Atlas 访问与 Vercel 托管资源相关联的 Atlas 组织、项目或集群。如果您还没有 Atlas 账户,当您从 Vercel 打开 Atlas 时,Atlas 会预配一个新的 Atlas 账户。您无需创建单独的 Atlas 凭证来访问 Vercel 托管的 Atlas 资源。
如果您已有一个使用用户名和密码的 Atlas 账户,Atlas 会在第一次提示您将 Atlas 账户链接到 Vercel。链接账户后,您可以继续使用现有 Atlas 凭证直接登录 Atlas,或使用 Open in MongoDB Atlas 从 Vercel 返回 Atlas。在大多数情况下,用户可以使用 Vercel 凭证 (SSO) 登录 Atlas。但是,使用 Google 或 GitHub 登录的现有 Atlas 用户,以及其组织已配置企业 SSO 的用户,必须继续通过 Atlas 账户登录页面使用现有 Atlas 登录方法访问 Atlas。
最初为 Vercel团队安装Atlas Native Integration 的用户将成为Atlas
Organization Owner。从 Vercel 访问 Atlas
您可以通过 Open in MongoDB Atlas 按钮从 Vercel 导航到 Atlas 用户界面。
拥有现有 Atlas 帐户的用户。从 Vercel 访问 Atlas 时,Vercel 会提示具有现有 Atlas 帐户的用户将其 Atlas 帐户链接到 Vercel 安装。确认后,用户可以使用 Vercel 凭证 (SSO) 登录 Atlas,也可以继续使用 Atlas 凭证。
使用 Google、Github 或企业 SSO 登录 Atlas 的现有 Atlas 用户无法使用其 Vercel 凭证登录。
新用户。当新用户点击 Open in Atlas 时,Atlas 会预配一个帐户,并使用其 Vercel 凭证为其记录日志。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 集成。
断开集成可能会导致您的 Vercel 应用程序 和连接到您与 Vercel 链接的 Atlas 集群的任何其他应用程序停机。
卸载 Vercel 集成后,我们建议Atlas Organization Owner 确保访问权限分配和计费方式是最新的,并删除过时或不需要的访问权限,以防止MongoDB自动提醒有关逾期账单付款。
Atlas向 Vercel 提交Atlas Vercel 集成的最终 Vercel 发票,并从Atlas组织中删除 Vercel Marketplace 付款方式。
此发票不是Atlas最终发票,因为卸载后,组织可能仍会为最近的使用量产生尚未计费的额外费用。您有责任为组织添加新的付款方式,以确保可以支付任何未结的使用量。