엔진 버전 수동 업그레이드 마이너 엔진 버전 자동 업그레이드 엔진 버전 지원 종료 캘린더

Amazon MQ 브로커 엔진 버전 업그레이드

Amazon MQ는 지원되는 모든 브로커 엔진 유형에 맞는 새 브로커 엔진 버전을 정기적으로 제공합니다. 새 엔진 버전에는 보안 패치, 버그 수정 및 기타 브로커 엔진 개선 사항이 포함됩니다.

Amazon MQ는 시맨틱 버전 관리 사양에 따라 버전 번호를 다음과 같이 구성합니다. X.Y.Z Amazon MQ 구현에서 메이저 버전, X 마이너 버전, 패치 버전 번호를 Y Z 나타냅니다. 업그레이드 유형은 다음 두 가지입니다.

메이저 버전 업그레이드 - 메이저 엔진 버전 번호가 변경되면 발생합니다. 예를 들어 버전 1.0에서 버전 2.0으로 업그레이드하는 것은 메이저 버전 업그레이드로 간주됩니다.
마이너 버전 업그레이드 - 마이너 엔진 버전 번호가 변경되면 발생합니다. 예를 들어 버전 1에서 업그레이드할 수 있습니다. 5에서 버전 1로 6은 마이너 버전 업그레이드로 간주됩니다.

각 특정 브로커 엔진 유형의 메이저 및 마이너 버전 관리에 대한 자세한 내용은 다음 주제를 참조하세요.

언제든지 지원되는 다음 메이저 또는 마이너 버전으로 브로커를 수동으로 업그레이드할 수 있습니다. 자동 마이너 버전 업그레이드를 활성화하면 Amazon MQ가 브로커를 지원되는 최신 패치 버전으로 업그레이드합니다. 엔진 버전 3.13 이상을 사용하는 모든 브로커의 경우 Amazon MQ는 유지 관리 기간 동안 지원되는 최신 패치 버전으로의 업그레이드를 관리합니다. Amazon MQ는 현재 마이너 버전의 지원이 종료되면 브로커를 다음 마이너 버전으로 업그레이드합니다.

수동 및 자동 버전 업그레이드는 모두 예약된 유지 관리 기간 중이나 브로커 재부팅 후에 발생합니다.

다음 주제에서는 브로커 엔진 버전을 수동으로 업그레이드하고 마이너 버전 자동 업그레이드를 활성화하는 방법에 대해 설명합니다.

엔진 버전 수동 업그레이드

브로커의 엔진 버전을 새 메이저 또는 마이너 버전으로 수동으로 업그레이드하려면 AWS CLI, 또는 Amazon MQ API를 사용할 수 있습니다. AWS Management Console

다음을 사용하여 브로커의 엔진 버전을 업그레이드하려면 AWS Management Console

Amazon MQ 콘솔에 로그인합니다.
왼쪽 탐색 창에서 브로커를 선택한 다음 목록에서 을 업그레이드할 브로커를 선택합니다.
브로커 세부 정보 페이지에서 Edit(편집)을 선택합니다.
Specifications(사양) 아래에서 Broker engine version(브로커 엔진 버전)의 드롭다운 목록에서 새 버전 번호를 선택합니다.
페이지 하단으로 스크롤하고 Schedule modifications(수정 예약)를 선택합니다.
Schedule broker modifications(브로커 수정 예약) 페이지의 When to apply modifications(수정을 적용할 시기)에서 다음 중 하나를 선택합니다.
- Amazon MQ가 예약된 다음 유지 관리 기준 중 버전 업그레이드를 완료하도록 하려면 After the next reboot(다음 재부팅 후)를 선택합니다.
- 브로커를 재부팅하고 엔진 버전을 즉시 업그레이드하려면 Immediately(즉시)를 선택합니다.
  
  중요
  브로커가 재부팅되는 동안 오프라인 상태가 됩니다.
Apply(적용)를 선택하여 변경 사항 적용을 완료합니다.

다음을 사용하여 브로커의 엔진 버전을 업그레이드하려면 AWS CLI

