기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon MQ 브로커 인스턴스 유형 업그레이드
**중요**
`mq.m7g.x` 인스턴스는 RabbitMQ용 Amazon MQ 브로커에서만 사용할 수 있습니다. ActiveMQ용 Amazon MQ 브로커는 `mq.m5.x` 인스턴스만 사용합니다.
브로커 인스턴스 클래스(`m7g`) 및 크기(`large`)의 설명 조합은 브로커 인스턴스 유형(예: `mq.m7g.large`)입니다. 인스턴스 유형을 선택할 때는 브로커 성능에 영향을 미치는 다음과 같은 요인을 고려하는 것이 중요합니다.
+ 클라이언트 및 대기열 수
+ 전송된 메시지의 양
+ 메모리에 보관된 메시지
+ 중복 메시지
작은 브로커 인스턴스 유형(`mq.m7g.medium`)은 애플리케이션 성능을 테스트할 때만 사용하는 것이 좋습니다. 프로덕션 수준의 클라이언트 및 대기열, 높은 처리량, 메모리 내 메시지, 중복 메시지에 대해서는 더 큰 브로커 인스턴스 유형(`mq.m7g.large ` 이상)을 권장합니다.
성능 문제가 발생하거나 테스트에서 프로덕션 환경으로 이동하는 경우 더 큰 인스턴스 유형(예: `micro`에서 `large`로)으로 업그레이드하는 것이 좋습니다. 인스턴스 유형을 업그레이드하려면 AWS Management Console, AWS CLI 또는 Amazon MQ API를 사용할 수 있습니다.
## AWS Management Console
**AWS Management Console을 사용하여 더 큰 인스턴스 유형으로 업그레이드하려면 다음을 수행합니다.**
1. [Amazon MQ 콘솔](https://console.aws.amazon.com/amazon-mq/)에 로그인합니다.
1. 왼쪽 탐색 창에서 **브로커**를 선택한 다음 목록에서 을 업그레이드할 브로커를 선택합니다.
1. 브로커 세부 정보 페이지에서 **Edit(편집)**을 선택합니다.
1. **사양**의 **브로커 인스턴스 유형**에서 드롭다운 목록의 새 인스턴스 유형을 선택합니다.
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. 다음 예제와 같이 [modify-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) CLI 명령을 사용하여 다음 파라미터를 지정합니다.
+ `--broker-id` - Amazon MQ가 브로커에 대해 생성하는 고유한 ID입니다.
+ `--host-instance-type` - 업그레이드할 브로커 엔진의 엔진 버전 번호입니다.
```
aws mq modify-broker --broker-id {{broker-id}} --host-instance-type {{instance-type}}
```
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}}
```
요청 페이로드에서 `host-instance-type`을 사용하여 업그레이드할 브로커의 인스턴스 유형을 지정합니다.
```
{
"host-instance-type": "{{host-instance-type}}"
}
```
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가 예약된 다음 유지 관리 기간 중에 브로커를 업그레이드합니다.
**중요**
단일 인스턴스 브로커는 재부팅되는 동안 오프라인 상태입니다. 클러스터 브로커의 경우 브로커가 재부팅되는 동안 한 번에 하나의 노드만 다운됩니다.