将编程工具从 M2、M5 或无服务器实例迁移到 Flex 集群
在此页面上
重要
从 2 月 2025 开始，您可以创建 Flex 集群，并且无法再在Atlas 用户界面、 Atlas CLI、 Atlas Administration API、 Atlas Kubernetes Operator、 HashiCorp Terraform 或Atlas中创建 M2 和 M5 集群或无服务器实例CloudFormation 资源。 您仍然可以使用现有的 M2 和 M5 集群以及无服务器实例。
Atlas已弃用 M2 和 M5 集群以及无服务器实例。 Atlas会自动将所有现有的 M2 和 M5 集群迁移到 Flex 集群。 对于无服务器实例， Atlas会根据您的使用情况决定将实例迁移到免费集群、Flex 集群还是专用集群。 要查看Atlas会将您的实例迁移到哪些层级，请查阅Atlas 用户界面中的“所有集群”页面。
在您选择的工具支持 Flex 集群后，更新代码，将对已弃用实例类型的所有引用替换为对 Flex 集群的引用。
迁移API配置
本部分的表中列出的 Cluster API端点与M2 /M5 集群兼容。自 1 月 2025 起，这些端点管理Flex 集群。 您可以继续使用这些API端点而无需进行任何更改，直到它们在 2026的 1 月达到生命周期结束 (EOL)。
自 12025 月起，无服务器实例的API端点管理Flex 集群。3 月 2025之后，所有现有无服务器实例将根据您的使用情况迁移到免费集群、Flex 集群或专用集群。 如果您的无服务器实例迁移到免费集群或专用集群，则必须改用集群API端点。要查看Atlas会将您的实例迁移到哪些层级，请查阅Atlas 用户界面中的“所有集群”页面。
如果您尝试在M2 和M5 之间使用 createCluster 端点创建 或 集群，或者使用 createServerlessInstance 20252026端点创建无服务器实例，您将创建一个 Flex集群。对这些端点的支持将于 20261 月结束。
在将无服务器实例迁移到 Flex 集群之前，必须将对无服务器实例API端点的调用替换为对集群API端点的适当配置的调用。
从 2025 1 月开始，以下更改也应用于列出的API端点。
端点 | 影响 |
|---|---|
在新的 Flex 集群中已弃用。 一旦在 3 月 2025之后将无服务器实例迁移到免费、灵活或专用集群，将返回错误。 | |
用于 Flex 集群时， | |
用于 Flex 集群时， | |
用于 Flex 集群时， | |
用于 Flex 集群时， | |
用于 Flex 集群时， |
Terraform Atlas Provider 迁移
HashiCorp Terraform 提供程序支持 Flex 集群。对 M2/M5 集群和无服务器实例的一般 Terraform支持将持续到 2026 1 月。
您必须根据以下时间表更新Terraform 配置才能在 Flex 集群上运行，具体取决于您使用的功能：
功能 | 更新截止日期 |
|---|---|
3 月，2025 | |
适用于新无服务器实例的无服务器 PrivateLink 端点服务 | 一月，2025 |
适用于现有无服务器实例的无服务器 PrivateLink 端点服务 | 3 月，2025 |
所有其他功能 | 一月，2026 |
Go SDK 迁移
Atlas Go SDK 从 11 月开始支持 Flex2024 集群。对M2 /M5 集群和无服务器实例的一般 SDK支持将持续到 12026 月。您必须根据以下时间表更新SDK 脚本，才能在 Flex 集群上运行，具体取决于您使用的功能：
功能 | 更新截止日期 |
|---|---|
3 月，2025 | |
所有其他功能 | 一月，2026 |
Atlas CLI迁移
Atlas CLI从 12 月 开始支持 Flex2024 集群。要学习；了解更多信息，请参阅命令参考并从下拉列表中选择最新的Atlas CLI版本。
对无服务器实例持续云备份的支持已于 2025 1 月终止。如果您在任何无服务器实例上使用了连续云备份，则必须更新Atlas CLI工作流程以删除无服务器实例连续云备份，以避免错误。
对 M2/M5 集群和无服务器实例的一般Atlas CLI支持将持续到 2026 1 月。在 1 月 2026之前，您必须从Atlas CLI工作流程中删除所有 M2/M5 和无服务器实例命令。
Atlas Kubernetes Operator迁移
Atlas Kubernetes Operator从 2 月 开始支持 Flex2025 集群。
在 1 月 2026之前，为了在一段时间内保持向后兼容性， Atlas允许您通过无服务器实例和 Flex 集群 API管理迁移的集群，包括在使用Atlas Kubernetes Operator时。
您可以在创建和托管无服务器实例以及 和 集群的同一 自定义资源中创建和管理Flex
AtlasDeploymentM2M5集群。要学习；了解更多信息，请参阅Atlas Kubernetes Operator文档中的 AtlasDeployment 自定义资源。您无法在Atlas中创建新的 / 集群和无服务器实例。尝试这样做会创建一个 Flex集群。
M2M5即使现有的无服务器实例自 2 月初 2025起已弃用，您仍可在Atlas Kubernetes Operator中使用现有的无服务器实例。
对于现有无服务器实例，您可以选择将对
AtlasDeployment自定义资源中的spec.serverlessSpec的引用替换为spec.flexSpec的配置。或者，您可以继续使用相同的规范。即使Atlas在 2025 3 月自动将这些现有集群迁移到 Flex 集群，通过AtlasDeployment自定义资源中的spec.serverlessSpec管理部署仍将继续有效。对于现有的
M2和M5集群，您可以选择将对AtlasDeployment自定义资源中的spec.deploymentSpec的引用替换为spec.flexSpec的配置。或者，您可以继续使用相同的规范。即使Atlas在 2025 5 月自动将这些现有的M2和M5集群自动迁移到 Flex 集群，通过AtlasDeployment自定义资源中的spec.deploymentSpec管理部署将继续有效。对于现有无服务器实例，如果在协调期间收到与私有端点相关的错误，则必须升级到Atlas Kubernetes Operator 2.7.1，或将
serverlessSpec配置替换为AtlasDeployment自定义资源中的flexSpec配置。对于
M2和M5集群，为避免自动迁移后可能出现的协调错误，请对 CRD 配置进行以下更改：删除
spec.deploymentSpec.replicationSpecs.zoneName设置。删除第一设立设置之后的任何
spec.deploymentSpec.replicationSpecs.regionConfigs设置。仅在
spec.deploymentSpec.clusterType中指定replicaset。
或者，将对
AtlasDeployment自定义资源中的spec.deploymentSpec的引用替换为spec.flexSpec的配置。在 2026 1 月之前，您必须从Atlas Kubernetes Operator自定义资源中删除所有剩余的
M2/M5和无服务器实例配置，因为 API 的向后兼容性将于 2026 1 月结束，届时旧 API 将被删除，并且仅 API与 Flex 集群相关的设置将保留。较新版本的Atlas Kubernetes Operator将停止支持现有的
M2/M5集群和无服务器实例。旧版本的Atlas Kubernetes Operator将继续支持这些实例类型，直到 1 月 2026。
Atlas CloudFormation 迁移
Atlas CFN 和 CDK 将从 2025上半月开始支持Flex 集群。 对 M2/M5 集群的一般支持将持续到 2026 的 1 月。
Properties.ContinuousBackupEnabled当Atlas CFN 引入 Flex集群支持时，将结束对无服务器私有端点和无服务器实例资源的 参数的支持。您必须在 3 月 2025之前更新CFN 和 CDK 资源以删除这些资源。 您必须在 1 月 2026之前从Atlas CFN 和 CDK 资源中删除所有 M2/M5 和无服务器实例功能。