Atualizando uma versão do mecanismo de agente do Amazon MQ - Amazon MQ
Atualizar manualmente a versão do mecanismoAtualizar automaticamente a versão do mecanismo espelhoCalendário de fim do suporte da versão Engine

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 de mecanismos de corretagem para todos os tipos de mecanismos de corretagem compatíveis. As novas versões do mecanismo incluem patches de segurança, correções de bugs e outras melhorias no mecanismo do corretor.

O Amazon MQ organiza os números de versão de acordo com a especificação de versão semântica como. X.Y.Z Nas implementações do Amazon MQ, X indica a versão principal, Y representa a versão secundária e Z indica o número da versão do patch. Existem 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 da versão 1 .0 para a versão 2 .0 é considerada uma atualização de versão principal.

  • Atualização de versão secundária — ocorre quando somente o número da versão secundária ou do patch engine é alterado. Por exemplo, atualizando a partir da versão 1. 5 até a versão 1. 6 é considerado um pequeno upgrade de versão.

Para obter mais informações sobre o gerenciamento de versões principais e secundárias de cada tipo de mecanismo de agente específico, consulte os tópicos a seguir.

Você pode atualizar manualmente seu corretor a qualquer momento para a próxima versão principal, secundária ou de patch compatível. Quando você ativa as atualizações automáticas de versões secundárias, o Amazon MQ atualiza seu agente para a versão de patch mais recente suportada durante a janela de manutenção. Se você não ativar as atualizações automáticas de versões secundárias, o Amazon MQ atualizará seu broker para a próxima versão secundária quando a versão secundária atual chegar ao fim do suporte.

As atualizações de versões manuais e automáticas ocorrem durante a janela de manutenção agendada ou depois de reiniciar seu agente.

Os tópicos a seguir descrevem como você pode atualizar manualmente a versão do mecanismo do agente e ativar atualizações automáticas de versões secundárias.

Atualizar manualmente a versão do mecanismo

Para atualizar manualmente a versão do mecanismo de um corretor para uma nova versão principal ou secundária, você pode usar a AWS Management Console AWS CLI, a ou a API do Amazon MQ.

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

  1. Faça login no console do Amazon MQ.

  2. No painel de navegação à esquerda, selecione Brookers (Agentes) e depois escolha o agente que você deseja atualizar na lista.

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

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

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

  6. 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 Immediately (Imediatamente) se você quiser reiniciar o agente e atualizar a versão do mecanismo imediatamente.

      Importante

      O agente estará offline durante a reinicialização.

  7. 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 CLI reboot-broker (reiniciar agente) para reiniciar seu agente, se você 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

    O agente estará offline durante a reinicialização.

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 da 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

    O agente estará offline durante a reinicialização.

Atualizar automaticamente a versão do mecanismo espelho

Você pode controlar se a atualização automática da versão secundária é ativada para um agente quando você cria o agente pela primeira vez ou modificando as preferências do agente. Para ativar atualizações automáticas de versões secundárias para uma corretora existente, você pode usar a AWS Management Console API AWS CLI, a ou a Amazon MQ.

Para ativar atualizações automáticas de versões secundárias usando o AWS Management Console

  1. Faça login no console do Amazon MQ.

  2. No painel de navegação à esquerda, selecione Brookers (Agentes) e depois escolha o agente que você deseja atualizar na lista.

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

  4. Em Maintenance (Manutenção), escolha Enable automatic minor version upgrades (Ativar atualizações automáticas de versões secundárias).

    nota

    Se a opção já estiver selecionada, você não precisará fazer nenhuma alteração.

  5. Escolha Salvar (Save) na parte inferior da página.

Para ativar atualizações automáticas de versões secundárias por meio do AWS CLI, use o comando da CLI update-broker e especifique os parâmetros a seguir.

  • --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.

  • --auto-minor-version-upgrade — Ativa a opção Atualização automática da versão secundária. 

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

Se você quiser desativar as atualizações automáticas de versão secundárias para o seu agente, use o parâmetro --no-auto-minor-version-upgrade.

Para ativar atualizações automáticas de versões secundárias por meio da API do Amazon MQ, use UpdateBrokera operação da API. Especifique broker-id como um parâmetro de caminho. O exemplo a seguir pressupõe 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 a propriedade autoMinorVersionUpgrade na carga útil da solicitação para ativar a atualização automática da versão secundária.

{
    "autoMinorVersionUpgrade": "true"
}

Se quiser desativar as atualizações automáticas de versão secundárias para o seu agente, defina "autoMinorVersionUpgrade": "false" na carga útil da solicitação.

Calendário de fim do suporte da versão Engine

O calendário de fim do suporte da versão Amazon MQ notifica você sobre quando uma versão do broker Engine chegará ao fim do suporte. Quando uma versão do mecanismo chega ao fim do suporte, o Amazon MQ atualiza automaticamente todos os corretores dessa versão para a próxima versão disponível. O Amazon MQ avisa com pelo menos 90 dias de antecedência antes que uma versão do motor chegue ao fim do suporte.

Para ver o calendário de suporte da versão, consulte Amazon MQ Gerenciar as versões do mecanismo do Amazon MQ para ActiveMQ para ActiveMQ e Gerenciando o Amazon MQ para versões do mecanismo RabbitMQ Amazon MQ para RabbitMQ.