기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon MQ 브로커 엔진 버전 업그레이드
Amazon MQ는 지원되는 모든 브로커 엔진 유형에 대해 정기적으로 새 브로커 엔진 버전을 제공합니다. 새 엔진 버전에는 보안 패치, 버그 수정 및 기타 브로커 엔진 개선 사항이 포함되어 있습니다.
Amazon MQ는 의미 체계 버전 관리 사양에 따라 버전 번호를 `X.Y.Z`로 구성합니다. Amazon MQ 구현에서 `X`는 메이저 버전, `Y`는 마이너 버전, `Z`는 패치 버전 번호를 나타냅니다. Amazon MQ는 두 가지 유형의 업그레이드를 지원합니다.
+ **메이저 버전 업그레이드** - 메이저 엔진 버전 번호가 변경되면 발생합니다. 예를 들어 RabbitMQ 버전 **3**.13에서 버전 **4**.2로 업그레이드하는 것은 메이저 버전 업그레이드로 간주됩니다.
+ **마이너 버전 업그레이드** - 마이너 엔진 버전 번호가 변경되면 발생합니다. 예를 들어 버전 3.**11**에서 버전 3.**12**로 업그레이드하는 것은 마이너 버전 업그레이드로 간주됩니다.
언제든지 브로커를 지원되는 다음 메이저 또는 마이너 버전으로 수동으로 업그레이드할 수 있습니다. Amazon MQ는 예약된 [유지 관리 기간](maintaining-brokers.md) 동안 모든 브로커에 대해 지원되는 최신 패치 버전으로의 업그레이드를 관리합니다. 수동 및 자동 버전 업그레이드는 모두 예약된 유지 관리 기간 동안 또는 [브로커를 재부팅](amazon-mq-rebooting-broker.md)한 후에 수행됩니다. 현재 마이너 버전이 지원 종료 시점에 도달하면 Amazon MQ는 브로커를 다음 마이너 버전으로 업그레이드합니다.
## 엔진 버전 수동 업그레이드
AWS Management Console AWS CLI, 또는 Amazon MQ API를 사용하여 브로커의 엔진 버전을 업그레이드할 수 있습니다.
### AWS Management Console
**를 사용하여 브로커의 엔진 버전을 업그레이드하려면 AWS Management Console**
1. 브로커 세부 정보 페이지에서 **Edit(편집)**을 선택합니다.
1. **Specifications(사양)** 아래에서 **Broker engine version(브로커 엔진 버전)**의 드롭다운 목록에서 새 버전 번호를 선택합니다.
1. 페이지 하단으로 스크롤하고 **Schedule modifications(수정 예약)**를 선택합니다.
1. **Schedule broker modifications(브로커 수정 예약)** 페이지의 **When to apply modifications(수정을 적용할 시기)**에서 다음 중 하나를 선택합니다.
+ Amazon MQ가 예약된 다음 유지 관리 기준 중 버전 업그레이드를 완료하도록 하려면 **After the next reboot(다음 재부팅 후)**를 선택합니다.
+ 브로커를 재부팅하고 엔진 버전을 즉시 업그레이드하려면 **Immediately(즉시)**를 선택합니다.
**중요**
단일 인스턴스 브로커는 재부팅되는 동안 오프라인 상태입니다. 클러스터 브로커의 경우 브로커가 재부팅되는 동안 한 번에 하나의 노드만 다운됩니다.
1. **Apply(적용)**를 선택하여 변경 사항 적용을 완료합니다.
### AWS CLI
**를 사용하여 브로커의 엔진 버전을 업그레이드하려면 AWS CLI**
1. 다음 예제와 같이 [update-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) CLI 명령을 사용하여 다음 파라미터를 지정합니다.
+ `--broker-id` - Amazon MQ가 브로커에 대해 생성하는 고유한 ID입니다. 브로커 ARN에서 ID를 구문 분석할 수 있습니다. 예를 들어 ARN이 `arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`인 경우 브로커 ID는 `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`입니다.
+ `--engine-version` - 업그레이드할 브로커 엔진의 엔진 버전 번호입니다.
```
aws mq update-broker --broker-id broker-id --engine-version version-number
```
1. (선택 사항) 엔진 버전을 즉시 업그레이드하려면 [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) CLI 명령을 사용하여 브로커를 재부팅합니다.
```
aws mq reboot-broker --broker-id broker-id
```
브로커를 재부팅하여 변경 사항을 즉시 적용하지 않으려는 경우 Amazon MQ가 예약된 다음 유지 관리 기간 중에 브로커를 업그레이드합니다.
**중요**
단일 인스턴스 브로커는 재부팅되는 동안 오프라인 상태입니다. 클러스터 브로커의 경우 브로커가 재부팅되는 동안 한 번에 하나의 노드만 다운됩니다.
### Amazon MQ API
**Amazon MQ API를 사용하여 브로커 엔진 버전을 업그레이드하려면**
1. [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker) API 작업을 사용합니다. `broker-id`를 경로 파라미터로 지정합니다. 다음 예제에서는 브로커가 `us-west-2` 리전에 있다고 가정합니다. 사용할 수 있는 Amazon MQ 엔드포인트에 대한 자세한 내용은 *AWS 일반 참조*의 [Amazon MQ 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region)을 참조하세요.
```
PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string
```
요청 페이로드에서 `engineVersion`을 사용하여 업그레이드할 브로커의 버전 번호를 지정합니다.
```
{
"engineVersion": "engine-version-number"
}
```
1. (선택 사항) 엔진 버전을 즉시 업그레이드하려면 [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker) API 작업을 사용하여 브로커를 재부팅합니다. `broker-id`는 경로 파라미터로 지정됩니다.
```
POST /v1/brokers/broker-id/reboot-broker HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string
```
브로커를 재부팅하여 변경 사항을 즉시 적용하지 않으려는 경우 Amazon MQ가 예약된 다음 유지 관리 기간 중에 브로커를 업그레이드합니다.
**중요**
단일 인스턴스 브로커는 재부팅되는 동안 오프라인 상태입니다. 클러스터 브로커의 경우 브로커가 재부팅되는 동안 한 번에 하나의 노드만 다운됩니다.