Docs 菜单
Docs 主页
/

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

重要

从 2 月 2025 开始,您可以创建 Flex 集群,并且无法再在Atlas 用户界面、 Atlas CLI、 Atlas Administration API、 Atlas Kubernetes Operator、HashiCorp Terraform 中创建 M2M5 集群或无服务器实例,或Atlas CloudFormation Resources。

Atlas不再支持 M2M5 集群以及无服务器实例。截至 5 月 25,2025, Atlas已将所有现有 M2M5 集群迁移到 Flex 集群。

Atlas会根据您的使用情况将无服务器实例迁移到免费集群、Flex 集群或专用集群。要查看Atlas将您的实例迁移到哪些层级,请查阅Atlas用户界面中的“所有集群”页面。

所有工具都支持Flex 集群。更新您的代码,将对已弃用实例类型的所有引用替换为对 Flex 集群的引用。

注意

如果您的工作负载需要 私有端点或持续备份和时点恢复,请使用专用集群。

本部分的表中列出的 Cluster API端点与M2 /M5 集群兼容。自 1 月 2025 起,这些端点管理Flex 集群。 您可以继续使用这些API端点而无需进行任何更改,直到它们在 2026的 1 月达到生命周期结束 (EOL)。

自 12025 月起,无服务器实例的API端点管理Flex 集群。截至 3 月2025 ,所有现有无服务器实例均已根据您的使用情况迁移到免费集群、Flex 集群或专用集群。如果您的无服务器实例迁移到免费集群或专用集群,则必须改用集群API端点。要查看Atlas会将您的实例迁移到哪些层级,请查阅Atlas 用户界面中的“所有集群”页面。

如果您尝试在M2M5 之间使用 creategroupcluster 端点创建 或 集群,或使用 creategroupserverlessinstance 20252026端点创建无服务器实例,您将创建一个 Flex集群。对这些端点的支持将于 12026 月结束。

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

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

端点
影响

在新的 Flex 集群中已弃用。返回错误,因为自 2025 5 月起,无服务器实例将迁移到免费、Flex 或专用集群。

用于 Flex 集群时,upgradeSharedCluster 会采用用户设立的值,但不会切换持续备份,因为持续备份不适用于 Flex 集群。

用于 Flex 集群时,createServerlessInstance 会采用用户设立的值,但不会切换持续备份,因为持续备份不适用于 Flex 集群。

用于 Flex 集群时,updateServerlessInstance 会采用用户设立的值,但不会切换持续备份,因为持续备份不适用于 Flex 集群。

用于 Flex 集群时,setServerlessAutoIndexing 会采用用户设立的值,但不会切换自动索引,因为自动索引不适用于 Flex 集群。

用于 Flex 集群时,getServerlessAutoIndexing 会采用用户设立的值,但不会切换自动索引,因为自动索引不适用于 Flex 集群。

HashiCorp Terraform 提供程序 支持 Flex 集群。对 M2/M5 集群和无服务器实例的一般 Terraform支持将持续到 2026 1 月。

您必须根据以下时间表更新Terraform 配置才能在 Flex 集群上运行,具体取决于您使用的功能:

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

功能
更新截止日期

5 月,2025

所有其他功能

一月,2026

Atlas CLI从 12 月 2024开始支持 Flex 集群。要学习;了解更多信息,请参阅命令参考并从下拉列表中选择最新的Atlas CLI版本。

对无服务器实例持续云备份的支持已于 2025 1 月终止。如果您在任何无服务器实例上使用了连续云备份,则必须更新Atlas CLI工作流程以删除无服务器实例连续云备份,以避免错误。

M2/M5 集群和无服务器实例的一般Atlas CLI支持将持续到 2026 1 月。在 1 月 2026之前,您必须从Atlas CLI工作流程中删除所有 M2/M5 和无服务器实例命令。

Atlas Kubernetes Operator从 2 月 2025开始支持 Flex 集群。

  • 在 1 月 2026之前,为了在一段时间内保持向后兼容性, Atlas允许您通过无服务器实例和 Flex 集群 API管理迁移的集群,包括在使用Atlas Kubernetes Operator时。

  • 您可以在创建和托管无服务器实例以及 M2M5 集群的同一 AtlasDeployment 自定义资源中创建和管理Flex 集群。要学习;了解更多信息,请参阅Atlas Kubernetes Operator文档中的 AtlasDeployment 自定义资源。

  • 您无法在Atlas中创建 新的 M2/M5 集群和无服务器实例。尝试这样做会创建一个 Flex集群。

  • AtlasDeployment 自定义资源中对 spec.serverlessSpec 的引用替换为 spec.flexSpec 的配置。

  • AtlasDeployment 自定义资源中对 spec.deploymentSpec 的引用替换为 spec.flexSpec 的配置。

  • 如果在协调期间收到与私有端点相关的错误,则必须至少升级到Atlas Kubernetes Operator 2.7.1 或更高版本,或将 serverlessSpec 配置替换为 AtlasDeployment 自定义资源中的 flexSpec 配置。

  • 为避免自动迁移后可能出现的协调错误,

  • 对 CRD 配置进行以下更改:

    • 删除 spec.deploymentSpec.replicationSpecs.zoneName 设置。

    • 删除第一设立设置之后的任何 spec.deploymentSpec.replicationSpecs.regionConfigs 设置。

    • 仅在 spec.deploymentSpec.clusterType 中指定 replicaset

    或者,将对 AtlasDeployment 自定义资源中的 spec.deploymentSpec 的引用替换为 spec.flexSpec 的配置。

  • 在 2026 之前,您必须从Atlas Kubernetes Operator自定义资源中删除所有剩余的 M2/M5 和无服务器实例配置,因为 API 的向后兼容性将于 2026 1 月结束。届时,旧 API 将被删除,仅与 Flex 集群相关的 API 会保留。 2.7.1 之后的Atlas Kubernetes Operator版本不支持现有的无服务器实例。

Atlas CloudFormation 和 Cloud Development Kit (CDK) 现在支持Flex 集群。对 M2/M5 集群的一般支持将持续到 2026 1 月。

Properties.ContinuousBackupEnabled当Atlas CloudFormation 引入 Flex集群支持时,对无服务器私有端点和无服务器实例资源的 参数的支持结束。这些资源在 CloudFormation 或 CDK 中不再可用。更新您的配置以将其删除。您必须在 1 月 2026之前从Atlas CloudFormation 和 CDK 资源中删除所有 M2/M5 和无服务器实例功能。

重要

使用 CloudFormation 中的 MongoDB::Atlas::Cluster资源或 CDK 中的 CfnCluster资源,而不是 CloudFormation 中的 MongoDB::Atlas::FlexCluster资源或 CDK 中的 CfnFlexCluster资源来创建和管理Flex 集群。MongoDB::Atlas::ClusterCfnCluster支持Flex 集群,未来的升级只能通过这些资源进行。CloudFormation 和 CDK 尚不支持Flex 集群与其他集群类型之间的迁移,但将来会增加支持。

有关更多信息,请参阅:

后退

Amazon Web Services上的GraphQL API

在此页面上