Expansion d'un cluster Amazon MSK

Utilisez cette opération Amazon MSK lorsque vous souhaitez augmenter le nombre d'agents dans votre cluster MSK. Pour développer un cluster, assurez-vous que son état soit ACTIVE.

Important

Si vous voulez étendre un cluster MSK, veillez à utiliser cette opération Amazon MSK. N'essayez pas d'ajouter d'agents à un cluster sans utiliser cette opération.

Pour de plus amples informations sur le rééquilibrage des partitions après avoir ajouté des agents à un cluster, veuillez consulter Réaffecter les partitions.

Extension d'un cluster à l'aide du AWS Management Console

1. Ouvrez la console Amazon MSK à l'adresse https://console.aws.amazon.com/msk/.

2. Choisissez le cluster MSK pour lequel vous souhaitez augmenter le nombre d'agents.

3. Sur la page des détails du cluster, cliquez sur le bouton Modifier en regard de l'en-tête Détails de l'agent au niveau du cluster.

4. Entrez le nombre d'agents dont le cluster doit disposer par zone de disponibilité, puis choisissez Enregistrer les modifications.

Extension d'un cluster à l'aide du AWS CLI

1. Exécutez la commande suivante, en la ClusterArnremplaçant par le Amazon Resource Name (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 plus d’informations, consultez Liste des clusters Amazon MSK.

   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.

   Le paramètre Target-Number-of-Brokers représente le nombre total de nœuds d'agents que le cluster doit avoir une fois cette opération terminée avec succès. La valeur que vous spécifiez pour Target-Number-of-Brokers doit être un nombre entier supérieur au nombre actuel d'agents dans le cluster. Il doit également être un multiple du nombre de zones de disponibilité.

   aws kafka update-broker-count --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-number-of-broker-nodes Target-Number-of-Brokers

   La sortie de cette opération update-broker-count ressemble au 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"
   }

2. Pour obtenir le résultat de l'update-broker-countopération, exécutez la commande suivante en remplaçant ClusterOperationArn par l'ARN que vous avez obtenu dans le résultat de la update-broker-count 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": "c0b7af47-8591-45b5-9c0c-909a1a2c99ea",
           "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
           "CreationTime": "2019-09-25T23:48:04.794Z",
           "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": "INCREASE_BROKER_COUNT",
           "SourceClusterInfo": {
               "NumberOfBrokerNodes": 9
           },
           "TargetClusterInfo": {
               "NumberOfBrokerNodes": 12
           }
       }
   }

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

Extension d'un cluster à l'aide de l'API

Pour augmenter le nombre de courtiers dans un cluster à l'aide de l'API, voir UpdateBrokerNombre.