升级集群的 MongoDB 主版本
通过修改 Atlas 集群,您可以随时升级 Atlas 集群的主要版本。
本程序将指导您创建过渡集群, 以便根据新的 MongoDB 版本测试应用程序。 虽然是可选,但我们强烈建议采用此程序, 以确保您的生产应用程序尽可能平稳地过渡到新的 MongoDB 版本。
考虑因素
开始升级程序之前,需注意几点:
升级之前,您的集群必须处于正常状态。
每次只能升级 Atlas 集群的一个主要版本。 升级集群时无法跳过任何主要版本。
每个主要版本都包含一些可能无法与以前版本向后兼容的功能。升级到新的主要版本时,请查看发布说明,了解可能影响应用程序的更改。
升级 MongoDB 主版本后,将无法降级到以前的版本。
从 MongoDB 4升级。 4至 MongoDB 5 。 0对性能有潜在影响。有关更多信息,请参阅性能注意事项。
从 MongoDB 6.0 开始,
$$SEARCH_META
聚合变量不能在$searchMeta
阶段之后的任何后续阶段使用。如果您想从以前的版本升级到 MongoDB 6.0,并在 Atlas Search 使用
$searchMeta
查询中使用$$SEARCH_META
聚合变量,请在升级集群之前仔细检查,以免出错。
必需的访问权限
要升级集群,您必须对此项目拥有 Project Owner
或更高访问权限。
步骤
为过渡环境创建 Atlas 集群。
注意
如果已经有 Atlas 集群作为过渡环境,则可以跳过此步骤。
如果Clusters页面尚未显示,请单击侧边栏中的Database。
在 Clusters(数据库部署)视图中,单击 Create(创建)按钮打开集群创建模式。配置暂存集群以匹配生产集群。不必为暂存集群启用备份。
要了解如何创建新集群,请参阅创建集群。
重要
如果为暂存集群选择较小的集群层, 请考虑运行的任何性能测试 可能无法代表升级后的生产集群的性能。 您可能还需要根据 要镜像到暂存集群的数据量来选择更大的存储大小。
将您的暂存应用程序指向暂存集群。
更新暂存应用程序以指向暂存集群。有关检索暂存集群的 MongoDB 驱动程序友好连接字符串的说明,请参阅通过驱动程序连接。
确认应用程序可以成功连接到暂存集群并且应用程序按预期运行。
(可选)将您的应用程序升级到最新的 MongoDB 驱动程序。
将应用程序升级到适用于集群 MongoDB 版本的最新 MongoDB 驱动程序,就能完全使用较新 MongoDB 版本提供的功能。更新的驱动程序版本还能提高性能或稳定性。有关特定 MongoDB 版本的推荐 MongoDB 驱动程序文档和连接示例,请参阅“通过驱动程序连接”。
如果您在升级应用程序后遇到错误,请在 MongoDB 驱动程序的 JIRA 项目中提交票证。
将生产集群升级为目标 MongoDB 版本。
对过渡集群的性能和运行有信心后,对生产集群重复升级步骤。
当 Atlas 完成升级过程后, 请检查生产应用程序是否仍然连接并正常运行。
如果使用较新的 MongoDB 驱动程序升级了暂存应用程序且对性能和运行感到满意,请考虑安排一个维护期来升级您的生产应用程序。
如果升级后的生产集群出现问题, 请使用以下部分的过程提交一个高优先级支持票证。
支持主要版本升级
如果您对迁移支持有任何超出本文档范围的问题, 或者在迁移过程中遇到错误, 请通过 Atlas 用户界面提交支持工单。
要提交支持票证:
单击左侧导航栏中的 Support。
对于 Atlas Issue Category(Atlas 问题类别),选择
Other
(其他)。对于 Priority(优先级),请选择
Medium Priority
(中等优先级)。如果问题影响生产集群,请选择High Priority
(高优先级)。对于 Request Summary,在摘要中包括
Major Version Upgrade
。对于 More details,请包含与您的问题或大版本升级错误相关的所有其他详细信息。