Atualização de um tipo de instância do agente do Amazon MQ - Amazon MQ

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

Atualização de um tipo de instância do agente do Amazon MQ

Importante

As instância de mq.m7g.x só estão disponíveis no Amazon MQ para agentes do RabbitMQ. Os agentes do Amazon MQ para ActiveMQ só usam as instância de mq.m5.x.

A descrição combinada da classe (m7g) e do tamanho (large) da instância do agente é chamada de tipo de instância de agente (por exemplo, mq.m7g.large). Quando se escolhe um tipo de instância, é importante considerar os fatores que afetarão o desempenho do agente:

  • o número de clientes e filas

  • o volume de mensagens enviadas

  • mensagens mantidas na memória

  • mensagens redundantes

Tipos menores de instância do agente (mq.m7g.medium) são recomendados somente para testar o desempenho da aplicação. Recomendamos tipos maiores de instância do agente (mq.m7g.large e superiores) para níveis de produção de clientes e filas, alto throughput, mensagens na memória e mensagens redundantes.

Recomendamos a atualização para um tipo de instância maior (ou seja, de micro paralarge) se você estiver enfrentando problemas de desempenho ou se estiver migrando de um ambiente de teste para um ambiente de produção. Para atualizar o tipo de instância, você pode usar o Console de gerenciamento da AWS, a AWS CLI ou a API do Amazon MQ.

Para atualizar para um tipo de instância maior usando oConsole de gerenciamento da AWS, faça o seguinte:

  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 Specifications (Especificações), para Broker instance type (Tipo de instância do agente), escolha o novo tipo de instância 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 durante a próxima janela de manutenção programada.

    • Selecione Immediately (Imediatamente) se você quiser reiniciar o agente e atualizar o tipo de instância 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.

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

Para atualizar o tipo de instância de um agente usando o AWS CLI

  1. Usar o comando da CLI modify-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.

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

    aws mq modify-broker --broker-id broker-id --host-instance-type instance-type

  2. (Opcional) Use o comando CLI reboot-broker para reiniciar o agente, se você quiser atualizar o tipo de instância 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. Para agentes de cluster, somente um nó fica inativo por vez enquanto o agente é reinicializado.

Para atualizar o tipo de instância de um agente usando a API do Amazon MQ

  1. Use a operação da 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 host-instance-type na carga útil da solicitação para especificar o tipo de instância para o qual o agente será atualizado.

    {
    "host-instance-type": "host-instance-type"
}

  2. (Opcional) Use a operação de API RebootBroker para reiniciar seu agente, se você 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.