Mise à niveau d'une version du moteur d'agent Amazon MQ - Amazon MQ
Mise à niveau manuelle de la version du moteur

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.

Mise à niveau d'une version du moteur d'agent Amazon MQ

Amazon MQ propose régulièrement de nouvelles versions de moteurs de courtage pour tous les types de moteurs de courtage pris en charge. Les nouvelles versions du moteur incluent des correctifs de sécurité, des corrections de bogues et d'autres améliorations du moteur de courtage.

Amazon MQ organise les numéros de version en fonction des spécifications de version sémantiques sous la forme. X.Y.Z Dans les implémentations d'Amazon MQ, X indique la version majeure, Y représente la version mineure et Z indique le numéro de version du correctif. Amazon MQ prend en charge deux types de mises à niveau :

  • Mise à niveau de version majeure – Survient lorsque les numéros de version majeure du moteur changent. Par exemple, la mise à niveau de RabbitMQ version 3.13 vers la version 4.2 est considérée comme une mise à niveau de version majeure.

  • Mise à niveau de version mineure – Survient lorsque seul le numéro de version du moteur mineur change. Par exemple, mise à niveau depuis la version 3. 11 à la version 3. La version 12 est considérée comme une mise à niveau mineure.

Vous pouvez à tout moment mettre à niveau manuellement votre courtier vers la prochaine version majeure ou mineure prise en charge. Amazon MQ gère la mise à niveau vers la dernière version de correctif prise en charge pour tous les courtiers pendant la période de maintenance planifiée. Les mises à niveau de version manuelles et automatiques ont lieu pendant la période de maintenance planifiée ou après le redémarrage de votre courtier. Amazon MQ met à niveau votre courtier vers la version mineure suivante lorsque le support de la version mineure actuelle atteint la fin du support.

Mise à niveau manuelle de la version du moteur

Vous pouvez mettre à niveau la version du moteur d'un broker à l'aide de l' AWS Management Console API, de AWS CLI, ou de l'API Amazon MQ.

Pour mettre à niveau la version du moteur d'un broker à l'aide du AWS Management Console

  1. Sur la page de détails de l'agent, choisissez Edit (Modifier).

  2. Sous Specifications (Spécifications), pour Broker engine version (Version du moteur de l'agent) choisissez le numéro de la nouvelle version dans la liste déroulante.

  3. Faites défiler l'écran jusqu'au bas de la page et choisissez Schedule modifications (Planifier les modifications).

  4. Dans la page Schedule broker modifications (Planifier les modifications de l'agent), pour When to apply modifications (Quand appliquer les modifications), choisissez l'une des options suivantes.

    • Choisissez After the next reboot (Après le prochain redémarrage), si vous souhaitez qu'Amazon MQ effectue la mise à niveau de version lors de la prochaine fenêtre de maintenance planifiée.

    • Choisissez Immediately (Immédiatement), si vous souhaitez redémarrer l'agent et mettre à niveau la version du moteur immédiatement.

      Important

      Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.

  5. Choisissez Apply (Appliquer)pour terminer l'application des modifications.

Pour mettre à niveau la version du moteur d'un broker à l'aide du AWS CLI

  1. Utilisez la commande CLI update-broker et spécifiez les paramètres suivants, comme illustré dans l’exemple.

    • --broker-id – ID unique généré par Amazon MQ pour l’agent. Vous pouvez analyser l’ID de votre ARN d’agent. Par exemple, avec l'ARN suivant, arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, l'ID de l'agent serait b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

    • --engine-version – Numéro de version du moteur de l'agent vers lequel effectuer la mise à niveau. 

    aws mq update-broker --broker-id broker-id --engine-version version-number

  2. (Facultatif) Utilisez la commande CLI reboot-broker pour redémarrer votre broker si vous souhaitez mettre immédiatement à niveau la version du moteur. 

    aws mq reboot-broker --broker-id broker-id

    Si vous ne souhaitez pas redémarrer votre agent et appliquer les modifications immédiatement, Amazon MQ mettra à niveau l'agent au cours de la prochaine fenêtre de maintenance planifiée.

    Important

    Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.

Pour mettre à niveau la version du moteur d'un agent à l'aide de l'API Amazon MQ

  1. Utilisez l’opération d’API UpdateBroker. Précisez broker-id comme un paramètre de chemin. Les exemples suivants supposent qu’un agent est dans la région us-west-2. Pour de plus amples informations sur les points de terminaison Amazon MQ, consultez Quotas et points de terminaison Amazon MQ dans la Références générales AWS. 

    PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

    Utilisez engineVersion dans la charge utile de la demande pour spécifier le numéro de la version vers laquelle l'agent doit effectuer la mise à niveau.

    {
    "engineVersion": "engine-version-number"
}

  2. (Facultatif) Utilisez l'opération RebootBrokerAPI pour redémarrer votre broker si vous souhaitez mettre à niveau la version du moteur immédiatement. broker-idest spécifié en tant que paramètre de chemin. 

    POST /v1/brokers/broker-id/reboot-broker HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

    Si vous ne souhaitez pas redémarrer votre agent et appliquer les modifications immédiatement, Amazon MQ mettra à niveau l'agent au cours de la prochaine fenêtre de maintenance planifiée.

    Important

    Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.