对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

与 Vercel 集成

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

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

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

  • 通过原生登录流程从 Vercel 访问 Atlas 资源,Atlas 将为您创建或链接所需的 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 会代表您添加此条目。

注意

如果您将任何 IPv4 /0 CIDR(例如 0.0.0.0/010.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 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 的用户将成为AtlasOrganization 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 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 集成。

2

按照 Vercel用户界面提示卸载集成。有关详细说明,请参阅Vercel 文档。

3

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

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

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

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

4

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

注意

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