Verfügbarkeit von Brokern Aktualisierung der Konfiguration eines Clusters mit dem AWS CLI Aktualisieren Sie die Cluster-Konfiguration mithilfe der API

Aktualisieren Sie die Konfiguration eines Amazon MSK-Clusters

Um die Konfiguration eines Clusters aktualisieren zu können, sorgen Sie dafür, dass sich der Cluster im Status ACTIVE befindet. Sie müssen außerdem sicherstellen, dass die Anzahl der Partitionen pro Broker in Ihrem MSK-Cluster unter den in Right-size Ihr Cluster: Anzahl der Partitionen pro Standard-Broker beschriebenen Grenzwerten liegt. Sie können die Konfiguration eines Clusters, der diese Grenzwerte überschreitet, nicht aktualisieren.

Informationen zur MSK-Konfiguration, einschließlich der Erstellung einer benutzerdefinierten Konfiguration, der Eigenschaften, die Sie aktualisieren können, und was passiert, wenn Sie die Konfiguration eines vorhandenen Clusters aktualisieren, finden Sie unter Von Amazon MSK bereitgestellte Konfiguration.

Themen

Verfügbarkeit des Brokers bei Konfigurationsaktualisierungen
Aktualisierung der Konfiguration eines Clusters mit dem AWS CLI
Aktualisieren Sie die Konfiguration eines Amazon MSK-Clusters mithilfe der API

Verfügbarkeit des Brokers bei Konfigurationsaktualisierungen

Amazon MSK sorgt bei den meisten Aktualisierungen der Cluster-Konfiguration für hohe Verfügbarkeit. Amazon MSK führt ein fortlaufendes Update durch, bei dem jeweils ein Broker aktualisiert wird. Während dieses Vorgangs bleibt der Cluster verfügbar, obwohl einzelne Broker neu gestartet werden, sobald ihre Konfigurationen aktualisiert werden. Bei einigen Konfigurationsänderungen müssen jedoch möglicherweise alle Broker gleichzeitig aktualisiert werden, was zu einem kurzen clusterweiten Ausfall führen kann. Weitere Informationen zu den Auswirkungen von Updates auf die Verfügbarkeit von Brokern finden Sie unter. Von Amazon MSK bereitgestellte Konfiguration

Bevor Sie Produktionscluster aktualisieren, empfehlen wir Ihnen, Ihre Konfigurationsänderungen in einer Umgebung zu testen, die nichts mit der Produktion zu tun hat, und Aktualisierungen während der Wartungsarbeiten zu planen.

Wenn Sie beim Upgrade Ihres MSK-Clusters auf Probleme stoßen, finden Sie weitere Informationen unter Wie behebe ich Probleme, wenn ich meinen Amazon MSK-Cluster aktualisiere?

Aktualisierung der Konfiguration eines Clusters mit dem AWS CLI

Kopieren Sie das folgende JSON und speichern Sie es in einer Datei. Benennen Sie die Datei configuration-info.json. ConfigurationArnErsetzen Sie die Konfiguration, die Sie zur Aktualisierung des Clusters verwenden möchten, durch den Amazon-Ressourcennamen (ARN). Die ARN-Zeichenfolge muss in Anführungszeichen im folgenden JSON erfolgen.

Configuration-RevisionErsetzen Sie durch die Version der Konfiguration, die Sie verwenden möchten. Konfigurationsrevisionen sind Ganzzahlen, die bei 1 beginnen. Diese Ganzzahl darf im folgenden JSON nicht von Anführungszeichen umgeben sein.
```
{
     "Arn": ConfigurationArn,
     "Revision": Configuration-Revision
}
```
Führen Sie den folgenden Befehl aus und ClusterArn ersetzen Sie ihn durch den 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.

Path-to-Config-Info-FileErsetzen Sie ihn durch den Pfad zu Ihrer Konfigurationsinformationsdatei. Wenn Sie die Datei, die Sie im vorherigen Schritt erstellt haben, benannt configuration-info.json und im aktuellen Verzeichnis gespeichert haben, dann Path-to-Config-Info-File ist esconfiguration-info.json.

Current-Cluster-VersionDurch die aktuelle Version des Clusters ersetzen.

Wichtig
Cluster-Versionen sind keine einfachen Ganzzahlen. Um die aktuelle Version des Clusters zu finden, verwenden Sie die DescribeCluster Operation oder den Befehl describe-cluster AWS CLI . KTVPDKIKX0DER ist ein Beispiel für eine Version.
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
Nachfolgend finden Sie ein Beispiel für der Verwendung dieses Befehls.
```
aws kafka update-cluster-configuration --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --configuration-info file://c:\users\tester\msk\configuration-info.json --current-version "K1X5R6FKA87"
```
Die Ausgabe dieses update-cluster-configuration-Befehls sieht wie das folgende JSON-Beispiel 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"
}
```

Um das Ergebnis des update-cluster-configuration 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-configuration 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": "982168a3-939f-11e9-8a62-538df00285db",
        "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
        "CreationTime": "2019-06-20T21:08:57.735Z",
        "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
        "OperationState": "UPDATE_COMPLETE",
        "OperationType": "UPDATE_CLUSTER_CONFIGURATION",
        "SourceClusterInfo": {},
        "TargetClusterInfo": {
            "ConfigurationInfo": {
                "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/ExampleConfigurationName/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1",
                "Revision": 1
            }
        }
    }
}

In dieser Ausgabe hat OperationType den Wert „UPDATE_CLUSTER_CONFIGURATION“. Wenn OperationState den Wert „UPDATE_IN_PROGRESS“ aufweist, warten Sie eine Weile, bevor Sie den describe-cluster-operation-Befehl erneut ausführen.