다음 예제와 같이 update-broker 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
```
(선택 사항) 엔진 버전을 즉시 업그레이드하려는 경우 reboot-broker CLI 명령을 사용하여 브로커를 재부팅합니다.
```
aws mq reboot-broker --broker-id broker-id
```
브로커를 재부팅하여 변경 사항을 즉시 적용하지 않으려는 경우 Amazon MQ가 예약된 다음 유지 관리 기간 중에 브로커를 업그레이드합니다.

중요
브로커가 재부팅되는 동안 오프라인 상태가 됩니다.

Amazon MQ API를 사용하여 브로커 엔진 버전을 업그레이드하려면

UpdateBroker API 작업을 사용합니다. broker-id를 경로 파라미터로 지정합니다. 다음 예제에서는 브로커가 us-west-2 리전에 있다고 가정합니다. 사용할 수 있는 Amazon MQ 엔드포인트에 대한 자세한 내용은 AWS 일반 참조의 Amazon MQ 엔드포인트 및 할당량을 참조하세요.
```
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"
}
```
(선택 사항) 엔진 버전을 즉시 업그레이드하려면 RebootBrokerAPI 작업을 사용하여 브로커를 재부팅하십시오. 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가 예약된 다음 유지 관리 기간 중에 브로커를 업그레이드합니다.

중요
브로커가 재부팅되는 동안 오프라인 상태가 됩니다.

마이너 엔진 버전 자동 업그레이드

브로커를 처음 생성할 때나 브로커 기본 설정을 수정하여 브로커에서 마이너 버전 자동 업그레이드를 활성화할지 여부를 제어할 수 있습니다. 기존 브로커의 자동 마이너 버전 업그레이드를 활성화하려면 AWS Management Console AWS CLI, 또는 Amazon MQ API를 사용할 수 있습니다.

를 사용하여 자동 마이너 버전 업그레이드를 활성화하려면 AWS Management Console

Amazon MQ 콘솔에 로그인합니다.
왼쪽 탐색 창에서 브로커를 선택한 다음 목록에서 을 업그레이드할 브로커를 선택합니다.
브로커 세부 정보 페이지에서 Edit(편집)을 선택합니다.
Maintenance(유지 관리) 아래에서 Enable automatic minor version upgrades(마이너 버전 자동 업그레이드 활성화)를 선택합니다.

참고
옵션이 이미 선택되어 있으면 변경할 필요가 없습니다.
페이지 하단에서 [Save(저장하기)]를 선택합니다.

를 통해 자동 마이너 버전 업그레이드를 활성화하려면 update-broker CLI 명령을 사용하고 다음 매개변수를 지정합니다. AWS 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입니다.
--auto-minor-version-upgrade - 마이너 버전 자동 업그레이드 옵션을 활성화합니다.


aws mq update-broker --broker-id broker-id --auto-minor-version-upgrade

브로커의 마이너 버전 자동 업그레이드를 비활성화하려면 --no-auto-minor-version-upgrade 파라미터를 사용합니다.

Amazon MQ API를 통해 자동 마이너 버전 업그레이드를 활성화하려면 API 작업을 사용하십시오. UpdateBroker broker-id를 경로 파라미터로 지정합니다. 다음 예제에서는 브로커가 us-west-2 리전에 있다고 가정합니다. 사용할 수 있는 Amazon MQ 엔드포인트에 대한 자세한 내용은 AWS 일반 참조의 Amazon MQ 엔드포인트 및 할당량을 참조하세요.


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

요청 페이로드에 autoMinorVersionUpgrade 속성을 사용하여 마이너 버전 자동 업그레이드를 활성화합니다.


{
    "autoMinorVersionUpgrade": "true"
}

브로커의 마이너 버전 자동 업그레이드를 비활성화하려면 요청 페이로드에 "autoMinorVersionUpgrade": "false"를 설정합니다.

엔진 버전 지원 종료 캘린더

Amazon MQ 버전 지원 종료 캘린더는 브로커 엔진 버전의 지원 종료 시점을 알려줍니다. 엔진 버전이 지원 종료에 도달하면 Amazon MQ는 이 버전의 모든 브로커를 사용 가능한 다음 버전으로 자동 업데이트합니다. Amazon MQ는 엔진 버전의 지원이 종료되기 최소 90일 전에 알림을 제공합니다.

버전 지원 일정을 보려면 ActiveMQ용 Amazon MQ 엔진 버전 관리 ActiveMQ용 Amazon MQ 및 RabbitMQ용 Amazon MQ 엔진 버전 관리 RabbitMQ용 Amazon MQ를 참조하십시오.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

브로커 유지 관리

브로커 상태