Atualizando uma versão do mecanismo de agente do Amazon MQ - Amazon MQ
Atualizar manualmente a versão do mecanismo

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Atualizando uma versão do mecanismo de agente do Amazon MQ

O Amazon MQ fornece regularmente novas versões do mecanismo do agente para todos os tipos de mecanismo de agente compatíveis. As novas versões do mecanismo incluem patches de segurança, correções de bugs e outras melhorias no mecanismo do agente.

O Amazon MQ organiza os números das versões de acordo com a especificação de versionamento semântico como X.Y.Z. Nas implementações do Amazon MQ, X denota a versão principal, Y representa a versão secundária e Z denota o número da versão de patch. O Amazon MQ oferece suporte a dois tipos de atualizações:

  • Atualização da versão principal: ocorre quando os números de versão do mecanismo principal mudam. Por exemplo, a atualização do RabbitMQ versão 3.13 para a versão 4.2 é considerada uma atualização principal da versão.

  • Atualização de versão secundária: ocorre quando apenas os números de versão secundários do mecanismo mudam. Por exemplo, atualizando a partir da versão 3. 11 para a versão 3. 12 é considerado um pequeno upgrade de versão.

Você pode atualizar seu agente manualmente a qualquer momento para a próxima versão principal ou secundária compatível. O Amazon MQ gerencia a atualização para a última versão de patch compatível com todos os corretores durante a janela de manutenção programada. As atualizações manuais e automáticas da versão ocorrem durante a janela de manutenção programada ou após a reinicialização do broker. O Amazon MQ atualiza seu agente para a próxima versão secundária quando a versão secundária atual chega ao fim do suporte.

Atualizar manualmente a versão do mecanismo

Você pode atualizar a versão do mecanismo de um corretor usando a API Console de gerenciamento da AWS AWS CLI, a ou a API do Amazon MQ.

Para atualizar a versão do mecanismo de um corretor usando o Console de gerenciamento da AWS

  1. Na página de detalhes do agente, selecione Edit (Editar).

  2. Em Especificações, para Versão do mecanismo de agente escolha o novo número de versão na lista suspensa.

  3. Role até o final da página e selecione Programar modificações.

  4. Em Programar modificações do agente, para Quando aplicar modificações, escolha uma das seguintes opções.

    • Selecione After the next reboot (Depois da próxima reinicialização) se você quiser que o Amazon MQ conclua a atualização da versão durante a próxima janela de manutenção programada.

    • Selecione Imediatamente se você quiser reiniciar o agente e atualizar a versão do mecanismo imediatamente.

      Importante

      Os agentes de instância única ficarão offline durante a reinicialização. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.

  5. Selecione Apply (Aplicar) para concluir a aplicação das alterações.

Para atualizar a versão do mecanismo de um corretor usando o AWS CLI

  1. Usar o comando CLI update-broker e especifique os seguintes parâmetros, conforme mostrado no exemplo.

    • --broker-id — O ID exclusivo que o Amazon MQ gera para o agente. Você pode analisar o ID do ARN do seu agente. Por exemplo, considerando o seguinte ARN, arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, o ID do agente seria b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9.

    • --engine-version — O número da versão do mecanismo para a qual o a atualização do mecanismo de agente será feita. 

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

  2. (Opcional) Use o comando da CLI reboot-broker para reinicializar seu broker se quiser atualizar a versão do mecanismo imediatamente. 

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

    Se você não quiser reiniciar seu agente e aplicar as alterações imediatamente, o Amazon MQ atualizará o agente durante a próxima janela de manutenção agendada.

    Importante

    Os agentes de instância única ficarão offline durante a reinicialização. Em agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.

Para atualizar a versão do mecanismo de um agente usando a API do Amazon MQ

  1. Use a operação de API UpdateBroker. Especifique broker-id como um parâmetro de caminho. Os exemplos a seguir pressupõem um agente na região us-west-2. Para ter mais informações sobre os endpoints do Amazon MQ disponíveis, consulte Endpoints e cotas do Amazon MQ na Referência geral da 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

    Use o engineVersion na carga útil da solicitação para especificar o número da versão para a qual o agente será atualizado.

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

  2. (Opcional) Use a operação de RebootBrokerAPI para reinicializar seu broker se quiser atualizar a versão do mecanismo imediatamente. broker-idé especificado como um parâmetro de caminho. 

    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 você não quiser reiniciar seu agente e aplicar as alterações imediatamente, o Amazon MQ atualizará o agente durante a próxima janela de manutenção agendada.

    Importante

    Os agentes de instância única ficarão offline durante a reinicialização. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.