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 espelho

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 semântica de controle de versão 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 apenas os números de versão secundários do mecanismo mudam. Por exemplo, atualizando a partir da versão 1. 5 até a versão 1. 6 é considerado um pequeno upgrade de versão.

Você pode atualizar manualmente seu corretor a qualquer momento para a próxima versão principal ou secundária compatível. Quando você ativa as atualizações automáticas de versões secundárias, o Amazon MQ atualiza seu corretor para a versão de patch mais recente compatível. Para todos os corretores que usam a versão 3.13 e superior do mecanismo, o Amazon MQ gerencia as atualizações para a versão de patch mais recente suportada durante a janela de manutenção. O Amazon MQ atualiza seu corretor para a próxima versão secundária quando a versão secundária atual chega 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 o AWS Management Console AWS CLI, o ou o Amazon MQAPI.

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. Use o CLI comando update-broker e especifique os parâmetros a seguir, conforme mostrado no exemplo.

    • --broker-id — O ID exclusivo que o Amazon MQ gera para o agente. Você pode analisar o ID do seu corretorARN. Por exemplo, considerando o seguinteARN,arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, o ID do corretor seriab-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 CLI comando reboot-broker para reinicializar seu broker 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 corretor usando o Amazon MQ API

  1. Use a UpdateBrokerAPIoperação. 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 RebootBrokerAPIoperação 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 o AWS Management Console AWS CLI, o ou o Amazon API 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 CLI comando 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 seu corretorARN. Por exemplo, considerando o seguinteARN,arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9, o ID do corretor seriab-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 do Amazon API MQ, use UpdateBrokerAPIa operação. 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.