기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 클러스터의 엔진 버전에 대한 패치 업데이트 수행
<a name="db-cluster-version-upgrade"></a>

이 섹션에서는 AWS Management Console 또는를 사용하여 패치 업데이트를 배포하는 방법을 설명합니다 AWS CLI. 패치 업데이트는 동일한 엔진 버전 내의 업데이트입니다(예: 3.6 엔진 버전을 최신 3.6 엔진 버전으로 업데이트). 즉시 업데이트하거나 클러스터의 다음 유지 관리 기간에 업그레이드할 수 있습니다. 엔진 업데이트가 필요한지 확인하려면 [대기 중인 유지 관리 확인](db-cluster-determine-pending-maintenance.md) 섹션을 참조하세요. 업데이트를 적용할 때 클러스터에 약간의 가동 중지 시간이 발생할 수 있다는 점에 유의하세요.

**참고**  
메이저 엔진 버전에서 다른 버전으로 업그레이드(예: 3.6에서 5.0으로)하려는 경우 [Amazon DocumentDB 인플레이스 주요 버전 업그레이드](docdb-mvu.md) 또는 [를 사용하여 Amazon DocumentDB 클러스터 업그레이드 AWS Database Migration Service](docdb-migration.versions.md)을(를) 참조하세요. 전체 메이저 버전 업그레이드는 docdb 5.0만 대상 엔진 버전으로 지원합니다.

클러스터의 엔진 버전에 대한 최신 패치 업데이트를 받으려면 다음과 같은 두 가지 구성 요구 사항이 있습니다.
+ 클러스터의 상태가 *사용 가능*이어야 합니다.
+ 클러스터가 이전 엔진 버전을 실행하고 있어야 합니다.

------
#### [ Using the AWS Management Console ]

다음 절차는 콘솔을 사용하여 클러스터의 엔진 버전에 패치 업데이트를 적용하는 것입니다. 즉시 업데이트하거나 클러스터의 다음 유지 관리 기간 중 업그레이드할 수 있습니다.

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.

1. 탐색 창에서 **클러스터**를 선택합니다. 클러스터 목록에서 업그레이드할 클러스터 왼쪽에 있는 버튼을 선택합니다. 클러스터의 상태가 *사용 가능*이어야 합니다.
**작은 정보**  
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다.

1. **작업** 메뉴에서 다음 옵션 중 하나를 선택합니다. 이러한 메뉴 옵션은 선택한 클러스터가 최신 엔진 버전을 실행하고 있지 않은 경우에만 선택할 수 있습니다.  
![\[이미지: Amazon DocumentDB 업그레이드 조치\]](http://docs.aws.amazon.com/ko_kr/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"
            }
        ]
    }
}
```

------