Amazon MSK クラスターの拡張 - Amazon Managed Streaming for Apache Kafka

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

Amazon MSK クラスターの拡張

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

重要

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

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

を使用したクラスターの拡張 AWS Management Console

  1. https://console.aws.amazon.com/msk/ で Amazon MSK コンソールを開きます。

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

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

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

を使用したクラスターの拡張 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 コマンドを実行します。

API を使用したクラスターの拡張

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