Etapa 1: Criar a janela de manutenção (AWS CLI)

Nesta etapa, crie uma janela de manutenção e especifique suas opções básicas, como nome, programação e duração. Nas etapas posteriores, você escolherá a instância que ela atualiza e a tarefa que ela executa.

No nosso exemplo, você criará uma janela de manutenção que é executada a cada cinco minutos. Normalmente, uma janela de manutenção não seria executada com essa frequência. No entanto, essa taxa permite visualizar os resultados do tutorial rapidamente. Mostraremos como alterar para uma taxa menos frequente após a execução bem-sucedida da tarefa.

nota

Para obter uma explicação de como as várias opções relacionadas à programação de janelas de manutenção se relacionam entre si, consulte Opções de programação da janela de manutenção e do período ativo.

Para obter mais informações sobre como trabalhar com a opção --schedule, consulte Referência: Expressões cron e rate para o Systems Manager.

Para criar uma janela de manutenção (AWS CLI)

1. Abra a AWS Command Line Interface (AWS CLI) e execute o seguinte comando na máquina local para criar uma janela de manutenção que faz o seguinte:

   • Executa a cada cinco minutos durante até duas horas (conforme necessário).

   • Impede que novas tarefas iniciem a menos de uma hora do final da operação da janela de manutenção.

   • Permite destinos não associados (instâncias que não foram registradas na janela de manutenção).

   • Indica, por meio do uso de tags personalizadas, que seu criador pretende usá-la em um tutorial.

   Linux & macOS

   aws ssm create-maintenance-window \
       --name "My-First-Maintenance-Window" \
       --schedule "rate(5 minutes)" \
       --duration 2 \
       --cutoff 1 \
       --allow-unassociated-targets \
       --tags "Key=Purpose,Value=Tutorial"

   Windows

   aws ssm create-maintenance-window ^
       --name "My-First-Maintenance-Window" ^
       --schedule "rate(5 minutes)" ^
       --duration 2 ^
       --cutoff 1 ^
       --allow-unassociated-targets ^
       --tags "Key"="Purpose","Value"="Tutorial"

   O sistema retorna informações como estas.

   {
      "WindowId":"mw-0c50858d01EXAMPLE"
   }

2. Agora, execute o comando a seguir para ver detalhes sobre esta e quaisquer outras janelas de manutenção que já estejam na sua conta.

   aws ssm describe-maintenance-windows

   O sistema retorna informações como estas.

   {
      "WindowIdentities":[
         {
               "WindowId": "mw-0c50858d01EXAMPLE",
               "Name": "My-First-Maintenance-Window",
               "Enabled": true,
               "Duration": 2,
               "Cutoff": 1,
               "NextExecutionTime": "2019-05-11T16:46:16.991Z"
         }
      ]
   }

Avance para Etapa 2: Registrar um nó de destino na janela de manutenção (AWS CLI).