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

升级集群的 MongoDB 主版本

您可以随时升级集群以升级Atlas Core集群的主要版本。

为了确保您顺利过渡到新的MongoDB版本并且不会影响您的应用程序,请在升级生产Atlas Core集群上的主要版本之前,使用以下过程创建暂存集群并针对新的MongoDB版本测试您的应用程序。

重要

Atlas Infinite 集群不支持手动MongoDB版本控制。

仅Atlas Core 集群支持升级和降级MongoDB版本。

Atlas Infinite 集群使用 Latest Version With Auto Upgrades运行MongoDB ,并且不支持手动版本升级。 Atlas自动管理Atlas Infinite 集群的版本控制。

如果您的集群使用 Latest Version With Auto Upgrades,Atlas会自动管理其升级,并且您无法执行此过程。要控制环境接收自动升级的顺序,请使用维护波次。

以下注意事项适用:

  • 升级之前,您的集群必须处于正常状态。

  • 如果您在主要版本升级前拍摄按需快照,请等待快照完成后再升级版本。

  • 如果您将集群从较低版本升级到MongoDB 8.0,请注意Atlas中的写入阻塞行为。为确保升级到MongoDB 8.0 后专用集群的主节点 (primary node in the replica set)节点写入不会被阻止,请执行以下操作:

    • 升级后,检查集群是否有足够的存储容量来处理工作负载。

    • 启用存储自动伸缩,在磁盘使用率超过 90% 时自动伸缩集群存储,并确保一致的工作负载可用性和性能。

  • 每个主要版本均包含某些可能无法与以前版本向后兼容的功能。升级到新的主要版本时,请查看发布说明,了解可能会影响应用程序的更改。

    或者,如果您使用Stable API,请确保MongoDB版本之间的行为更改不会在升级后破坏您的应用程序。

    MongoDB稳定版API包含MongoDB命令的子集,应用程序使用这些命令读取和写入数据、创建集合和索引以及执行其他常见任务。稳定的API:

    • 允许您指定应用程序运行的MongoDB API版本,并为应用程序提供长期的API稳定性。

    • 支持更频繁的发布和自动服务器升级,使您的应用程序能够利用快速发布的功能,而不必冒向后不兼容更改的风险。

以下限制适用于升级集群版本的操作:

  • 您无法升级到比固定的FCV版本高 2 个版本的版本。固定FCV可将其固定为以前的主要版本长达 4 周,以便您可以在需要时降级。如果集群固定到FCV 6.0,则只能升级到 7.0,而不能升级到 8.0+。要学习;了解如何为集群固定FCV ,请参阅为集群固定FCV 。

  • 您一次只能升级Atlas 集群一个主要版本。升级集群时无法跳过任何主要版本。

  • 升级 MongoDB 主版本后,您将无法降级到以前的版本,除非您在升级前固定了集群的特征兼容性版本。

  • 实时迁移要求源集群和目标集群的特征兼容性版本必须匹配其主版本号。要学习有关支持的迁移路径的更多信息,请参阅迁移或导入数据。

    重要

    实时迁移和 Mongosync 不支持次要版本,因此,如果集群使用 Latest Version With Auto Upgrades,则无法工作。要迁移当前使用次要版本的集群,请使用自助迁移工具。

要升级集群,您必须具有项目的 Project Owner 或更高角色。

要升级MongoDB主版本:

1
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。

  2. 如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。

  3. 在侧边栏中,单击 Database 标题下的 Clusters。

会显示集群页面。

2

注意

如果已经有 Atlas 集群作为过渡环境,则可以跳过此步骤。

单击 Create 按钮,打开集群创建模式。配置暂存集群以匹配生产集群。不必为暂存集群启用备份。

要学习;了解如何创建新集群,请参阅创建Atlas无限或Atlas核心集群。

重要

如果为暂存集群选择较小的集群层, 请考虑运行的任何性能测试 可能无法代表升级后的生产集群的性能。 您可能还需要根据 要镜像到暂存集群的数据量来选择更大的存储大小。

3

注意

如果已经有最新的 Atlas 集群作为过渡环境, 则可以跳过此步骤。

如果您为生产集群启用了备份,请恢复最近的快照并选择暂存集群作为目标。

4

更新暂存应用程序以点暂存集群。有关检索暂存集群的MongoDB驱动程序友好连接字符串的说明,请参阅通过客户端库连接到集群。

确认应用程序可以成功连接到暂存集群并且应用程序按预期运行。

5

将应用程序升级到适用于集群MongoDB版本的最新MongoDB驱动程序,即可完全访问权限较新MongoDB版本提供的功能。您还可能会发现较新的驱动程序版本具有更好的性能或稳定性。有关给定MongoDB版本的推荐MongoDB驱动程序的文档和连接示例,请参阅通过客户端库连接到集群。通过使用 Stable API,您可以确保MongoDB版本之间的行为更改不会破坏您的应用程序。

如果升级应用程序后遇到错误,请在 JIRA 项目中为您的 MongoDB 驱动程序提交工单。

6
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。

  2. 如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。

  3. 在侧边栏中,单击 Database 标题下的 Clusters。

会显示集群页面。

7
  1. 单击 Edit Config,然后从下拉菜单中选择您的暂存集群。

  2. 将集群版本更改为所需的 MongoDB 主版本。

    重要

    除非在升级之前预先固定集群的FCV ,否则无法降级Atlas 集群的MongoDB版本。如果要使用原始MongoDB版本重新部署暂存环境,则必须终止集群并重新创建。

  3. 单击 Confirm & Deploy 可部署所做更改。

Atlas 会自动开始升级集群。 考虑计算 Atlas 升级集群所需的时间, 从而设置生产集群升级的总体预期。

如果升级后的暂存集群遇到特定于版本的问题,请提交支持工单。

8

执行暂存群集的所有必需的性能与操作测试。

如果升级后的暂存集群遇到特定于版本的问题,请提交支持工单。

重要

主要版本升级至少需要一个副本集选举。使用暂存集群以便测试应用程序对主节点故障转移的恢复能力。请参阅测试主节点故障转移以查看完整文档。

9

对暂存集群的性能和操作有信心后,请对生产集群重复升级过程:

  1. 使用较新的MongoDB驱动程序升级生产应用程序,并测试其是否正常运行。此步骤可确保您的应用程序在数据库升级之前与新的MongoDB版本兼容。

  2. 准备好应用程序后,升级生产集群上的MongoDB版本。当Atlas完成升级后,请检查应用程序是否正常连接和运行。

如果升级后的生产集群出现问题, 请使用以下部分的过程提交一个高优先级支持票证。

如果您对迁移支持有任何超出本文档范围的问题, 或者在迁移过程中遇到错误, 请通过 Atlas 用户界面提交支持工单。

如果您有任何疑问或需要进一步帮助,请联系我们的支持团队。