Mise à niveau d'un type d'instance de courtier Amazon MQ - Amazon MQ

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'un type d'instance de courtier Amazon MQ

Important

mq.m7g.xles instances ne sont disponibles que pour Amazon MQ pour les courtiers RabbitMQ. Les courtiers Amazon MQ pour ActiveMQ utilisent uniquement des instances. mq.m5.x

La description combinée de la classe d'instance de courtier (m7g) et de la taille (large) est appelée type d'instance de courtier (par exemple,mq.m7g.large). Lorsque vous choisissez un type d'instance, il est important de prendre en compte les facteurs qui affecteront les performances du courtier :

  • le nombre de clients et de files d'attente

  • le volume de messages envoyés

  • messages conservés en mémoire

  • messages redondants

Les types d'instances de broker plus petits (mq.m7g.medium) sont recommandés uniquement pour tester les performances des applications. Nous recommandons des types d'instances de broker plus grands (mq.m7g.large et supérieurs) pour les niveaux de production des clients et des files d'attente, le débit élevé, les messages en mémoire et les messages redondants.

Nous vous recommandons de passer à un type d'instance plus important (c'est-à-dire de micro verslarge) si vous rencontrez des problèmes de performances ou si vous passez d'un environnement de test à un environnement de production. Pour mettre à niveau votre type d'instance, vous pouvez utiliser l'API AWS Management Console AWS CLI, la ou l'API Amazon MQ.

Pour effectuer une mise à niveau vers un type d'instance plus important à l'aide du AWS Management Console, procédez comme suit :

  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 Details (Informations), choisissez Edit (Modifier).

  4. Sous Spécifications, pour le type d'instance Broker, choisissez le nouveau type d'instance dans la liste déroulante.

  5. Au bas de la page, sélectionnez 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 Après le prochain redémarrage, si vous souhaitez qu'Amazon MQ termine la mise à niveau lors de la prochaine fenêtre de maintenance planifiée.

    • Choisissez Immédiatement si vous souhaitez redémarrer le broker et mettre à niveau le type d'instance 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 le type d'instance d'un courtier à l'aide du AWS CLI

  1. Utilisez la commande modify-broker CLI et spécifiez les paramètres suivants, comme indiqué dans l'exemple.

    • --broker-id – ID unique généré par Amazon MQ pour l’agent.

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

    aws mq modify-broker --broker-id broker-id --host-instance-type instance-type

  2. (Facultatif) Utilisez la commande CLI reboot-broker pour redémarrer votre courtier si vous souhaitez mettre à niveau le type d'instance 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 le type d'instance d'un broker à 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 plus d'informations sur les points de terminaison Amazon MQ disponibles, consultez la section Points de terminaison et quotas Amazon MQ dans le. 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

    host-instance-typeÀ utiliser dans la charge utile de la demande pour spécifier le type d'instance vers lequel le broker doit effectuer la mise à niveau.

    {
    "host-instance-type": "host-instance-type"
}

  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.