Amazon MSKクラスター内のブローカーの数を拡張する - Amazon Managed Streaming for Apache Kafka

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon MSKクラスター内のブローカーの数を拡張する

MSK クラスター内のブローカーの数を増やす場合は、この Amazon MSKオペレーションを使用します。クラスターを拡張するには、クラスターが ACTIVE 状態であることを確認します。

重要

MSK クラスターを拡張する場合は、必ずこの Amazon MSKオペレーションを使用してください。このオペレーションを使用せずにクラスターにブローカーを追加しようとしないでください。

ブローカーをクラスターに追加した後にパーティションを再調整する方法については、「パーティションの再割り当て」を参照してください 。

を使用して Amazon MSKクラスターを拡張する AWS Management Console

このプロセスでは、 を使用して Amazon MSKクラスター内のブローカーの数を増やす方法について説明します AWS Management Console。

  1. にサインインし AWS Management Console、Amazon MSKコンソールをhttps://console.aws.amazon.com/msk/ホーム?region=us-east-1#/home/ で開きます。

  2. ブローカーの数を増やすMSKクラスターを選択します。

  3. クラスターの詳細ページで、[Cluster-Level Broker Details] (クラスターレベルのブローカーの詳細) の見出しの隣にある[Edit] (編集) を選択します。

  4. クラスターに必要なブローカーの数を各アベイラビリティーゾーンごと入力したら、[Save changes] (変更を保存) を選択します。

を使用して Amazon MSKクラスターを拡張する AWS CLI

このプロセスでは、 を使用して Amazon MSKクラスター内のブローカーの数を増やす方法について説明します AWS CLI。

  1. 次のコマンドを実行し、 をクラスターの作成時に取得した Amazon リソースネーム (ARN) ClusterArnに置き換えます。クラスターARNに がない場合は、すべてのクラスターを一覧表示することで見つけることができます。詳細については、「Amazon MSKクラスターを一覧表示する」を参照してください。

    Current-Cluster-Version を現在のクラスターのバージョンに置き換えます。

    重要

    クラスターのバージョンは単純な整数ではありません。クラスターの最新バージョンを検索するには、 DescribeClusterオペレーションまたは describe-cluster 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" }
  2. update-broker-count オペレーションの結果を取得するには、次のコマンドを実行し、 をupdate-broker-countコマンドの出力でARN取得した ClusterOperationArnに置き換えます。

    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 } } }

    この出力では、OperationTypeINCREASE_BROKER_COUNT です。OperationState の値が UPDATE_IN_PROGRESS の場合は、しばらく待ってから再度 describe-cluster-operation コマンドを実行します。

を使用して Amazon MSKクラスターを拡張する API

を使用してクラスター内のブローカーの数を増やすにはAPI、「」を参照してくださいUpdateBrokerCount