Expansion d'un MSK cluster Amazon - Amazon Managed Streaming for Apache Kafka
Extension d'un cluster à l'aide du AWS Management ConsoleExtension d'un cluster à l'aide du AWS CLIExtension d'un cluster à l'aide d'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.

Expansion d'un MSK cluster Amazon

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

Important

Si vous souhaitez étendre un MSK cluster, assurez-vous d'utiliser cette MSK opération Amazon. 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 MSK console Amazon à l'adressehttps://console.aws.amazon.com/msk/.

  2. Choisissez le MSK cluster dont vous souhaitez augmenter le nombre de courtiers.

  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 remplaçant ClusterArn avec le nom de ressource Amazon (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 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.

    Le Target-Number-of-Brokers le 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 pour Target-Number-of-Brokers doit être un nombre entier supérieur au nombre actuel de courtiers du 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

    Le résultat de cette update-broker-count opération ressemble à ce qui suitJSON.

    {
    
    "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 avec celui ARN que vous avez obtenu dans le résultat de la update-broker-count 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": "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 d'API

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