Actualización de una versión del motor del agente de Amazon MQ

Amazon MQ proporciona periódicamente nuevas versiones de motores de intermediación para todos los tipos de motores de intermediación compatibles. Las nuevas versiones del motor incluyen parches de seguridad, correcciones de errores y otras mejoras en el motor de intermediación.

Amazon MQ organiza los números de versión de acuerdo con las especificaciones de control de versiones semánticas como. X.Y.Z En las implementaciones de Amazon MQ, X indica la versión principal, Y representa la versión secundaria e Z indica el número de versión del parche. Existen dos tipos de actualizaciones:

• Actualización de versión principal: se produce cuando cambian los números de la versión de motor principal. Por ejemplo, la actualización de la versión 1.0 a la versión 2.0 se considera una actualización de la versión principal.

• Actualización de versión secundaria: se produce cuando solo cambia el número de la versión de motor secundaria. Por ejemplo, actualizar desde la versión 1. 5 a la versión 1. La versión 6 se considera una actualización de versión menor.

Puede actualizar manualmente su bróker en cualquier momento a la siguiente versión principal o secundaria compatible. Al activar las actualizaciones automáticas de las versiones secundarias, Amazon MQ actualizará su agente a la última versión de parche compatible. Para todos los corredores que utilizan la versión 3.13 o superior del motor, Amazon MQ gestiona las actualizaciones a la última versión de parche compatible durante el período de mantenimiento. Amazon MQ actualiza su agente a la siguiente versión secundaria cuando la versión secundaria actual llega al final del soporte. Las actualizaciones manuales y automáticas de las versiones se producen durante el periodo de mantenimiento programado o después de que reinicie su agente.

En los siguientes temas, se describe cómo puede actualizar manualmente la versión de motor del agente y activar actualizaciones automáticas de versiones secundarias.

Actualización manual de la versión del motor

Para actualizar manualmente la versión del motor de un bróker a una nueva versión principal o secundaria AWS Management Console, puede utilizar Amazon MQAPI. AWS CLI

AWS Management Console

Para actualizar la versión de motor de un bróker mediante la AWS Management Console

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. Dentro de Specifications (Especificaciones), en Broker engine version (Versión de motor del agente), elija el número de la versión nueva de la lista desplegable.

5. Desplácese a 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 de versiones durante el próximo periodo de mantenimiento programado.

   • Seleccione Immediately (De inmediato) si desea reiniciar el agente y actualizar la versión del motor inmediatamente.

     importante

     El agente se quedará sin conexión mientras se reinicia.

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

AWS CLI

Para actualizar la versión de motor de un bróker mediante el AWS CLI

1. Utilice el CLI comando update-broker y especifique los siguientes parámetros, como se muestra en el ejemplo.

   • --broker-id: ID único que genera Amazon MQ para el agente. Puede analizar el ID de su bróker. ARN Por ejemplo, dado lo siguiente ARNarn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, el ID del corredor seríab-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

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

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

2. (Opcional) Utilice el CLI comando reboot-broker para reiniciar el broker si desea actualizar la versión del motor inmediatamente.

   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 periodo de mantenimiento programado.

   importante

   El agente se quedará sin conexión mientras se reinicia.

Amazon MQ API

Para actualizar la versión de motor de un bróker mediante Amazon MQ API

1. Utilice la UpdateBrokerAPIoperación. 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 engineVersion en la carga de la solicitud para especificar el número de versión al que se va a actualizar el agente.

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

2. (Opcional) Utilice la RebootBrokerAPIoperación para reiniciar su broker si quiere actualizar la versión del motor inmediatamente. broker-idse especifica 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 periodo de mantenimiento programado.

   importante

   El agente se quedará sin conexión mientras se reinicia.

Actualización automática de la versión secundaria del motor

Puede controlar si desea activar o no las actualizaciones automáticas de versiones secundarias para un agente cuando lo crea por primera vez o modificando sus preferencias. Para activar las actualizaciones automáticas de versiones secundarias para un bróker existente, puedes usar Amazon AWS CLI MQ o Amazon MQAPI. AWS Management Console

AWS Management Console

Para activar las actualizaciones automáticas de versiones secundarias mediante el AWS Management Console

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 Maintenance (Mantenimiento), elija Enable automatic minor version upgrades (Habilitar actualizaciones automáticas de versiones secundarias).

   nota

   Si la opción ya está seleccionada, no es necesario hacer ningún cambio.

5. Elija Guardar en la parte inferior de la página.

AWS CLI

Para activar las actualizaciones automáticas de versiones secundarias mediante el AWS CLI, utilice el CLI comando update-broker y especifique los siguientes parámetros.

• --broker-id: ID único que genera Amazon MQ para el agente. Puede analizar el ID de su corredor. ARN Por ejemplo, dado lo siguiente ARNarn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, el ID del corredor seríab-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

• --auto-minor-version-upgrade: activa la opción de actualizaciones automáticas de versiones secundarias.

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

Si desea desactivar las actualizaciones automáticas de versiones secundarias para su agente, utilice el parámetro --no-auto-minor-version-upgrade.

Amazon MQ API

Para activar las actualizaciones automáticas de versiones secundarias a través de Amazon MQAPI, utilice la UpdateBrokerAPIoperación. Especifique broker-id como parámetro de ruta. En el siguiente ejemplo, 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 la propiedad autoMinorVersionUpgrade en la carga de solicitud para activar la actualización automática de versiones secundarias.

{
    "autoMinorVersionUpgrade": "true"
}

Si desea desactivar las actualizaciones automáticas de versiones secundarias para su agente, configure "autoMinorVersionUpgrade": "false" en la carga de solicitud.