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
-
Copiez ce qui suit JSON et enregistrez-le dans un fichier. Nommez le fichier
configuration-info.json
. RemplacezConfigurationArn
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
} -
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édenteconfiguration-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-versionCurrent-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" }
-
Pour obtenir le résultat de l'
update-cluster-configuration
opération, exécutez la commande suivante en remplaçantClusterOperationArn
avec celui ARN que vous avez obtenu dans le résultat de laupdate-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
estUPDATE_CLUSTER_CONFIGURATION
. SiOperationState
a la valeurUPDATE_IN_PROGRESS
, attendez un moment, puis exécutez à nouveau la commandedescribe-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.