Amazon MSK 클러스터 구성 업데이트

클러스터의 구성을 업데이트하려면 클러스터가 ACTIVE 상태인지 확인합니다. 또한 MSK 클러스터의 브로커당 파티션 수가 클러스터 크기를 적절하게 조정: 브로커당 파티션 수에 설명된 제한 이하인지 확인해야 합니다. 제한을 초과하는 클러스터의 구성은 업데이트할 수 없습니다.

사용자 지정 구성을 생성하는 방법, 업데이트할 수 있는 속성, 기존 클러스터의 구성을 업데이트하면 나타나는 결과 등, MSK 구성에 대한 자세한 내용은 Amazon MSK 구성 단원을 참조하십시오.

를 사용하여 클러스터 구성 업데이트 AWS CLI

1. 다음 JSON을 복사하여 파일에 저장합니다. 파일 이름을 configuration-info.json로 지정합니다. 클러스터를 업데이트하는 데 사용할 구성의 Amazon 리소스 이름 (ARN) ConfigurationArn으로 대체하십시오. ARN 문자열은 다음 JSON에서 인용 부호로 묶여야 합니다.

   Configuration-Revision은 사용할 구성의 개정으로 바꿉니다. 구성 개정은 1 이상의 정수입니다. 이 정수는 다음 JSON에서 인용 부호로 묶이면 안 됩니다.

   {
        "Arn": ConfigurationArn,
        "Revision": Configuration-Revision
   }

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

   Path-to-Config-Info-File은 구성 정보 파일의 경로로 바꿉니다. 이전 configuration-info.json단계에서 생성한 파일의 이름을 지정하여 현재 디렉터리에 저장한 경우 Path-to-Config-Info-File은 configuration-info.json입니다.

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

   중요

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

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

   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를 사용하여 클러스터 구성 업데이트

API를 사용하여 클러스터 구성을 업데이트하려면 을 참조하십시오 UpdateClusterConfiguration.