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 cluster Amazon MSK
Pour mettre à jour la configuration d'un cluster, assurez-vous que l'état du cluster soit `ACTIVE`. Vous devez également veiller à ce que le nombre de partitions par agent sur votre cluster MSK est inférieur aux limites décrites dans [Dimensionnez correctement votre cluster : nombre de partitions par courtier standard](bestpractices.md#partitions-per-broker). Vous ne pouvez pas mettre à jour la configuration d'un cluster qui dépasse ces limites.
Pour des informations sur la configuration MSK, notamment sur la création d'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, veuillez consulter [Configuration provisionnée d'Amazon MSK](msk-configuration.md).
**Topics**
+ [Disponibilité du broker lors des mises à jour de configuration](#update-config-cluster-availability)
+ [Mettre à jour la configuration d'un cluster à l'aide du AWS CLI](#update-config-cli)
+ [Mettre à jour la configuration d'un cluster Amazon MSK à l'aide de l'API](#update-config-api)
## Disponibilité du broker lors des mises à jour de configuration
Amazon MSK assure une haute disponibilité lors de la plupart des mises à jour de configuration du cluster. Amazon MSK effectue une mise à jour continue dans le cadre de laquelle il met à jour un courtier à la fois. Au cours de ce processus, le cluster reste disponible, bien que les courtiers individuels redémarrent au fur et à mesure que leurs configurations sont mises à jour. Cependant, certaines modifications de configuration peuvent nécessiter la mise à jour simultanée de tous les courtiers, ce qui peut entraîner une brève interruption de service à l'échelle du cluster. Pour plus d'informations sur l'impact de la disponibilité des courtiers lors des mises à jour, consultez[Configuration provisionnée d'Amazon MSK](msk-configuration.md).
Avant de mettre à jour les clusters de production, nous vous recommandons de tester les modifications de configuration dans un environnement hors production et de planifier les mises à jour pendant vos fenêtres de maintenance.
Si vous rencontrez des problèmes lors de la mise à niveau de votre cluster MSK, consultez [Comment résoudre les problèmes lors de la mise à niveau de mon cluster Amazon MSK](https://repost.aws/knowledge-center/msk-upgrade-cluster-issues) ?
## Mettre à jour la configuration d'un cluster à l'aide du AWS CLI
1. Copiez le JSON suivant et enregistrez-le dans un fichier. Nommez le fichier `configuration-info.json`. *ConfigurationArn*Remplacez-le par le Amazon Resource Name (ARN) de la configuration que vous souhaitez utiliser pour mettre à jour le cluster. La chaîne ARN doit être entre guillemets dans le JSON suivant.
*Configuration-Revision*Remplacez-le par 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 le JSON suivant.
```
{
"Arn": ConfigurationArn,
"Revision": Configuration-Revision
}
```
1. Exécutez la commande suivante, en la *ClusterArn* remplaçant par l'ARN que vous avez obtenu lors de la création de votre cluster. Si vous n'avez pas l'ARN pour votre cluster, vous pouvez le trouver en listant tous les clusters. Pour de plus amples informations, veuillez consulter [Répertorier les clusters Amazon MSK](msk-list-clusters.md).
Remplacez *Path-to-Config-Info-File* par 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 actuel, *Path-to-Config-Info-File* c'est le cas`configuration-info.json`.
Remplacez *Current-Cluster-Version* par 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'[DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)opération ou la commande [describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) 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"
```
La sortie de cette commande `update-cluster-configuration` ressemble à l'exemple JSON 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"
}
```
1. Pour obtenir le résultat de l'`update-cluster-configuration`opération, exécutez la commande suivante en la *ClusterOperationArn* remplaçant par l'ARN que vous avez obtenu dans le résultat de la `update-cluster-configuration` commande.
```
aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
```
La sortie de cette commande `describe-cluster-operation` ressemble à l'exemple JSON 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`.
## Mettre à jour la configuration d'un cluster Amazon MSK à l'aide de l'API
Pour utiliser l'API afin de mettre à jour la configuration d'un cluster Amazon MSK, consultez [UpdateClusterConfiguration](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-configuration.html#UpdateClusterConfiguration).