Verfügbarkeit des Brokers Aktualisierung der Konfiguration eines Clusters mithilfe des 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 Die Größe Ihres Clusters anpassen: 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 Bereitgestellte Amazon MSK-Konfiguration.

Themen

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

Verfügbarkeit des Brokers bei Konfigurationsupdates

Amazon MSK gewährleistet während der meisten Updates der Cluster-Konfiguration eine 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 auf die Verfügbarkeit von Brokern bei Updates finden Sie unter. Bereitgestellte Amazon MSK-Konfiguration

Bevor Sie Produktionscluster aktualisieren, empfehlen wir Ihnen, Ihre Konfigurationsänderungen in einer Umgebung außerhalb der Produktionsumgebung zu testen und Updates während Ihrer Wartungsfenster zu planen.

Wenn beim Upgrade Ihres MSK-Clusters Probleme auftreten, finden Sie weitere Informationen unter Wie behebe ich Probleme beim Upgrade meines Amazon MSK-Clusters?

Aktualisierung der Konfiguration eines Clusters mithilfe des AWS CLI

Kopieren Sie das folgende JSON und speichern Sie es in einer Datei. Benennen Sie die Datei configuration-info.json. ConfigurationArnErsetzen Sie durch den Amazon-Ressourcennamen (ARN) der Konfiguration, die Sie für die Aktualisierung des Clusters verwenden möchten. 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 configuration-info.json und im aktuellen Verzeichnis gespeichert haben, benannt 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. Verwenden Sie den Befehl DescribeClusteroperation oder describe-cluster, um die aktuelle Version des Clusters AWS CLI zu finden. 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 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-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.