Amazon MSK 클러스터의 구성 업데이트 - Amazon Managed Streaming for Apache Kafka

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

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

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

사용자 지정 구성을 생성하는 방법, 업데이트할 수 있는 속성, 기존 클러스터의 MSK 구성을 업데이트할 때 발생하는 작업 등 구성에 대한 자세한 내용은 섹션을 참조하세요Amazon MSK 구성.

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

  1. 다음을 복사JSON하여 파일에 저장합니다. 파일 이름을 configuration-info.json로 지정합니다. Replace ConfigurationArn 클러스터를 업데이트하는 데 사용할 구성의 Amazon 리소스 이름(ARN)을 사용합니다. ARN 문자열은 다음 에서 따옴표로 표시되어야 합니다JSON.

    Replace Configuration-Revision 사용하려는 구성의 개정을 사용합니다. 구성 개정은 1 이상의 정수입니다. 이 정수는 다음 에서 따옴표로 표시해서는 안 됩니다JSON.

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

  2. 다음 명령을 실행하여 ClusterArn 클러스터를 생성할 때 ARN 얻은 를 사용합니다. 클러스터에 ARN 대한 이 없는 경우 모든 클러스터를 나열하여 찾을 수 있습니다. 자세한 내용은 Amazon MSK 클러스터 나열 단원을 참조하십시오.

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

    Replace Current-Cluster-Version 클러스터의 현재 버전을 사용합니다.

    중요

    클러스터 버전은 단순한 정수가 아닙니다. 클러스터의 현재 버전을 찾으려면 DescribeCluster 작업 또는 describe-cluster 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" }
  3. 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 } } } }

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

를 사용하여 Amazon MSK 클러스터의 구성 업데이트 API

API 를 사용하여 Amazon MSK 클러스터의 구성을 업데이트하려면 섹션을 참조하세요UpdateClusterConfiguration.