Programando a janela de manutenção para um agente 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á.

Programando a janela de manutenção para um agente Amazon MQ

Periodicamente, o Amazon MQ realiza manutenção no hardware, no sistema operacional ou no software do mecanismo de um agente de mensagens durante a janela de manutenção. Por exemplo, se você ativou atualizações automáticas de versões secundárias ou alterou o tipo de instância do broker, o Amazon MQ aplicará suas alterações durante a próxima janela de manutenção programada. A duração da manutenção pode durar até duas horas, dependendo das operações programadas para seu agente de mensagens. Você pode minimizar o tempo de inatividade durante uma janela de manutenção selecionando um modo de implantação do agente com alta disponibilidade em várias zonas de disponibilidade (AZ).

O Amazon MQ for ActiveMQ fornece implantações ativas/em espera para alta disponibilidade. No modo ativo/em espera, o Amazon MQ executa operações de manutenção, uma instância por vez, e pelo menos uma instância permanece disponível. Além disso, você pode configurar uma rede de corretores com janelas de manutenção variadas ao longo da semana. O Amazon MQ para RabbitMQ fornece implantações de cluster para alta disponibilidade. Em implantações de cluster, o Amazon MQ executa operações de manutenção, um nó por vez, mantendo pelo menos dois nós em execução o tempo todo.

Ao criar seu corretor pela primeira vez, você pode programar a janela de manutenção para ocorrer uma vez por semana em um horário especificado. Você só pode ajustar a janela de manutenção de um agente até quatro vezes antes da próxima janela de manutenção programada. Depois que a janela de manutenção do corretor é concluída, o Amazon MQ redefine o limite e você pode ajustar a programação novamente antes que a próxima janela de manutenção ocorra. A disponibilidade do corretor não é afetada ao ajustar a janela de manutenção do corretor.

Para ajustar a janela de manutenção do corretor, você pode usar o AWS Management Console AWS CLI, o ou o Amazon MQAPI.

Para ajustar a janela de manutenção do 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 Manutenção, faça o seguinte.

    1. Para Start day (Dia de início), escolha um dia da semana, por exemplo, Sunday (domingo), da lista suspensa.

    2. Para Start time (Hora de início), escolha o horário (horas e minutos) do dia para o qual deseja agendar a próxima janela de manutenção do agente, por exemplo, 12:00.

      nota

      As opções de horário de início são configuradas no fuso horário UTC +0.

  5. Em seguida, selecione Agendar modificações. Em seguida, escolha Após a próxima reinicialização ou Imediatamente. Escolher Imediatamente reiniciará imediatamente o corretor.

  6. Na página de detalhes do agente, em Maintenance window (Janela de manutenção), verifique se sua nova programação preferencial é exibida.

Para ajustar a janela de manutenção do 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.

    • --maintenance-window-start-time — Os parâmetros que determinam a hora de início da janela de manutenção semanal fornecida na estrutura a seguir.

      • DayOfWeek — O dia da semana, na sintaxe a seguir: MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY

      • TimeOfDay — A hora, no formato de 24 horas.

      • TimeZone— (Opcional) O fuso horário, no País/Cidade ou no formato de UTC deslocamento. Definida como UTC por padrão.

    aws mq update-broker --broker-id broker-id \
--maintenance-window-start-time DayOfWeek=SUNDAY,TimeOfDay=13:00,TimeZone=America/Los_Angeles

  2. (Opcional) Use o CLI comando describe-broker para verificar se a janela de manutenção foi atualizada com êxito. 

    aws mq describe-broker --broker-id broker-id
Para ajustar a janela de manutenção do 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: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: authorization-string

    Use o parâmetro maintenanceWindowStartTime e o tipo de recurso WeeklyStartTime na carga útil da solicitação.

    {
"maintenanceWindowStartTime": {
    "dayOfWeek": "SUNDAY",
    "timeZone": "America/Los_Angeles",
    "timeOfDay": "13:00"
  }
}

  2. (Opcional) Use a DescribeBrokerAPIoperação para verificar se a janela de manutenção foi atualizada com êxito. broker-idé especificado como um parâmetro de caminho. 

    GET /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: authorization-string