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

# 对集群的引擎版本执行补丁更新
<a name="db-cluster-version-upgrade"></a>

在本节中，我们将说明如何使用 AWS 管理控制台 或部署补丁更新 AWS CLI。补丁更新是相同引擎版本内的更新（例如，将 3.6 引擎版本更新到较新的 3.6 引擎版本）。您可以立即更新它，也可以在集群的下一个维护时段进行更新。要确定您的引擎是否需要更新，请参阅 [确定待处理维护](db-cluster-determine-pending-maintenance.md)。请注意，当您应用更新时，您的集群将出现短暂停机。

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

要获取集群的引擎版本的最新补丁更新，需要满足两个配置要求：
+ 集群状态必须为*可用*。
+ 该集群必须运行较早的引擎版本。

------
#### [ Using the AWS 管理控制台 ]

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

1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)

1. 在导航窗格中，选择**集群**。在集群列表中，选择要升级的集群左侧的按钮。集群状态必须为*可用*。
**提示**  
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 从 **Actions (操作)** 菜单中，选择以下选项之一。仅当您选择的集群未运行最新的引擎版本时，才可以选择这些菜单选项。  
![\[图像：Amazon DocumentDB 升级操作\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
   + **立即升级**：立即启动升级过程。集群升级到最新引擎版本时，集群将离线一段时间。
   + **在下一个时段升级**：在集群的下一维护时段内启动升级过程。集群升级到最新引擎版本时，它将离线一段时间。

1. 当确认窗口打开时，选择以下选项之一：
   + **升级**：根据上一步中选择的计划将集群升级到最新引擎版本。
   + **取消**：取消集群的引擎升级并继续使用集群的当前引擎版本。

------
#### [ Using the AWS CLI ]

您可以使用 AWS 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` 加入请求。

**Example**  
以下示例将 `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"
            }
        ]
    }
}
```

------