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 オペレーションの結果を取得するには、次のコマンドを実行し、ClusterOperationArn をupdate-broker-countコマンドの出力で取得した ARN に置き換えます。

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

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

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

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