Amazon MSK 클러스터 확장

MSK 클러스터의 브로커 수를 늘리려는 경우 이 Amazon MSK 작업을 사용합니다. 클러스터를 확장하려면 해당 클러스터가 ACTIVE 상태인지 확인합니다.

중요

MSK 클러스터를 확장하려면 이 Amazon MSK 작업을 사용합니다. 이 작업을 사용하지 않고 클러스터에 브로커를 추가하지 마십시오.

클러스터에 브로커를 추가한 후 파티션을 재분배하는 방법은 파티션 재할당 단원을 참조하십시오.

를 사용하여 클러스터를 확장합니다. AWS Management Console

1. https://console.aws.amazon.com/msk/에서 Amazon MSK 콘솔을 엽니다.

2. 브로커 수를 늘리려는 MSK 클러스터를 선택합니다.

3. 클러스터 상세 정보 페이지에서 클러스터 수준 브로커 세부 정보 제목 옆에 있는 편집 버튼을 선택합니다.

4. 가용 영역당 클러스터가 보유할 브로커 수를 입력한 다음 변경 사항 저장을 선택합니다.

를 사용하여 클러스터 확장 AWS CLI

1. 클러스터를 생성할 때 받은 Amazon 리소스 이름 (ARN) ClusterArn으로 대체하여 다음 명령을 실행합니다. 클러스터에 대한 ARN이 없는 경우, 모든 클러스터를 나열하여 찾을 수 있습니다. 자세한 정보는 Amazon MSK 클러스터 나열을 참조하세요.

   Current-Cluster-Version을 클러스터의 현재 버전으로 바꿉니다.

   중요

   클러스터 버전은 단순한 정수가 아닙니다. 클러스터의 현재 버전을 찾으려면 DescribeCluster작업 또는 AWS CLI describe-cluster 명령을 사용하십시오. 버전의 예를 들면 KTVPDKIKX0DER입니다.

   Target-Number-of-Brokers 파라미터는 이 작업을 성공적으로 완료하여 클러스터에 포함하고자 하는 총 브로커 노드 수를 나타냅니다. Target-Number-of-Brokers에 지정하는 값은 클러스터의 현재 브로커 수보다 큰 정수여야 합니다. 또한 가용 영역 수의 배수여야 합니다.

   aws kafka update-broker-count --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-number-of-broker-nodes Target-Number-of-Brokers

   이 update-broker-count 작업의 출력은 다음 JSON과 같습니다.

   {
       
       "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
       "ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
   }

2. update-broker-count작업 결과를 가져오려면 명령 출력에서 가져온 ClusterOperationArnARN으로 대체하여 다음 명령을 실행합니다. update-broker-count

   aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn

   이 describe-cluster-operation 명령의 출력은 다음 JSON 예제와 같습니다.

   {
       "ClusterOperationInfo": {
           "ClientRequestId": "c0b7af47-8591-45b5-9c0c-909a1a2c99ea",
           "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
           "CreationTime": "2019-09-25T23:48:04.794Z",
           "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
           "OperationState": "UPDATE_COMPLETE",
           "OperationType": "INCREASE_BROKER_COUNT",
           "SourceClusterInfo": {
               "NumberOfBrokerNodes": 9
           },
           "TargetClusterInfo": {
               "NumberOfBrokerNodes": 12
           }
       }
   }

   이 출력에서 OperationType은 INCREASE_BROKER_COUNT입니다. OperationState 값이 UPDATE_IN_PROGRESS인 경우, 잠시 기다린 다음 describe-cluster-operation 명령을 다시 실행합니다.

API를 사용하여 클러스터 확장

API를 사용하여 클러스터의 브로커 수를 늘리려면 을 참조하십시오. UpdateBrokerCount