を使用してプロビジョニングされた Amazon MSK クラスターを作成する AWS CLI - Amazon Managed Streaming for Apache Kafka

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

を使用してプロビジョニングされた Amazon MSK クラスターを作成する AWS CLI

  1. 次の JSON をコピーして、ファイルに保存します。ファイルを brokernodegroupinfo.json と名付けます。JSON のサブネット ID を、サブネットに対応する値に置き換えます。これらのサブネットは、異なるアベイラビリティーゾーンに存在している必要があります。"Security-Group-ID" を、クライアント VPC の 1 つ以上のセキュリティグループの ID に置き換えます。これらのセキュリティグループに関連付けられたクライアントは、クラスターへのアクセスを取得します。共有されたセキュリティグループを指定する場合は、そのセキュリティグループに対するアクセス許可があることを確認する必要があります。具体的には、 ec2:DescribeSecurityGroups アクセス許可が必要です。例については、「Amazon EC2: 特定の VPC に関連付けられた Amazon EC2 セキュリティグループの管理をプログラムによりコンソールで許可する」を参照してください。最後に、 AWS CLI がインストールされているコンピュータに、更新された JSON ファイルを保存します。

    {
  "InstanceType": "kafka.m5.large",
  "ClientSubnets": [
    "Subnet-1-ID",
    "Subnet-2-ID"
  ],
  "SecurityGroups": [
    "Security-Group-ID"
  ]
}
    重要

    Express ブローカーの場合、3 つの異なるアベイラビリティーゾーンに 3 つのサブネットが必要です。また、ストレージ関連のプロパティを定義する必要はありません。

    米国西部 (北カリフォルニア) リージョンのスタンダードブローカーの場合、2 つの異なるアベイラビリティーゾーンに 2 つのサブネットが必要です。Amazon MSK が使用可能なその他のリージョンでは、サブネットを 2 つまたは 3 つ指定できます。サブネットはすべて、異なるアベイラビリティーゾーンに存在している必要があります。クラスターを作成すると、Amazon MSK により、指定したサブネット上にブローカーノードが均等に割り当てられます。

  2. brokernodegroupinfo.json ファイルを保存したディレクトリで次の AWS CLI コマンドを実行し、Your-Cluster-Name」を任意の名前に置き換えます。"Monitoring-Level" では、DEFAULT、PER_BROKER、または PER_TOPIC_PER_BROKER の 3 つの値のうちいずれかを指定できます。これらの、モニタリングの 3 つの異なるレベルについて詳しくは、「Amazon MSK プロビジョンドクラスターをモニタリングする」を参照してください enhanced-monitoring パラメータはオプションです。create-cluster コマンドでこのパラメータを指定しない場合、DEFAULT レベルのモニタリングを取得します。

    aws kafka create-cluster --cluster-name "Your-Cluster-Name" --broker-node-group-info file://brokernodegroupinfo.json --kafka-version "2.8.1" --number-of-broker-nodes 3 --enhanced-monitoring "Monitoring-Level"

    コマンドの出力は以下の JSON のようになります。

    {
    "ClusterArn": "...",
    "ClusterName": "AWSKafkaTutorialCluster",
    "State": "CREATING"
}
    注記

    create-cluster コマンドにより、1 つ以上のサブネットが、サポートされていないアベイラビリティーゾーンに属しているというエラーが返される場合があります。この場合、エラーはどのアベイラビリティーゾーンがサポートされていないかを示します。サポートされていないアベイラビリティーゾーンを使用しないサブネットを作成して、create-cluster コマンドを再度実行してください。

  3. クラスターで他のアクションを実行するために必要になるため、ClusterArn キーの値を保存します。

  4. 次のコマンドを実行して、クラスターの STATE を確認します。Amazon MSK がクラスターをプロビジョニングすると、STATE 値が CREATING から ACTIVE に変わります。状態が ACTIVE の場合、クラスターに接続できます。クラスターのステータスの詳細については、「MSK プロビジョンドクラスターの状態を理解する」を参照してください。

    aws kafka describe-cluster --cluster-arn <your-cluster-ARN>