Docs 菜单
Docs 主页
/
MongoDB Atlas
/ /

升级集群的 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 或更高访问权限。

1

登录后,打开您的组织,找到您的项目。

2

注意

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

  1. 如果Clusters页面尚未显示,请单击侧边栏中的Database

  2. Clusters(数据库部署)视图中,单击 Create(创建)按钮打开集群创建模式。配置暂存集群以匹配生产集群。不必为暂存集群启用备份。

要了解如何创建新集群,请参阅创建集群。

重要

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

3

注意

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

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

如果没有为生产集群启用备份,可使用“Atlas 实时导入”将生产集群的数据镜像到过渡集群。实时迁移文档包括创建过渡环境的具体说明。

4

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

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

5

将应用程序升级到适用于集群 MongoDB 版本的最新 MongoDB 驱动程序,就能完全使用较新 MongoDB 版本提供的功能。更新的驱动程序版本还能提高性能或稳定性。有关特定 MongoDB 版本的推荐 MongoDB 驱动程序文档和连接示例,请参阅“通过驱动程序连接”。

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

6
  1. 单击 Clusters(数据库部署)页面上的 Edit Config(编辑配置),然后从下拉菜单中选择您的预备集群。

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

    重要

    不能降级 Atlas 集群的 MongoDB 版本。 如果要使用原始 MongoDB 版本重新部署过渡环境, 必须终止集群,然后重新创建。

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

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

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

7

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

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

重要

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

8

对过渡集群的性能和运行有信心后,对生产集群重复升级步骤。

当 Atlas 完成升级过程后, 请检查生产应用程序是否仍然连接并正常运行。

如果使用较新的 MongoDB 驱动程序升级了暂存应用程序对性能和运行感到满意,请考虑安排一个维护期来升级您的生产应用程序。

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

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

要提交支持票证:

  1. 单击左侧导航栏中的 Support

  2. 对于 Atlas Issue Category(Atlas 问题类别),选择 Other(其他)。

  3. 对于 Priority(优先级),请选择 Medium Priority(中等优先级)。如果问题影响生产集群,请选择 High Priority(高优先级)。

  4. 对于 Request Summary,在摘要中包括 Major Version Upgrade

  5. 对于 More details,请包含与您的问题或大版本升级错误相关的所有其他详细信息。

← 在区域中断期间重新配置副本集