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 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. 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, a atualização da versão 1.5 para a versão 1.6 é considerada uma atualização de versão secundária.

Você pode atualizar seu agente manualmente a qualquer momento para a próxima versão principal ou secundária compatível. Quando você ativa Atualizações automáticas de versões secundárias, o Amazon MQ atualiza seu agente para a versão de patch mais recente compatível. Para todos os agentes que usam a versão 3.13 e posterior do mecanismo, o Amazon MQ gerencia as atualizações para a versão de patch mais recente compatível durante a janela de manutenção. 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. 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

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

  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

    Os corretores de instância única ficam off-line durante a reinicialização. Para 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 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

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

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.