Docs 菜单
Docs 主页
/
MongoDB Atlas
/ /

将编程工具从 M 2、M 5 或无服务器实例迁移到 Flex 集群

在此页面上

  • 迁移API配置
  • Terraform Atlas Provider 迁移
  • Go SDK 迁移
  • Atlas CLI迁移
  • Atlas Kubernetes Operator迁移
  • Atlas CloudFormation 迁移

Atlas将在不久的将来弃用 M2 和 M5 集群以及无服务器实例。 Atlas会自动迁移所有 M2 和 M5 集群迁移到 Flex 集群。对于无服务器实例, Atlas会根据您的使用情况决定将实例迁移到免费集群、Flex 集群还是专用集群。要查看Atlas会将您的实例迁移到哪些层级,请参阅Atlas用户界面中的“所有集群”页面。

在您选择的工具支持 Flex 集群后,更新编程工具,将对已弃用实例类型的所有引用替换为对 Flex 集群的引用。

本部分的表中列出的 Cluster API端点与M2 /M5 集群兼容。这些端点将保留目前的功能直到 12025 月,届时这些端点将开始管理 Flex 集群。您可以继续使用这些API端点而不进行更改,直到它们在 1 月被新的 Flex集群端点移除。2026

无服务器实例的API端点将于 1 月开始管理 Flex2025 集群。您可以继续使用这些 API 管理现有的无服务器实例。在 3 月 之后,现有的无服务器实例将根据您的使用情况迁移到免费集群、Flex2025 集群或专用集群。如果您的无服务器实例迁移到免费或专用集群,则必须改用集群API端点。要查看Atlas会将您的实例迁移到哪些层级,请查阅Atlas 用户界面中的“所有集群”页面。

如果您尝试使用M2 M5createCluster 端点创建 / 集群,或使用 createServerlessInstance 端点创建无服务器实例,则在2025 和 12026 月之间,您将创建一个 Flex集群。对这些端点的支持将于 12026 月结束。

在将无服务器实例迁移到 Flex 集群之前,必须将对无服务器实例API端点的调用替换为对集群API端点的适当配置的调用。

从 2025 1 月开始,以下更改也应用于列出的API端点。

端点
影响
在新的 Flex 集群中已弃用。一旦在 3 月 2025 之后将无服务器实例迁移到免费、灵活或专用集群,将返回错误。
用于 Flex 集群时,upgradeSharedCluster 会采用用户设立的值,但不会切换持续备份,因为持续备份不适用于 Flex 集群。
用于 Flex 集群时,createServerlessInstance 会采用用户设立的值,但不会切换持续备份,因为持续备份不适用于 Flex 集群。
用于 Flex 集群时,updateServerlessInstance 会采用用户设立的值,但不会切换持续备份,因为持续备份不适用于 Flex 集群。
用于 Flex 集群时,setServerlessAutoIndexing 会采用用户设立的值,但不会切换自动索引,因为自动索引不适用于 Flex 集群。
用于 Flex 集群时,getServerlessAutoIndexing 会采用用户设立的值,但不会切换自动索引,因为自动索引不适用于 Flex 集群。

如果您的工作负载需要 私有端点或持续备份和时点恢复,我们建议您切换到Atlas专用集群。

从 11 月开始,HashiCorp Terraform MongoDB Atlas提供程序 将支持Flex 集群。对2024 M2/M5 集群和无服务器实例的常规 Terraform支持将持续到 12026 月。您必须根据以下时间表更新Terraform 配置才能在 Flex 集群上运行,具体取决于您使用的功能:

功能
更新截止日期
游行, 2025
游行, 2025
所有其他功能
一月, 2026

Atlas Go SDK 将于 11 月开始支持Flex 集群。对2024 M2/M5 集群和无服务器实例的一般 SDK支持将持续到 12026 月。您必须根据以下时间表更新SDK 脚本,才能在 Flex 集群上运行,具体取决于您使用的功能:

功能
更新截止日期
游行, 2025
所有其他功能
一月, 2026

Atlas CLI将从 2024 12 月开始支持Flex 集群。对 M2 / M5 集群和无服务器实例的一般Atlas CLI支持将持续到 2026 1 月。对无服务器实例连续云备份的支持将于 2025 1 月结束。您必须在 1 月 2025之前更新您的Atlas CLI工作流程以删除无服务器实例连续云备份;您必须在 1 月 2026之前从Atlas CLI工作流程删除所有 M2 / M5 和无服务器实例命令。

Atlas Kubernetes Operator将从 1 月 开始支持Flex2025 集群。这包括在同一Atlas部署自定义资源中创建和管理Flex 实例的能力。新版本的Atlas Kubernetes Operator将在夏季 停止支持M2 /M5 2025集群和无服务器实例。旧版本的Atlas Kubernetes Operator将继续支持这些实例类型,直到 1 月2026 。

对无服务器实例上的私有端点的支持将于 3 月 2025 结束。您必须更新Atlas Kubernetes Operator配置,才能在 EOL 之前删除私有端点。您必须在 2026 1 月之前从Atlas Kubernetes Operator配置删除所有剩余的 M2/M5 和无服务器实例功能。

Atlas CFN 和 CDK 将从 2025 上半月开始支持Flex 集群。对 M2 / M5 集群的一般支持将持续到 2026 1 月。

Properties.ContinuousBackupEnabled当Atlas CFN 引入 Flex集群支持时,将结束对无服务器私有端点和无服务器实例资源的 参数的支持。您必须在 3 月 之前更新CFN 和 CDK2025 资源以删除这些资源。您必须在M2 M51 月 之前从Atlas CFN 和 CDK 资源删除所有 /2026 和无服务器实例功能。

后退

已验证的 HashiCorp Terraform 示例