Mise à niveau d'une version du moteur d'agent Amazon MQ - Amazon MQ
Mise à niveau manuelle de la version du moteurMise à niveau automatique de la version mineure 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. Il existe 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 la version 1.0 vers la version 2.0 est considérée comme une mise à niveau 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 1. 5 vers la version 1. La version 6 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. Lorsque vous activez les mises à niveau automatiques des versions mineures, Amazon MQ met à niveau votre courtier vers la dernière version de correctif prise en charge. Pour tous les courtiers utilisant la version 3.13 du moteur ou une version ultérieure, Amazon MQ gère les mises à niveau vers la dernière version de correctif prise en charge pendant la période de maintenance. Amazon MQ met à niveau votre courtier vers la version mineure suivante lorsque le support de la version mineure actuelle atteint la fin du support. Les mises à niveau des versions manuelles et automatiques se produisent pendant la fenêtre de maintenance planifiée ou après le redémarrage de votre agent.

Les rubriques suivantes décrivent comment vous pouvez mettre à niveau manuellement la version du moteur de l'agent et activer les mises à niveau automatiques de version mineure.

Mise à niveau manuelle de la version du moteur

Pour mettre à niveau manuellement la version du moteur d'un broker vers une nouvelle version majeure ou mineure, vous pouvez utiliser l'API AWS Management Console Amazon MQ ou l'API Amazon MQ. AWS CLI

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

  1. Connectez-vous à la console Amazon MQ.

  2. Dans le panneau de navigation de gauche, choisissezBrokers (Agents), puis choisissez l’agent que vous souhaitez mettre à niveau dans la liste.

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

  4. 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.

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

  6. 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.

  7. 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 de CLI reboot-broker pour redémarrer votre agent si vous souhaitez mettre à niveau la version du moteur immédiatement. 

    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.

Mise à niveau automatique de la version mineure du moteur

Vous pouvez contrôler si la mise à niveau automatique de version mineure est activée pour un agent lorsque vous créez l'agent, ou en modifiant les préférences de l'agent. Pour activer les mises à niveau automatiques des versions mineures pour un broker existant, vous pouvez utiliser l' AWS Management Console AWS CLI API Amazon MQ ou l'API Amazon MQ.

Pour activer les mises à niveau automatiques des versions mineures à l'aide du AWS Management Console

  1. Connectez-vous à la console Amazon MQ.

  2. Dans le panneau de navigation de gauche, choisissezBrokers (Agents), puis choisissez l’agent que vous souhaitez mettre à niveau dans la liste.

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

  4. Sous Maintenance, choisissez Enable automatic minor version upgrades (Activer les mises à niveau automatiques des versions).

    Note

    Si cette option est déjà sélectionnée, aucune modification n'est nécessaire.

  5. En bas de la page, sélectionnez Save (Enregistrer).

Pour activer les mises à niveau automatiques des versions mineures via le AWS CLI, utilisez la commande update-broker CLI et spécifiez les paramètres suivants.

  • --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.

  • --auto-minor-version-upgrade – Active l'option de mise à niveau automatique des versions mineures. 

aws mq update-broker --broker-id broker-id --auto-minor-version-upgrade

Si vous souhaitez désactiver les mises à niveau automatiques de version mineure pour votre agent, utilisez le paramètre --no-auto-minor-version-upgrade.

Pour activer les mises à niveau automatiques des versions mineures via l'API Amazon MQ, utilisez l'opération UpdateBrokerAPI. Spécifiez 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

Utilisation de la propriété autoMinorVersionUpgrade dans la charge utile de la demande pour activer la mise à niveau automatique de la version mineure.

{
    "autoMinorVersionUpgrade": "true"
}

Si vous souhaitez désactiver les mises à niveau automatiques de version mineure pour votre agent, définissez "autoMinorVersionUpgrade": "false" dans la charge utile de la demande.