Mettre à jour la configuration d'un MSK cluster Amazon - Amazon Managed Streaming for Apache Kafka

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mettre à jour la configuration d'un MSK cluster Amazon

Pour mettre à jour la configuration d'un cluster, assurez-vous que l'état du cluster soit ACTIVE. Vous devez également vous assurer que le nombre de partitions par broker sur votre MSK cluster est inférieur aux limites décrites dans Dimensionnez correctement votre cluster : nombre de partitions par agent. Vous ne pouvez pas mettre à jour la configuration d'un cluster qui dépasse ces limites.

Pour plus d'informations sur la MSK configuration, notamment comment créer une configuration personnalisée, les propriétés que vous pouvez mettre à jour et ce qui se passe lorsque vous mettez à jour la configuration d'un cluster existant, consultezMSKConfiguration d'Amazon.

Mettre à jour la configuration d'un cluster à l'aide du AWS CLI

  1. Copiez ce qui suit JSON et enregistrez-le dans un fichier. Nommez le fichier configuration-info.json. Remplacez ConfigurationArn avec le nom de ressource Amazon (ARN) de la configuration que vous souhaitez utiliser pour mettre à jour le cluster. La ARN chaîne doit être entre guillemets dans ce qui suitJSON.

    Remplacez Configuration-Revision avec la révision de la configuration que vous souhaitez utiliser. Les révisions de configuration sont des entiers (nombres entiers) qui commencent à 1. Cet entier ne doit pas être entre guillemets dans ce qui suitJSON.

    { "Arn": ConfigurationArn, "Revision": Configuration-Revision }

  2. Exécutez la commande suivante en remplaçant ClusterArn avec celui ARN que vous avez obtenu lors de la création de votre cluster. Si vous n'en avez pas ARN pour votre cluster, vous pouvez le trouver en listant tous les clusters. Pour de plus amples informations, veuillez consulter Répertorier les MSK clusters Amazon.

    Remplacez Path-to-Config-Info-File avec le chemin d'accès à votre fichier d'informations de configuration. Si vous avez nommé le fichier que vous avez créé à l'étape précédente configuration-info.json et que vous l'avez enregistré dans le répertoire en cours, Path-to-Config-Info-File estconfiguration-info.json.

    Remplacez Current-Cluster-Version avec la version actuelle du cluster.

    Important

    Les versions de cluster ne sont pas des entiers simples. Pour trouver la version actuelle du cluster, utilisez l'DescribeClusteropération ou la commande describe-cluster AWS CLI . Voici un exemple de version : KTVPDKIKX0DER.

    aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version

    Voici un exemple qui montre comment utiliser la commande :

    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"

    Le résultat de cette update-cluster-configuration commande ressemble à l'JSONexemple suivant.

    { "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" }
  3. Pour obtenir le résultat de l'update-cluster-configurationopération, exécutez la commande suivante en remplaçant ClusterOperationArn avec celui ARN que vous avez obtenu dans le résultat de la update-cluster-configuration commande.

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

    Le résultat de cette describe-cluster-operation commande ressemble à l'JSONexemple suivant.

    { "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 } } } }

    Dans cette sortie, OperationType est UPDATE_CLUSTER_CONFIGURATION. Si OperationState a la valeur UPDATE_IN_PROGRESS, attendez un moment, puis exécutez à nouveau la commande describe-cluster-operation.

Mettez à jour la configuration d'un MSK cluster Amazon à l'aide du API

Pour utiliser le API pour mettre à jour la configuration d'un MSK cluster Amazon, consultez UpdateClusterConfiguration.