Aggiornamento di una versione del motore del broker Amazon MQ - Amazon MQ
Aggiornamento manuale della versione del motoreAggiornamento automatico della versione secondaria del motore

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiornamento di una versione del motore del broker Amazon MQ

Amazon MQ fornisce regolarmente nuove versioni del motore di brokeraggio per tutti i tipi di motori di broker supportati. Le nuove versioni del motore includono patch di sicurezza, correzioni di bug e altri miglioramenti del motore del broker.

Amazon MQ organizza i numeri di versione in base alle specifiche di versioning semantico as. X.Y.Z Nelle implementazioni di Amazon MQ, X indica la versione principale, Y rappresenta la versione secondaria e Z indica il numero di versione della patch. Esistono due tipi di aggiornamenti:

  • Aggiornamento della versione principale: si verifica quando cambiano i numeri della versione principale del motore. Ad esempio, l'aggiornamento dalla versione 1 .0 alla versione 2 .0 è considerato un aggiornamento della versione principale.

  • Aggiornamento della versione secondaria: si verifica quando cambiano i numeri della versione secondaria del motore. Ad esempio, l'aggiornamento dalla versione 1. 5 alla versione 1. 6 è considerato un aggiornamento secondario della versione.

Puoi aggiornare manualmente il tuo broker in qualsiasi momento alla successiva versione principale o secondaria supportata. Quando attivi gli aggiornamenti automatici delle versioni secondarie, Amazon MQ aggiornerà il tuo broker all'ultima versione di patch supportata. Per tutti i broker che utilizzano la versione 3.13 e successive del motore, Amazon MQ gestisce gli aggiornamenti all'ultima versione di patch supportata durante la finestra di manutenzione. Amazon MQ aggiorna il tuo broker alla versione secondaria successiva quando la versione secondaria corrente raggiunge la fine del supporto. Gli aggiornamenti manuali e automatici della versione si verificano durante la finestra di manutenzione pianificata o dopo il riavvio del broker.

Negli argomenti seguenti viene descritto come aggiornare manualmente la versione del motore del broker e attivare gli aggiornamenti automatici delle versioni secondarie.

Aggiornamento manuale della versione del motore

Per aggiornare manualmente la versione del motore di un broker a una nuova versione principale o secondaria, puoi utilizzare Amazon MQ o Amazon MQAPI. AWS Management Console AWS CLI

Per aggiornare la versione del motore di un broker utilizzando il AWS Management Console

  1. Accedere alla console Amazon MQ.

  2. Nel pannello di navigazione a sinistra, scegli Brokers (broker) e quindi scegli dall'elenco il broker che desideri aggiornare.

  3. Nella pagina dei dettagli del broker, scegliere Edit (Modifica).

  4. In Specifications (Specifiche), per Broker engine version (Versione del motore del broker), scegliere il numero della nuova versione dall'elenco a discesa.

  5. Scorrere fino alla parte inferiore della pagina e selezionare Schedule modifications (Pianifica modifiche).

  6. Alla pagina Schedule broker modifications (Pianifica modifiche del broker), per When to apply modifications (Quando applicare le modifiche), scegliere una delle opzioni seguenti.

    • Scegliere After the next reboot (Al prossimo riavvio) se si desidera che Amazon MQ completi l'aggiornamento della versione durante la prossima finestra di manutenzione pianificata.

    • Scegliere Immediately (Subito), se si desidera riavviare il broker e aggiornare immediatamente la versione del motore.

      Importante

      il broker sarà offline durante il riavvio.

  7. Scegliere Apply (Applica) per completare l'applicazione delle modifiche.

