기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon MSK 클러스터의 구성 업데이트
클러스터의 구성을 업데이트하려면 클러스터가 `ACTIVE` 상태인지 확인합니다. 또한 MSK 클러스터의 브로커당 파티션 수가[클러스터 크기를 적절하게 조정: Standard 브로커당 파티션 수](bestpractices.md#partitions-per-broker)에 설명된 제한 이하인지 확인해야 합니다. 제한을 초과하는 클러스터의 구성은 업데이트할 수 없습니다.
사용자 지정 구성을 생성하는 방법, 업데이트할 수 있는 속성, 기존 클러스터의 구성을 업데이트하면 나타나는 결과 등, MSK 구성에 대한 자세한 내용은 [Amazon MSK Provisioned 구성](msk-configuration.md) 단원을 참조하십시오.
**Topics**
+ [구성 업데이트 중 브로커 가용성](#update-config-cluster-availability)
+ [를 사용하여 클러스터 구성 업데이트 AWS CLI](#update-config-cli)
+ [API를 사용하여 Amazon MSK 클러스터의 구성 업데이트](#update-config-api)
## 구성 업데이트 중 브로커 가용성
Amazon MSK는 대부분의 클러스터 구성 업데이트 중에 고가용성을 유지합니다. Amazon MSK는 한 번에 하나의 브로커를 업데이트하는 롤링 업데이트를 수행합니다. 이 프로세스 중에 구성이 업데이트되면 개별 브로커가 다시 시작되지만 클러스터는 계속 사용할 수 있습니다. 그러나 일부 구성 변경의 경우 모든 브로커를 동시에 업데이트해야 할 수 있으며, 이로 인해 클러스터 전체가 잠시 중단될 수 있습니다. 업데이트 중 브로커 가용성에 미치는 영향에 대한 자세한 내용은 [Amazon MSK Provisioned 구성](msk-configuration.md) 섹션을 참조하세요.
프로덕션 클러스터를 업데이트하기 전에 비프로덕션 환경에서 구성 변경 사항을 테스트하고 유지 관리 기간 동안 업데이트를 예약하는 것이 좋습니다.
MSK 클러스터를 업그레이드하는 동안 문제가 발생하는 경우 [Amazon MSK 클러스터를 업그레이드할 때 문제를 해결하려면 어떻게 해야 하나요?](https://repost.aws/knowledge-center/msk-upgrade-cluster-issues)를 참조하세요.
## 를 사용하여 클러스터 구성 업데이트 AWS CLI
1. 다음 JSON을 복사하여 파일에 저장합니다. 파일 이름을 `configuration-info.json`으로 지정합니다. {{ConfigurationArn}}을 클러스터 업데이트에 사용할 구성의 Amazon 리소스 이름(ARN)으로 바꿉니다. ARN 문자열은 다음 JSON에서 인용 부호로 묶여야 합니다.
{{Configuration-Revision}}은 사용할 구성의 개정으로 바꿉니다. 구성 개정은 `1` 이상의 정수입니다. 이 정수는 다음 JSON에서 인용 부호로 묶이면 안 됩니다.
```
{
"Arn": {{ConfigurationArn}},
"Revision": {{Configuration-Revision}}
}
```
1. 다음 명령을 실행하여 {{ClusterArn}}을 클러스터 생성 후 받은 ARN으로 바꿉니다. 클러스터에 대한 ARN이 없는 경우, 모든 클러스터를 나열하여 찾을 수 있습니다. 자세한 내용은 [Amazon MSK 클러스터 나열](msk-list-clusters.md) 단원을 참조하십시오.
{{Path-to-Config-Info-File}}은 구성 정보 파일의 경로로 바꿉니다. 이전 `configuration-info.json`단계에서 생성한 파일의 이름을 지정하여 현재 디렉터리에 저장한 경우 {{Path-to-Config-Info-File}}은 `configuration-info.json`입니다.
{{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`입니다.
```
aws kafka update-cluster-configuration --cluster-arn {{ClusterArn}} --configuration-info file://{{Path-to-Config-Info-File}} --current-version {{Current-Cluster-Version}}
```
다음은 이 명령을 사용하는 방법을 보여주는 예제입니다.
```
aws kafka update-cluster-configuration --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --configuration-info file://c:\users\tester\msk\configuration-info.json --current-version "K1X5R6FKA87"
```
이 `update-cluster-configuration` 명령의 출력은 다음 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-cluster-configuration` 작업 결과를 가져오려면 다음 명령을 실행하여 {{ClusterOperationArn}}을 `update-cluster-configuration` 명령의 출력에서 가져온 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:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
"CreationTime": "2019-06-20T21:08:57.735Z",
"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_CLUSTER_CONFIGURATION",
"SourceClusterInfo": {},
"TargetClusterInfo": {
"ConfigurationInfo": {
"Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/ExampleConfigurationName/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1",
"Revision": 1
}
}
}
}
```
이 출력에서 `OperationType`은 `UPDATE_CLUSTER_CONFIGURATION`입니다. `OperationState` 값이 `UPDATE_IN_PROGRESS`인 경우, 잠시 기다린 다음 `describe-cluster-operation` 명령을 다시 실행합니다.
## API를 사용하여 Amazon MSK 클러스터의 구성 업데이트
API를 사용하여 Amazon MSK 클러스터의 구성을 업데이트하려면 [UpdateClusterConfiguration](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-configuration.html#UpdateClusterConfiguration)을 참조하세요.