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

# Amazon MSK 클러스터의 브로커 수 확장
<a name="msk-update-broker-count"></a>

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

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

클러스터에 브로커를 추가한 후 파티션을 재분배하는 방법은 [파티션 재할당](bestpractices.md#bestpractices-balance-cluster) 단원을 참조하십시오.

## 를 사용하여 Amazon MSK 클러스터 확장 AWS Management Console
<a name="expand-cluster-console"></a>

이 프로세스는 AWS Management Console를 사용하여 Amazon MSK 클러스터의 브로커 수를 늘리는 방법을 설명합니다.

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home Amazon MSK 콘솔을 엽니다.region=us-east-1\#/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).

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

1. **작업** 드롭다운에서 **브로커 수 편집**을 선택합니다.

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

## 를 사용하여 Amazon MSK 클러스터 확장 AWS CLI
<a name="expand-cluster-cli"></a>

이 프로세스는 AWS CLI를 사용하여 Amazon MSK 클러스터의 브로커 수를 늘리는 방법을 설명합니다.

1. 다음 명령을 실행하여 {{ClusterArn}}을 클러스터 생성 후 받은 Amazon 리소스 이름(ARN)으로 바꿉니다. 클러스터에 대한 ARN이 없는 경우, 모든 클러스터를 나열하여 찾을 수 있습니다. 자세한 내용은 [Amazon MSK 클러스터 나열](msk-list-clusters.md) 단원을 참조하십시오.

   {{Current-Cluster-Version}}을 클러스터의 현재 버전으로 바꿉니다.
**중요**  
클러스터 버전은 단순한 정수가 아닙니다. 클러스터의 현재 버전을 찾으려면 [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster) 작업 또는 [describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI 명령을 사용합니다. 버전의 예를 들면 `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"
   }
   ```

1. `update-broker-count` 작업 결과를 가져오려면 다음 명령을 실행하여 {{ClusterOperationArn}}을 `update-broker-count` 명령의 출력에서 가져온 ARN으로 바꿉니다.

   ```
   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를 사용하여 Amazon MSK 클러스터 확장
<a name="expand-cluster-api"></a>

API를 사용하여 클러스터의 브로커 수를 늘리려면 [UpdateBrokerCount](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes-count.html#UpdateBrokerCount)를 참조하십시오.