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. # Aktualisieren Sie die Apache Kafka-Version Sie können einen vorhandenen MSK-Cluster auf eine neuere Version von Apache Kafka aktualisieren. Stellen Sie vor dem Upgrade der Kafka-Version Ihres Clusters sicher, dass die Version Ihrer clientseitigen Software die Funktionen der neuen Kafka-Version unterstützt. Informationen darüber, wie Sie einen Cluster während eines Upgrades hochverfügbar machen, finden Sie unter. [Erstellen hochverfügbarer Cluster](bestpractices.md#ensure-high-availability) **Aktualisieren Sie die Apache Kafka-Version mit dem AWS-Managementkonsole** 1. Öffnen Sie die Amazon-MSK-Konsole unter [https://console.aws.amazon.com/msk/](https://console.aws.amazon.com/msk/). 1. Wählen Sie in der Navigationsleiste die Region aus, in der Sie den MSK-Cluster erstellt haben. 1. Wählen Sie den MSK-Cluster aus, den Sie aktualisieren möchten. 1. Wählen Sie auf der ** Registerkarte ** Eigenschaften ** im ** Abschnitt ** Apache Kafka-Version die Option ** Upgrade aus. 1. Gehen Sie im ** Abschnitt ** Apache Kafka-Version wie folgt vor: 1. *Wählen Sie in der * Dropdownliste Apache Kafka-Version auswählen die Zielversion aus, auf die Sie aktualisieren möchten. Wählen Sie zum Beispiel aus **3.9.x**. 1. (Optional) Wählen Sie Versionskompatibilität ** anzeigen**, um die Kompatibilität zwischen der aktuellen Version Ihres Clusters und den verfügbaren Upgrade-Versionen zu überprüfen. Wählen Sie dann ** Auswählen aus, ** um fortzufahren. **Anmerkung** Sie können einen ZooKeeper-based Cluster in den Kraft-Modus migrieren, indem Sie eine KRaft-based Zielversion (mit einem `.kraft` Suffix) auswählen. Dadurch wird eine direkte Migration der Metadatenverwaltung Ihres Clusters von ZooKeeper zu KRAft durchgeführt. Weitere Informationen finden Sie unter [Migrieren ZooKeeper Sie vom Kraft-Modus](zk-to-kraft-migration.md). 1. (Optional) Wählen Sie das ** Kontrollkästchen Cluster-Konfiguration ** aktualisieren, um mit der neuen Version kompatible Konfigurationsupdates anzuwenden. Dadurch werden die Funktionen und Verbesserungen der neuen Version aktiviert. Sie können diesen Schritt überspringen, wenn Sie Ihre vorhandenen benutzerdefinierten Konfigurationen beibehalten müssen. **Anmerkung** Server-side Durch Upgrades werden Client-Anwendungen nicht automatisch aktualisiert. Um die Cluster-Stabilität aufrechtzuerhalten, werden Versions-Downgrades nicht unterstützt. 1. Wählen Sie ** Upgrade**, um den Vorgang zu starten. **Aktualisieren Sie die Apache Kafka-Version mit dem AWS CLI** 1. Führen Sie den folgenden Befehl aus und {{ClusterArn}} ersetzen Sie ihn durch den Amazon-Ressourcennamen (ARN), den Sie bei der Erstellung Ihres Clusters erhalten haben. Wenn Ihnen der ARN für Ihren Cluster nicht vorliegt, finden Sie ihn, indem Sie alle Cluster auflisten. Weitere Informationen finden Sie unter [Amazon MSK-Cluster auflisten](msk-list-clusters.md). ``` aws kafka get-compatible-kafka-versions --cluster-arn {{ClusterArn}} ``` Die Ausgabe dieses Befehls enthält eine Liste der Apache Kafka-Versionen, auf die Sie den Cluster aktualisieren können. Es sollte wie das folgende Beispiel aussehen. ``` { "CompatibleKafkaVersions": [ { "SourceVersion": "2.2.1", "TargetVersions": [ "2.3.1", "2.4.1", "2.4.1.1", "2.5.1" ] } ] } ``` 1. Führen Sie den folgenden Befehl aus und {{ClusterArn}} ersetzen Sie ihn durch den Amazon-Ressourcennamen (ARN), den Sie bei der Erstellung Ihres Clusters erhalten haben. Wenn Ihnen der ARN für Ihren Cluster nicht vorliegt, finden Sie ihn, indem Sie alle Cluster auflisten. Weitere Informationen finden Sie unter [Amazon MSK-Cluster auflisten](msk-list-clusters.md). {{Current-Cluster-Version}}Ersetzen Sie ihn durch die aktuelle Version des Clusters. Denn {{TargetVersion}} Sie können jede der Zielversionen aus der Ausgabe des vorherigen Befehls angeben. **Wichtig** Cluster-Versionen sind keine einfachen Ganzzahlen. Um die aktuelle Version des Clusters zu finden, verwenden Sie die [ DescribeCluster ](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster) Operation oder den Befehl [ describe-cluster ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI . `KTVPDKIKX0DER` ist ein Beispiel für eine Version. ``` aws kafka update-cluster-kafka-version --cluster-arn {{ClusterArn}} --current-version {{Current-Cluster-Version}} --target-kafka-version {{TargetVersion}} ``` Die Ausgabe des Befehls sieht wie das folgende JSON aus. ``` { "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" } ``` 1. Um das Ergebnis des `update-cluster-kafka-version` Vorgangs abzurufen, führen Sie den folgenden Befehl aus und {{ClusterOperationArn}} ersetzen Sie ihn durch den ARN, den Sie in der Ausgabe des `update-cluster-kafka-version` Befehls erhalten haben. ``` aws kafka describe-cluster-operation --cluster-operation-arn {{ClusterOperationArn}} ``` Die Ausgabe dieses `describe-cluster-operation`-Befehls sieht wie das folgende JSON-Beispiel aus. ``` { "ClusterOperationInfo": { "ClientRequestId": "62cd41d2-1206-4ebf-85a8-dbb2ba0fe259", "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2", "CreationTime": "2021-03-11T20:34:59.648000+00:00", "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef", "OperationState": "UPDATE_IN_PROGRESS", "OperationSteps": [ { "StepInfo": { "StepStatus": "IN_PROGRESS" }, "StepName": "INITIALIZE_UPDATE" }, { "StepInfo": { "StepStatus": "PENDING" }, "StepName": "UPDATE_APACHE_KAFKA_BINARIES" }, { "StepInfo": { "StepStatus": "PENDING" }, "StepName": "FINALIZE_UPDATE" } ], "OperationType": "UPDATE_CLUSTER_KAFKA_VERSION", "SourceClusterInfo": { "KafkaVersion": "2.4.1" }, "TargetClusterInfo": { "KafkaVersion": "2.6.1" } } } ``` Wenn `OperationState` den Wert „`UPDATE_IN_PROGRESS`“ aufweist, warten Sie eine Weile, bevor Sie den `describe-cluster-operation`-Befehl erneut ausführen. Wenn der Vorgang abgeschlossen ist, erhält `OperationState` den Wert `UPDATE_COMPLETE`. Da die Zeit, die Amazon MSK benötigt, um den Vorgang abzuschließen, unterschiedlich ist, müssen Sie dies möglicherweise wiederholt überprüfen, bis der Vorgang abgeschlossen ist. **Aktualisieren Sie die Apache Kafka-Version mithilfe der API** 1. Rufen Sie den [ GetCompatibleKafkaVersions ](https://docs.aws.amazon.com/msk/1.0/apireference/compatible-kafka-versions.html#GetCompatibleKafkaVersions) Vorgang auf, um eine Liste der Apache Kafka-Versionen abzurufen, auf die Sie den Cluster aktualisieren können. 1. Rufen Sie den [ UpdateClusterKafkaVersion ](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-version.html#UpdateClusterKafkaVersion) Vorgang auf, um den Cluster auf eine der kompatiblen Apache Kafka-Versionen zu aktualisieren.