对集群的引擎版本执行补丁更新 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

对集群的引擎版本执行补丁更新

在本节中，我们将说明如何使用 Amazon Web Services Management Console 或部署补丁更新 Amazon CLI。补丁更新是相同引擎版本内的更新（例如，将 3.6 引擎版本更新到较新的 3.6 引擎版本）。您可以立即更新它，也可以在集群的下一个维护时段进行更新。要确定您的引擎是否需要更新，请参阅 确定待处理维护。请注意，当您应用更新时，您的集群将出现短暂停机。

注意

如果您正在尝试从一个主引擎版本升级到另一个主引擎版本（例如从 3.6 升级到 5.0），请参阅 Amazon DocumentDB 主版本就地升级 或 使用升级您的亚马逊文档数据库集群 Amazon Database Migration Service。就地主版本升级仅支持将 docdb 5.0 作为目标引擎版本。

要获取集群的引擎版本的最新补丁更新，需要满足两个配置要求：

  • 集群状态必须为可用。

  • 该集群必须运行较早的引擎版本。

Using the Amazon Web Services Management Console

以下过程使用控制台对集群的引擎版本应用补丁更新。您可以选择立即更新，也可以选择在集群的下一维护时段期间更新。

  1. 登录 Amazon Web Services Management Console，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com

  2. 在导航窗格中，选择集群。在集群列表中，选择要升级的集群左侧的按钮。集群状态必须为可用。

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (Hamburger menu icon with three horizontal lines.)。

  3. 从 Actions (操作) 菜单中，选择以下选项之一。仅当您选择的集群未运行最新的引擎版本时，才可以选择这些菜单选项。

    图像：Amazon DocumentDB 升级操作

    • 立即升级 — 立即启动升级过程。集群升级到最新引擎版本时，集群将离线一段时间。

    • 在下一个时段升级 — 在集群的下一维护时段内启动升级过程。集群升级到最新引擎版本时，它将离线一段时间。

  4. 当确认窗口打开时，选择以下选项之一：

    • 升级 — 根据上一步中选择的计划将集群升级到最新引擎版本。

    • 取消 — 取消集群的引擎升级并继续使用集群的当前引擎版本。

Using the Amazon CLI

您可以使用 Amazon CLI 和带有以下参数的apply-pending-maintenance-action操作将补丁更新应用于您的集群。

参数

  • --resource-identifier – 必填项。您要升级的 Amazon DocumentDB 集群的 ARN。

  • --apply-action – 必填项。允许使用以下值。要升级集群的引擎版本，请使用 db-upgrade。

    • db-upgrade

    • system-update

  • --opt-in-type – 必填项。允许使用以下值。

    • immediate — 立即应用维护操作。

    • next-maintenance — 在下一个维护时段内应用维护操作。

    • undo-opt-in — 取消任何现有的 next-maintenance 加入请求。

以下示例将 sample-cluster 的引擎版本的补丁更新到版本 4.0.0。

对于 Linux、macOS 或 Unix：

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate

对于 Windows：

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate

此操作的输出将类似于以下内容：

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}