Actualización de un tipo de instancia del agente de Amazon MQ - Amazon MQ

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Actualización de un tipo de instancia del agente de Amazon MQ

importante

Las instancias mq.m7g.x solo están disponibles en Amazon MQ para agentes de RabbitMQ. Los agentes de Amazon MQ para ActiveMQ solo usan instancias mq.m5.x.

La descripción combinada de la instancia del agente clase (m7g) y tamaño (large) es un tipo de instancias del agente (por ejemplo, mq.m7g.large). Al elegir un tipo de instancia, es importante tener en cuenta los factores que afectarán al rendimiento del agente:

  • el número de clientes y colas

  • el volumen de mensajes enviados

  • mensajes guardados en la memoria

  • mensajes redundantes

Se recomienda usar los tipos de instancias de agente más pequeños (mq.m7g.medium) para probar el rendimiento de las aplicaciones. Asimismo, se aconsejan los tipos de instancias de agente más grandes (mq.m7g.large o superiores) para los niveles de producción de clientes y colas, rendimientos altos, los mensajes en memoria y los mensajes redundantes.

Le recomendamos que actualice a un tipo de instancia mayor (es decir, de micro a large) si tiene problemas de rendimiento o si va a pasar de un entorno de pruebas a un entorno de producción. Para actualizar el tipo de instancia, puede usar la Consola de administración de AWS, la AWS CLI o la API de Amazon MQ.

Para actualizar a un tipo de instancia más grande a través de la Consola de administración de AWS, haga lo siguiente:

  1. Inicie sesión en la consola de Amazon MQ.

  2. En el panel de navegación izquierdo, elija Brokers (Agentes) y seleccione el agente que desea actualizar de la lista.

  3. En la página de detalles del agente, elija Edit (Editar).

  4. En Specifications (Especificaciones), para el tipo de instancia del agente, elija el nuevo tipo de instancia en la lista desplegable.

  5. En la parte inferior de la página y elija Schedule modifications (Programar modificaciones).

  6. En la página Schedule broker modifications(Programar modificaciones del agente), para When to apply modifications (Cuándo aplicar modificaciones), elija una de las siguientes opciones.

    • Seleccione After the next reboot (Después del próximo reinicio) si desea que Amazon MQ complete la actualización durante el próximo período de mantenimiento programado.

    • Seleccione Immediately (De inmediato) si desea reiniciar el agente y actualizar el tipo de instancia inmediatamente.

      importante

      Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.

  7. Seleccione Apply (Aplicar) para terminar de aplicar los cambios.

Para actualizar el tipo de instancia de un agente a través de la AWS CLI

  1. Use el comando modify-broker de la CLI y especifique los siguientes parámetros, como se muestra en el ejemplo.

    • --broker-id: ID único que genera Amazon MQ para el agente.

    • --host-instance-type: número de versión de motor al que se va a actualizar el motor del agente. 

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

  2. (Opcional) Utilice el comando reboot-broker de la CLI para reiniciar su agente si desea actualizar el tipo de instancia de inmediato. 

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

    Si no desea reiniciar el agente y aplicar los cambios de inmediato, Amazon MQ lo actualizará durante el próximo período de mantenimiento programado.

    importante

    Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.

Para actualizar el tipo de instancia de un agente a través de la API de Amazon MQ

  1. Utilice la operación UpdateBroker de la API. Especifique broker-id como parámetro de ruta. En los siguientes ejemplos, se asume que el agente está en la región us-west-2. Para obtener más información acerca de los puntos de conexión de Amazon MQ disponibles, consulte cuotas y puntos de conexión de Amazon MQ en Referencia general de 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

    Utilice host-instance-type en la carga útil de la solicitud para especificar el tipo de instancia al que se va a actualizar el agente.

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

  2. (Opcional) Utilice la operación RebootBroker de la API para reiniciar su agente si desea actualizar la versión de motor de inmediato. Se especifica broker-id como parámetro de ruta. 

    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 no desea reiniciar el agente y aplicar los cambios de inmediato, Amazon MQ lo actualizará durante el próximo período de mantenimiento programado.

    importante

    Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.