Disponibilité des courtiers Mettre à jour la configuration d'un cluster à l'aide du AWS CLI Mettre à jour la configuration du cluster à l'aide de l'API

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 agent standard. 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.

Rubriques

Disponibilité du broker lors des mises à jour de configuration
Mettre à jour la configuration d'un cluster à l'aide du AWS CLI
Mettre à jour la configuration d'un cluster Amazon MSK à l'aide de l'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, consultezConfiguration provisionnée d'Amazon MSK.

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 ?

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

Copiez le JSON suivant et enregistrez-le dans un fichier. Nommez le fichier configuration-info.json. ConfigurationArnRemplacez-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.

Remplacez Configuration-Revision 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
}
```
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.

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 casconfiguration-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'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"
```
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"
}
```

Pour obtenir le résultat de l'update-cluster-configurationopé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.