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

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

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는 현재 마이너 버전의 지원이 종료되면 브로커를 다음 마이너 버전으로 업그레이드합니다. 수동 및 자동 버전 업그레이드는 모두 예약된 유지 관리 기간 중이나 브로커 재부팅 후에 발생합니다.

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

엔진 버전 수동 업그레이드

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

다음을 사용하여 브로커의 엔진 버전을 업그레이드하려면 AWS Management Console
  1. Amazon MQ 콘솔에 로그인합니다.

  2. 왼쪽 탐색 창에서 브로커를 선택한 다음 목록에서 을 업그레이드할 브로커를 선택합니다.

  3. 브로커 세부 정보 페이지에서 Edit(편집)을 선택합니다.

  4. Specifications(사양) 아래에서 Broker engine version(브로커 엔진 버전)의 드롭다운 목록에서 새 버전 번호를 선택합니다.

  5. 페이지 하단으로 스크롤하고 Schedule modifications(수정 예약)를 선택합니다.

  6. Schedule broker modifications(브로커 수정 예약) 페이지의 When to apply modifications(수정을 적용할 시기)에서 다음 중 하나를 선택합니다.

    • Amazon MQ가 예약된 다음 유지 관리 기준 중 버전 업그레이드를 완료하도록 하려면 After the next reboot(다음 재부팅 후)를 선택합니다.

    • 브로커를 재부팅하고 엔진 버전을 즉시 업그레이드하려면 Immediately(즉시)를 선택합니다.

      중요

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

  7. Apply(적용)를 선택하여 변경 사항 적용을 완료합니다.

다음을 사용하여 브로커의 엔진 버전을 업그레이드하려면 AWS CLI
  1. update-broker CLI 명령을 사용하고 예제에 표시된 대로 다음 매개 변수를 지정합니다.

    • --broker-id - Amazon MQ가 브로커에 대해 생성하는 고유한 ID입니다. 브로커에서 ID를 파싱할 수 있습니다. ARN 예를 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
  2. (선택 사항) 엔진 버전을 즉시 업그레이드하려면 reboot-broker CLI 명령을 사용하여 브로커를 재부팅하십시오.

    aws mq reboot-broker --broker-id broker-id

    브로커를 재부팅하여 변경 사항을 즉시 적용하지 않으려는 경우 Amazon MQ가 예약된 다음 유지 관리 기간 중에 브로커를 업그레이드합니다.

    중요

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

Amazon MQ를 사용하여 브로커의 엔진 버전을 업그레이드하려면 API
  1. UpdateBrokerAPI작업을 사용하십시오. 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" }
  2. (선택 사항) 엔진 버전을 즉시 업그레이드하려면 이 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 CLI, 또는 Amazon API MQ를 사용할 수 있습니다. AWS Management Console

를 사용하여 자동 마이너 버전 업그레이드를 활성화하려면 AWS Management Console
  1. Amazon MQ 콘솔에 로그인합니다.

  2. 왼쪽 탐색 창에서 브로커를 선택한 다음 목록에서 을 업그레이드할 브로커를 선택합니다.

  3. 브로커 세부 정보 페이지에서 Edit(편집)을 선택합니다.

  4. Maintenance(유지 관리) 아래에서 Enable automatic minor version upgrades(마이너 버전 자동 업그레이드 활성화)를 선택합니다.

    참고

    옵션이 이미 선택되어 있으면 변경할 필요가 없습니다.

  5. 페이지 하단에서 [Save(저장하기)]를 선택합니다.

를 통해 자동 마이너 버전 업그레이드를 활성화하려면 update-broker CLI 명령을 사용하고 다음 매개 변수를 지정합니다. AWS CLI

  • --broker-id - Amazon MQ가 브로커에 대해 생성하는 고유한 ID입니다. 브로커에서 ID를 분석할 수 있습니다. ARN 예를 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 API MQ를 통해 자동 마이너 버전 업그레이드를 활성화하려면 작업을 사용하십시오. UpdateBrokerAPI 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"를 설정합니다.