기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon MSK 클러스터 브로커 크기 업데이트
Apache Kafka 파티션을 재할당하지 않고도 브로커의 크기를 변경하여 온디맨드 방식으로 MSK 클러스터의 규모를 조정할 수 있습니다. 브로커 크기를 변경하면 클러스터 I/O를 중단하지 않고도 워크로드 변화에 따라 MSK 클러스터의 컴퓨팅 용량을 유연하게 조정할 수 있습니다. Amazon MSK는 지정된 클러스터의 모든 브로커에 대해 동일한 브로커 크기를 사용합니다.
Standard 브로커의 경우 클러스터 브로커 크기를 M5 또는 T3에서 M7g로, T3에서 M5로 또는 M7g에서 M5로 업데이트할 수 있습니다.
**참고**
더 큰 브로커 크기에서 더 작은 브로커 크기로 마이그레이션할 수 없습니다. 예: M7g.large에서 T3.small.
Express 브로커의 경우 M7g 브로커 크기만 사용할 수 있습니다.
이 주제에서는 MSK 클러스터의 브로커 크기를 업데이트하는 방법을 설명합니다.
더 작은 브로커 크기로 마이그레이션하면 성능이 저하되고 브로커당 달성 가능한 최대 처리량이 감소할 수 있습니다. 더 큰 브로커 크기로 마이그레이션하면 성능이 향상될 수 있지만 비용이 더 커질 수 있습니다.
브로커 크기 업데이트는 클러스터가 실행되는 동안 롤링 방식으로 이루어집니다. 즉, Amazon MSK는 브로커 크기 업데이트를 수행하기 위해 한 번에 하나의 브로커를 중단합니다. 브로커 크기 업데이트 중에 클러스터를 고가용성으로 만드는 방법에 대한 자세한 내용은 [고가용성 클러스터 빌드](bestpractices.md#ensure-high-availability) 단원을 참조하세요. 생산성에 미칠 수 있는 잠재적 영향을 더욱 줄이려면 트래픽이 적은 기간에 브로커 크기 업데이트를 수행하면 됩니다.
브로커 크기 업데이트 중 데이터를 계속 생성하고 사용할 수 있습니다. 그러나 업데이트가 완료될 때까지 기다려야 브로커를 재부팅하거나 [Amazon MSK 작업](https://docs.aws.amazon.com/msk/1.0/apireference/operations.html) 아래에 나열된 업데이트 작업을 호출할 수 있습니다.
클러스터를 더 작은 브로커 크기로 업데이트하려는 경우 먼저 테스트 클러스터에서 업데이트를 시도하여 시나리오에 어떤 영향을 미치는지 확인하는 것이 좋습니다.
**중요**
브로커당 파티션 수가 [클러스터 크기를 적절하게 조정: Standard 브로커당 파티션 수](bestpractices.md#partitions-per-broker)에 지정된 최대 수를 초과하는 경우에는 클러스터를 더 작은 브로커 크기로 업데이트할 수 없습니다.
**Topics**
+ [를 사용하여 Amazon MSK 클러스터 브로커 크기 업데이트 AWS Management Console](#update-broker-type-console)
+ [를 사용하여 Amazon MSK 클러스터 브로커 크기 업데이트 AWS CLI](#update-broker-type-cli)
+ [API를 사용하여 브로커 크기 업데이트](#update-broker-type-api)
## 를 사용하여 Amazon MSK 클러스터 브로커 크기 업데이트 AWS Management Console
이 프로세스는를 사용하여 Amazon MSK 클러스터 브로커 크기를 업데이트하는 방법을 보여줍니다. AWS Management Console
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) Amazon MSK 콘솔을 엽니다.
1. 브로커 크기를 업데이트할 MSK 클러스터를 선택합니다.
1. 클러스터의 세부 정보 페이지에서 **브로커 요약 섹션**을 찾아 **브로커 크기 편집**을 선택합니다.
1. 목록에서 원하는 브로커 크기를 선택합니다.
1. 변경 내용을 저장합니다.
## 를 사용하여 Amazon MSK 클러스터 브로커 크기 업데이트 AWS CLI
다음 명령을 실행하여 *ClusterArn*을 클러스터 생성 후 받은 Amazon 리소스 이름(ARN)으로 바꿉니다. 클러스터에 대한 ARN이 없는 경우, 모든 클러스터를 나열하여 찾을 수 있습니다. 자세한 내용은 [Amazon MSK 클러스터 나열](msk-list-clusters.md) 단원을 참조하십시오.
1. *Current-Cluster-Version*을 클러스터의 현재 버전으로 변경하고 *TargetType*을 브로커가 될 새 크기로 변경합니다. 브로커 크기에 대해 자세히 알아보려면 [Amazon MSK 브로커 유형](broker-instance-types.md) 단원을 참조하세요.
```
aws kafka update-broker-type --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-instance-type TargetType
```
다음은 이 명령을 사용하는 방법을 보여주는 예제입니다.
```
aws kafka update-broker-type --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --current-version "K1X5R6FKA87" --target-instance-type kafka.m5.large
```
이 명령의 출력은 다음 JSON 예제와 같습니다.
```
{
"ClusterArn": "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1",
"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-type` 작업 결과를 가져오려면 다음 명령을 실행하여 *ClusterOperationArn*을 `update-broker-type` 명령의 출력에서 가져온 ARN으로 바꿉니다.
```
aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
```
이 `describe-cluster-operation` 명령의 출력은 다음 JSON 예제와 같습니다.
```
{
"ClusterOperationInfo": {
"ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
"ClusterArn": "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1",
"CreationTime": "2021-01-09T02:24:22.198000+00:00",
"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": "UPDATE_BROKER_TYPE",
"SourceClusterInfo": {
"InstanceType": "t3.small"
},
"TargetClusterInfo": {
"InstanceType": "m5.large"
}
}
}
```
`OperationState` 값이 `UPDATE_IN_PROGRESS`인 경우, 잠시 기다린 다음 `describe-cluster-operation` 명령을 다시 실행합니다.
## API를 사용하여 브로커 크기 업데이트
API를 사용하여 브로커 크기를 업데이트하려면 [UpdateBrokerType](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-nodes-type.html#UpdateBrokerType)을 참조하세요.
`UpdateBrokerType`을 사용하여 클러스터 브로커 크기를 M5 또는 T3에서 M7g로 업데이트하거나 M7g에서 M5로 업데이트할 수 있습니다.