您可以随时升级集群以升级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会自动管理其升级,并且您无法执行此过程。要控制环境接收自动升级的顺序,请使用维护波次。
Considerations
以下注意事项适用:
升级之前,您的集群必须处于正常状态。
如果您在主要版本升级前拍摄按需快照,请等待快照完成后再升级版本。
如果您将集群从较低版本升级到MongoDB 8.0,请注意Atlas中的写入阻塞行为。为确保升级到MongoDB 8.0 后专用集群的主节点 (primary node in the replica set)节点写入不会被阻止,请执行以下操作:
升级后,检查集群是否有足够的存储容量来处理工作负载。
每个主要版本均包含某些可能无法与以前版本向后兼容的功能。升级到新的主要版本时,请查看发布说明,了解可能会影响应用程序的更改。
或者,如果您使用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 主版本后,您将无法降级到以前的版本,除非您在升级前固定了集群的特征兼容性版本。
必需的访问权限
要升级集群,您必须具有项目的 Project Owner 或更高角色。
升级MongoDB主版本
要升级MongoDB主版本:
AtlasGoClusters在Atlas中,Go项目的 页面。
如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中,单击 Database 标题下的 Clusters。
会显示集群页面。
为过渡环境创建 Atlas 集群。
注意
如果已经有 Atlas 集群作为过渡环境,则可以跳过此步骤。
单击 Create 按钮,打开集群创建模式。配置暂存集群以匹配生产集群。不必为暂存集群启用备份。
要学习;了解如何创建新集群,请参阅创建Atlas无限或Atlas核心集群。
重要
如果为暂存集群选择较小的集群层, 请考虑运行的任何性能测试 可能无法代表升级后的生产集群的性能。 您可能还需要根据 要镜像到暂存集群的数据量来选择更大的存储大小。
将您的暂存应用程序指向暂存集群。
更新暂存应用程序以点暂存集群。有关检索暂存集群的MongoDB驱动程序友好连接字符串的说明,请参阅通过客户端库连接到集群。
确认应用程序可以成功连接到暂存集群并且应用程序按预期运行。
(可选)将您的应用程序升级到最新的 MongoDB 驱动程序。
将应用程序升级到适用于集群MongoDB版本的最新MongoDB驱动程序,即可完全访问权限较新MongoDB版本提供的功能。您还可能会发现较新的驱动程序版本具有更好的性能或稳定性。有关给定MongoDB版本的推荐MongoDB驱动程序的文档和连接示例,请参阅通过客户端库连接到集群。通过使用 Stable API,您可以确保MongoDB版本之间的行为更改不会破坏您的应用程序。
如果升级应用程序后遇到错误,请在 JIRA 项目中为您的 MongoDB 驱动程序提交工单。
AtlasGoClusters在Atlas中,Go项目的 页面。
如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中,单击 Database 标题下的 Clusters。
会显示集群页面。
将生产集群升级为目标 MongoDB 版本。
对暂存集群的性能和操作有信心后,请对生产集群重复升级过程:
使用较新的MongoDB驱动程序升级生产应用程序,并测试其是否正常运行。此步骤可确保您的应用程序在数据库升级之前与新的MongoDB版本兼容。
准备好应用程序后,升级生产集群上的MongoDB版本。当Atlas完成升级后,请检查应用程序是否正常连接和运行。
如果升级后的生产集群出现问题, 请使用以下部分的过程提交一个高优先级支持票证。
联系支持人员
如果您对迁移支持有任何超出本文档范围的问题, 或者在迁移过程中遇到错误, 请通过 Atlas 用户界面提交支持工单。