Erstellen Sie einen bereitgestellten Amazon MSK-Cluster mit dem AWS CLI - Amazon Managed Streaming für Apache Kafka

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen Sie einen bereitgestellten Amazon MSK-Cluster mit dem AWS CLI

  1. Kopieren Sie das folgende JSON und speichern Sie es in einer Datei. Benennen Sie die Datei brokernodegroupinfo.json. Ersetzen Sie das Subnetz IDs im JSON durch die Werte, die Ihren Subnetzen entsprechen. Diese Subnetze müssen sich in verschiedenen Availability Zones befinden. "Security-Group-ID"Ersetzen Sie durch die ID einer oder mehrerer Sicherheitsgruppen der Client-VPC. Clients, die diesen Sicherheitsgruppen zugeordnet sind, erhalten Zugriff auf den Cluster. Wenn Sie Sicherheitsgruppen angeben, die für Sie freigegeben wurden, müssen Sie sicherstellen, dass Sie über Berechtigungen für diese verfügen. Insbesondere benötigen Sie die ec2:DescribeSecurityGroups-Berechtigung. Ein Beispiel finden Sie unter Amazon EC2: Ermöglicht die programmgesteuerte Verwaltung von EC2 Amazon-Sicherheitsgruppen, die einer bestimmten VPC zugeordnet sind, sowohl programmgesteuert als auch in der Konsole. Speichern Sie abschließend die aktualisierte JSON-Datei auf dem Computer, auf dem Sie sie installiert haben. AWS CLI 

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

    Für Express-Broker benötigen Sie drei Subnetze in drei verschiedenen Availability Zones. Sie müssen auch keine speicherbezogenen Eigenschaften definieren.

    Für Standard-Broker in der Region USA West (Nordkalifornien) benötigen Sie zwei Subnetze in zwei verschiedenen Availability Zones. Für andere Regionen, in denen Amazon MSK verfügbar ist, können Sie entweder zwei oder drei Subnetze angeben. Die beiden Subnetze müssen sich in verschiedenen Availability Zones befinden. Wenn Sie einen Cluster erstellen, verteilt Amazon MSK die Broker-Knoten gleichmäßig über die von Ihnen angegebenen Subnetze.

  2. Führen Sie den folgenden AWS CLI Befehl in dem Verzeichnis aus, in dem Sie die brokernodegroupinfo.json Datei gespeichert haben, und "Your-Cluster-Name" ersetzen Sie ihn durch einen Namen Ihrer Wahl. Für "Monitoring-Level" können Sie einen der folgenden drei Werte angeben:DEFAULT,PER_BROKER, oderPER_TOPIC_PER_BROKER. Hinweise zu diesen drei verschiedenen Überwachungsbenen finden Sie unter Überwachen Sie einen von Amazon MSK bereitgestellten Cluster. Der Parameter enhanced-monitoring ist optional. Ohne weitere Angaben im create-cluster-Befehl erhalten Sie die DEFAULT-Überwachungsebene.

    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"

    Die Ausgabe des Befehls sieht wie das folgende JSON aus:

    {
    "ClusterArn": "...",
    "ClusterName": "AWSKafkaTutorialCluster",
    "State": "CREATING"
}
    Anmerkung

    Der create-cluster-Befehl gibt möglicherweise einen Fehler zurück, der besagt, dass ein oder mehrere Subnetze nicht unterstützten Availability Zones angehören. In diesem Fall gibt der Fehler an, welche Availability Zones nicht unterstützt werden. Erstellen Sie Subnetze, bei denen die nicht unterstützten Availability Zones nicht verwendet werden, und versuchen Sie es erneut mit dem create-cluster-Befehl.

  3. Speichern Sie den Wert des ClusterArn-Schlüssels, da Sie ihn zum Ausführen anderer Aktionen im Cluster benötigen.

  4. Führen Sie den folgenden Befehl aus, um einen Cluster zu überprüfen STATE. Der STATE-Wert ändert sich von CREATING zu ACTIVE, wenn Amazon MSK den Cluster bereitstellt. Wenn der Status ACTIVE lautet, können Sie die Verbindung mit dem Cluster herstellen. Weitere Informationen zu Cluster-Status finden Sie unter Verstehen Sie die Zustände der bereitgestellten MSK-Cluster.

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