Per aggiornare la versione del motore di un broker utilizzando il AWS CLI

  1. Utilizzate il CLI comando update-broker e specificate i seguenti parametri, come mostrato nell'esempio.

    • --broker-id: ID univoco che Amazon MQ genera per il broker. Puoi analizzare l'ID del tuo broker. ARN Ad esempio, dato quanto segue ARNarn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, l'ID del broker sarebbeb-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

    • --engine-version: numero di versione del motore del broker a cui effettuare l'aggiornamento. 

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

  2. (Facoltativo) Utilizzate il CLI comando reboot-broker per riavviare il broker se desiderate aggiornare immediatamente la versione del motore. 

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

    Se non si desidera riavviare il broker e applicare immediatamente le modifiche, Amazon MQ aggiornerà il broker durante la prossima finestra di manutenzione pianificata.

    Importante

    il broker sarà offline durante il riavvio.

Per aggiornare la versione del motore di un broker utilizzando Amazon MQ API

  1. Usa l'UpdateBrokerAPIoperazione. Specificare broker-idcome parametro del percorso. Negli esempi seguenti si presuppone un broker nella regione us-west-2. Per ulteriori informazioni sugli endpoint Amazon MQ disponibili, consultare Quote ed endpoint di Amazon MQ in Riferimenti generali di . 

    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

    Utilizzare engineVersion nel payload della richiesta per specificare il numero di versione a cui eseguire l'aggiornamento del broker.

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

  2. (Facoltativo) Utilizzate l'RebootBrokerAPIoperazione per riavviare il broker, se desiderate aggiornare immediatamente la versione del motore. broker-idè specificato come parametro di percorso. 

    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

    Se non si desidera riavviare il broker e applicare immediatamente le modifiche, Amazon MQ aggiornerà il broker durante la prossima finestra di manutenzione pianificata.

    Importante

    il broker sarà offline durante il riavvio.

Aggiornamento automatico della versione secondaria del motore

È possibile controllare se l'aggiornamento automatico della versione secondaria è attivato per un broker alla prima creazione del broker o quando si modificano le preferenze del broker. Per attivare gli aggiornamenti automatici delle versioni secondarie per un broker esistente, puoi utilizzare Amazon MQ o Amazon MQAPI. AWS Management Console AWS CLI

Per attivare gli aggiornamenti automatici delle versioni secondarie utilizzando AWS Management Console

  1. Accedere alla console Amazon MQ.

  2. Nel pannello di navigazione a sinistra, scegli Brokers (broker) e quindi scegli dall'elenco il broker che desideri aggiornare.

  3. Nella pagina dei dettagli del broker, scegliere Edit (Modifica).

  4. In Maintenance (Manutenzione), scegliere Enable automatic minor version upgrades (Abilita gli aggiornamenti automatici delle versioni secondarie).

    Nota

    Se l'opzione è già selezionata, non è necessario apportare modifiche.

  5. Scegli Save (Salva) nella parte inferiore della pagina.

Per attivare gli aggiornamenti automatici delle versioni secondarie tramite AWS CLI, utilizzate il CLI comando update-broker e specificate i seguenti parametri.

  • --broker-id: ID univoco che Amazon MQ genera per il broker. Puoi analizzare l'ID del tuo broker. ARN Ad esempio, dato quanto segue ARNarn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, l'ID del broker sarebbeb-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

  • --auto-minor-version-upgrade: attiva l'opzione di aggiornamento automatico delle versioni secondarie. 

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

Se si desidera disattivare gli aggiornamenti automatici delle versioni secondarie per il broker, utilizzare il parametro --no-auto-minor-version-upgrade.

Per attivare gli aggiornamenti automatici delle versioni secondarie tramite Amazon MQAPI, utilizza l'UpdateBrokerAPIoperazione. Specificare broker-id come parametro del percorso. L'esempio seguente presuppone un broker nella regione us-west-2. Per ulteriori informazioni sugli endpoint Amazon MQ disponibili, consultare Quote ed endpoint di Amazon MQ in Riferimenti generali di 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

Utilizzare la proprietà autoMinorVersionUpgrade nel payload della richiesta per attivare l'aggiornamento automatico della versione secondaria.

{
    "autoMinorVersionUpgrade": "true"
}

Se si desidera disattivare gli aggiornamenti automatici delle versioni secondarie per il broker, impostare "autoMinorVersionUpgrade": "false" nel payload della richiesta.