Augmenter le nombre de courtiers dans un cluster Amazon MSK - Amazon Managed Streaming for Apache Kafka
Étendre un cluster à l'aide de la consoleÉtendre un cluster à l'aide de la CLIÉtendre un cluster à l'aide de l'API

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.

Augmenter le nombre de courtiers dans 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.

Développez un cluster Amazon MSK à l'aide du AWS Management Console

Ce processus décrit comment augmenter le nombre de courtiers dans un cluster Amazon MSK à l'aide du AWS Management Console.

  1. Connectez-vous à la AWS Management Console console Amazon MSK et ouvrez-la https://console.aws.amazon.com/msk/chez vous ? region=us-east-1#/home/.

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

  3. Dans le menu déroulant Actions, sélectionnez Modifier le nombre de courtiers.

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

Développez un cluster Amazon MSK à l'aide du AWS CLI

Ce processus décrit comment augmenter le nombre de courtiers dans un cluster Amazon MSK à l'aide du AWS CLI.

  1. Exécutez la commande suivante, en la ClusterArn remplaç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 de plus amples informations, veuillez consulter Répertorier les 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 Target-Number-of-Brokers paramètre représente le nombre total de nœuds de courtage que vous souhaitez que le cluster possède une fois cette opération terminée avec succès. La valeur que vous spécifiez Target-Number-of-Brokers doit être un nombre entier supérieur au nombre actuel de courtiers 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 la ClusterOperationArn remplaçant 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.

Développez un cluster Amazon MSK à l'aide de l'API

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