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. # Unterstützung für Amazon MSK-Versionen In diesem Thema werden die [Support-Richtlinie für Amazon MSK-Versionen](#version-support-policy) und das Verfahren für [Aktualisieren Sie die Apache Kafka-Version](version-upgrades.md) beschrieben. Wenn Sie Ihre Kafka-Version aktualisieren, befolgen Sie die unter beschriebenen bewährten Methoden. [Bewährte Methoden für Versionsupgrades](version-upgrades-best-practices.md) **Topics** + [ ## Support-Richtlinie für Amazon MSK-Versionen ](#version-support-policy) + [ # Aktualisieren Sie die Apache Kafka-Version ](version-upgrades.md) + [ # Bewährte Methoden für Versionsupgrades ](version-upgrades-best-practices.md) ## Support-Richtlinie für Amazon MSK-Versionen In diesem Abschnitt werden die Support-Richtlinien für von Amazon MSK unterstützte Kafka-Versionen beschrieben. + Alle Kafka-Versionen werden bis zum Ende des Supports unterstützt. Einzelheiten zu den Terminen, an denen der Support endet, finden Sie unter[Unterstützte Apache Kafka-Versionen](supported-kafka-versions.md). Führen Sie vor Ablauf des Supportzeitraums ein Upgrade Ihres MSK-Clusters auf die empfohlene Kafka-Version oder eine höhere Version durch. Einzelheiten zum Upgrade Ihrer Apache Kafka-Version finden Sie unter. [Aktualisieren Sie die Apache Kafka-Version](version-upgrades.md) Ein Cluster, der nach Ablauf des Supports eine Kafka-Version verwendet, wird automatisch auf die empfohlene Kafka-Version aktualisiert. Automatische Upgrades können jederzeit nach Ablauf des Supports erfolgen. Sie erhalten vor dem Upgrade keine Benachrichtigung. + MSK wird die Unterstützung für neu erstellte Cluster, die Kafka-Versionen verwenden, auslaufen lassen, wobei das Ende des Supports veröffentlicht wurde. # 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 können, 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 ein Upgrade durchführen 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** Amazon MSK unterstützt direkte Upgrades auf die meisten Apache Kafka-Versionen. Wenn Sie jedoch von einer ZooKeeper basierten Kafka-Version auf eine KRaft basierte Version aktualisieren, müssen Sie einen neuen Cluster erstellen. Kopieren Sie dann Ihre Daten in den neuen Cluster und wechseln Sie mit den Clients zum neuen Cluster. 1. (Optional) Aktivieren Sie das Kontrollkästchen **Clusterkonfiguration 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** Bei serverseitigen Upgrades werden Client-Anwendungen nicht automatisch aktualisiert. Um die Clusterstabilitä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 durch die aktuelle Version des Clusters. Denn *TargetVersion* Sie können eine der Zielversionen aus der Ausgabe des vorherigen Befehls angeben. **Wichtig** Cluster-Versionen sind keine einfachen Ganzzahlen. Verwenden Sie den Befehl [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)operation oder [describe-cluster, um die aktuelle Version des Clusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI zu finden. `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 zu erhalten, 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. # Bewährte Methoden für Versionsupgrades Um die Kontinuität der Clients während des fortlaufenden Updates sicherzustellen, das im Rahmen des Kafka-Versionsupgrade-Prozesses durchgeführt wird, sollten Sie die Konfiguration Ihrer Clients und die Themen zu Apache Kafka wie folgt überprüfen: + Stellen Sie den Themenreplikationsfaktor (RF) auf einen Mindestwert von `2` für Zwei-AZ-Cluster und einen Mindestwert von `3` für Drei-AZ-Cluster ein. Ein RF-Wert von `2` kann dazu führen, dass Partitionen während des Patchens offline sind. + Stellen Sie die Mindestanzahl an synchronisierten Replikaten (minISR) auf einen Höchstwert ein, der um 1 unter Ihrem Replikationsfaktor (RF) liegt, d. h. `miniISR = (RF) - 1` Dadurch wird sichergestellt, dass der Partitionsreplikatsatz tolerieren kann, dass ein Replikat offline ist oder zu wenig repliziert wird. + Konfigurieren Sie Clients so, dass sie mehrere Broker-Verbindungszeichenfolgen verwenden. Wenn die Verbindungszeichenfolge eines Clients mehrere Broker enthält, ist ein Failover möglich, falls ein bestimmter Broker, der den Client unterstützt, I/O mit dem Patchen beginnt. Informationen zum [Abrufen einer Verbindungszeichenfolge mit mehreren Brokern finden Sie unter Bootstrap-Broker für einen Amazon MSK-Cluster](https://docs.aws.amazon.com//msk/latest/developerguide/msk-get-bootstrap-brokers.html) abrufen. + Wir empfehlen, die Verbindungsclients auf die empfohlene Version oder höher zu aktualisieren, um von den Funktionen der neuen Version zu profitieren. Client-Upgrades unterliegen nicht dem Ende der Lebensdauer (EOL) der Kafka-Version Ihres MSK-Clusters und müssen auch nicht bis zum EOL-Datum abgeschlossen sein. Apache Kafka bietet eine [bidirektionale Client-Kompatibilitätsrichtlinie](https://kafka.apache.org/protocol#protocol_compatibility), die es älteren Clients ermöglicht, mit neueren Clustern zu arbeiten und umgekehrt. + Kafka-Clients, die die Versionen 3.x.x verwenden, verfügen wahrscheinlich über die folgenden Standardwerte: und. `acks=all` `enable.idempotence=true` `acks=all`unterscheidet sich von der vorherigen Standardeinstellung von `acks=1` und bietet zusätzliche Haltbarkeit, indem sichergestellt wird, dass alle synchronisierten Replikate die Produktionsanforderung bestätigen. In ähnlicher Weise `enable.idempotence` war die Standardeinstellung für zuvor. `false` Die Änderung `enable.idempotence=true` zur Standardeinstellung verringert die Wahrscheinlichkeit doppelter Nachrichten. Diese Änderungen gelten als bewährte Einstellungen und können zu einer geringen zusätzlichen Latenz führen, die innerhalb der normalen Leistungsparameter liegt. + Verwenden Sie die empfohlene Kafka-Version, wenn Sie neue MSK-Cluster erstellen. Wenn Sie die empfohlene Kafka-Version verwenden, können Sie von den neuesten Kafka- und MSK-Funktionen profitieren.