View a markdown version of this page

Migrieren ZooKeeper Sie vom Kraft-Modus - Amazon Managed Streaming für Apache Kafka
VoraussetzungenWas passiert bei der Migration?Migrieren Sie mit dem AWS CLINach der Migration

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.

Migrieren ZooKeeper Sie vom Kraft-Modus

Sie können einen vorhandenen ZooKeeper-based MSK-Cluster mithilfe der UpdateClusterKafkaVersion API in den Kraft-Modus migrieren. Die Migration wird direkt durchgeführt — Ihr Cluster bleibt während des gesamten Vorgangs verfügbar und es werden keine Daten verschoben. Amazon MSK stellt Kraft-Controller bereit, migriert Cluster-Metadaten aus ZooKeeper dem Kraft-Quorum und deaktiviert Knoten automatisch. ZooKeeper

Voraussetzungen

Stellen Sie vor der Migration Ihres Clusters vom Kraft-Modus ZooKeeper in den Kraft-Modus Folgendes sicher:

  • Auf Ihrem Cluster wird die Apache Kafka-Version 3.9.x im ZooKeeper Modus ausgeführt. Wenn Ihr Cluster auf einer älteren Version läuft, führen Sie ein Upgrade auf die 3.9.x erste Version durch, indem Sie den Upgrade-Prozess der Standardversion verwenden.

  • Ihr Cluster befindet sich im ACTIVE Zustand ohne ausstehende Operationen.

  • Wenn Sie Tools verwenden, die auf direkten ZooKeeper Zugriff angewiesen sind (z. B. ältere Versionen von Cruise Control oder benutzerdefinierte Admin-Tools), aktualisieren Sie sie so, dass sie statt direkter ZooKeeper Verbindungen Kafka Admin-APIs verwenden.

  • Für Standard-Cluster (bereitgestellt): ZooKeeper Der Client-Zugriff muss deaktiviert sein. Verwenden Sie die UpdateConnectivity API zum Einrichten, ZookeeperAccess.Enabled=false bevor Sie die Migration initiieren. Express-Cluster benötigen diesen Schritt nicht.

  • Alle Client-Anwendungen verwenden die --bootstrap-server Verbindungszeichenfolge, nicht die --zookeeper Verbindungszeichenfolge. Die ZooKeeper Verbindungszeichenfolge ist nach der Migration nicht verfügbar.

  • In Ihrem Cluster sind Public Access und Open Monitoring nicht gleichzeitig aktiviert.

  • Ihr Cluster verwendet keine kafka.t3.small Broker-Instances.

  • Ihr Cluster verwendet keine dynamischen angekündigten Listener. Um zu überprüfen, ob die advertised.listeners Eigenschaft auf Ihren Brokern dynamisch festgelegt wurde, führen Sie den folgenden Befehl aus. Wo $bs ist die Bootstrap-Serververbindungszeichenfolge Ihres Clusters, und stellen Sie sicher, dass die Ausgabe Folgendes nicht enthält: advertised.listeners

    bin/kafka-configs.sh --bootstrap-server $bs --entity-type brokers --describe

    Weitere Hinweise zu dynamisch festgelegten Eigenschaften finden Sie unterDynamische Amazon MSK-Konfiguration.

Was passiert bei der Migration?

Wenn Sie eine ZooKeeper-to-KRaft Migration einleiten, führt Amazon MSK die folgenden Schritte automatisch aus:

  1. Amazon MSK stellt Kraft-Controller-Knoten in Ihrem Cluster bereit. Diese Controller sind ohne zusätzliche Kosten enthalten.

  2. Die Migration der Datenebene läuft: Die Broker werden neu konfiguriert, um das Kraft-Quorum für Metadaten zu verwenden und gleichzeitig den Kundenverkehr weiterhin abzuwickeln.

  3. Nachdem alle Broker beim Kraft-Quorum registriert sind, nimmt Amazon MSK die Knoten außer Betrieb. ZooKeeper

  4. Der Clusterverwaltungsmodus wurde auf KRAft aktualisiert.

Die Migration ist ein langwieriger Vorgang, der je nach Clustergröße mehrere Stunden dauern kann. Sie können den Betriebsstatus mithilfe der DescribeClusterOperation API überwachen.

Wichtig

Die Migration kann nicht rückgängig gemacht werden. Sobald der Cluster in den Kraft-Modus migriert wurde, können Sie ihn nicht mehr in den Modus ZooKeeper zurückschalten.

Migrieren Sie mit dem AWS CLI

  1. Überprüfen Sie die verfügbaren Zielversionen für Ihren Cluster:

    aws kafka get-compatible-kafka-versions --cluster-arn ClusterArn

    Die Ausgabe enthält Kraft-Zielversionen (mit einem .kraft Suffix), falls Ihr Cluster für eine Migration in Frage kommt.

  2. Starten Sie die Migration, indem Sie die Kraft-Zielversion angeben:

    aws kafka update-cluster-kafka-version \
    --cluster-arn ClusterArn \
    --current-version Current-Cluster-Version \
    --target-kafka-version "3.9.x.kraft"
    Wichtig

    Cluster-Versionen sind keine einfachen Ganzzahlen. Verwenden Sie die DescribeCluster Operation, um die aktuelle Version Ihres Clusters zu finden.

  3. Überwachen Sie den Fortschritt der Migration:

    aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn

    Der Betriebsstatus geht über UPDATE_IN_PROGRESS und endet mitUPDATE_COMPLETE.

Nach der Migration

Nach Abschluss der Migration:

  • Ihr Cluster arbeitet im Kraft-Modus. Alle Metadaten werden von Kraft-Controllern verwaltet.

  • ZooKeeper Knoten werden entfernt. Die ZooKeeper Verbindungszeichenfolge ist nicht mehr verfügbar.

  • Client-Anwendungen funktionieren weiterhin ohne Änderungen, wenn sie die --bootstrap-server Verbindungszeichenfolge verwenden.

  • Sie können Kraft-Controller-Endpunkte mithilfe der ListNodes API anzeigen, wenn Sie sie für die offene Überwachung benötigen.