Redémarrer un broker pour un cluster Amazon MSK

Utilisez cette opération Amazon MSK lorsque vous souhaitez redémarrer un agent pour votre cluster MSK. Pour redémarrer un agent pour un cluster, assurez-vous que le cluster est dans l'état ACTIVE.

Le service Amazon MSK peut redémarrer les agents de votre cluster MSK pendant la maintenance du système, telle que l'application de correctifs ou les mises à niveau de version. Le redémarrage manuel d'un agent vous permet de tester la résilience de vos clients Kafka afin de déterminer comment ils répondent à la maintenance du système.

Redémarrez un courtier pour un cluster Amazon MSK à l'aide du AWS Management Console

Ce processus décrit comment redémarrer un courtier pour un cluster Amazon MSK à 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 dont vous souhaitez redémarrer l'agent.

3. Faites défiler la page jusqu'à la section Informations de l'agent et choisissez l'agent que vous souhaitez redémarrer.

4. Cliquez sur le bouton Redémarrer l'agent.

Redémarrez un courtier pour un cluster Amazon MSK à l'aide du AWS CLI

Ce processus décrit comment redémarrer un courtier pour 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, puis BrokerId par l'ID du broker que vous souhaitez redémarrer.

   Note

   L'opération reboot-broker prend uniquement en charge le redémarrage d'un agent à la fois.

   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.

   Si vous ne disposez pas du courtier IDs pour votre cluster, vous pouvez le trouver en répertoriant les nœuds du courtier. Pour plus d'informations, consultez list-nodes.

   aws kafka reboot-broker --cluster-arn ClusterArn --broker-ids BrokerId

   La sortie de cette opération reboot-broker 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'reboot-brokeropération, exécutez la commande suivante en la ClusterOperationArn remplaçant par l'ARN que vous avez obtenu dans le résultat de la reboot-broker 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": "REBOOT_IN_PROGRESS",
           "OperationType": "REBOOT_NODE",
           "SourceClusterInfo": {},
           "TargetClusterInfo": {}
       }
   }

Lorsque l'opération de redémarrage est terminée, l'opération OperationState devient REBOOT_COMPLETE.

Redémarrez un courtier pour un cluster Amazon MSK à l'aide de l'API

Pour redémarrer un courtier dans un cluster à l'aide de l'API, consultez RebootBroker.