Execute tarefas do Amazon ECS em horários usando o Amazon Scheduler EventBridge

EventBridge O Scheduler é um agendador sem servidor que permite criar, executar e gerenciar tarefas a partir de um serviço gerenciado central. Ele fornece uma funcionalidade de agendamento único e recorrente, independente das regras e barramentos de eventos. EventBridge O Scheduler é altamente personalizável e oferece escalabilidade aprimorada em relação às regras EventBridge programadas, com um conjunto mais amplo de operações e serviços de API de destino. AWS EventBridge O Scheduler fornece os seguintes agendamentos que você pode configurar para suas tarefas no console do EventBridge Scheduler:

• Baseada em taxa

• Baseado em cron

  É possível configurar programações baseadas em cron em qualquer fuso horário.

• Programações únicas

  É possível configurar programações únicas em qualquer fuso horário.

Você pode programar seu Amazon ECS usando o Amazon EventBridge Scheduler.

Embora você possa criar uma tarefa agendada no console do Amazon ECS, atualmente o console EventBridge Scheduler oferece mais funcionalidades.

Conclua as etapas a seguir antes de programar uma tarefa:

1. Use o console da VPC para obter os IDs de sub-rede em que as tarefas são executadas e os IDs do grupo de segurança para as sub-redes. Para obter mais informações, consulte Visualizar suas sub-redes e Visualizar seus grupos de segurança no Guia do usuário da Amazon VPC.

2. Configure a função de execução EventBridge do Scheduler. Para obter mais informações, consulte Configurar a função de execução no Guia do usuário do Amazon EventBridge Scheduler.

Para criar uma nova programação usando o console

1. Abra o console do Amazon EventBridge Scheduler em https://console.aws.amazon.com/scheduler/home.

2. Na página Programações, clique em Criar programação.

3. Na página Especificar detalhes da programação, na seção Nome e descrição da programação, faça o seguinte:

   1. Em Nome da programação, insira um nome para a programação. Por exemplo, MyTestSchedule.

   2. (Opcional) Em Descrição, insira a descrição da programação. Por exemplo, TestSchedule.

   3. Em Grupo de programação, escolha um grupo de programação na lista suspensa. Se você não tiver um grupo, escolha padrão. Para criar um grupo de programação, escolha criar sua própria programação.

      Para adicionar tags a grupos de programação, você usa os grupos de programação.

4. Escolha as opções de programação.

   Ocorrência	Fazer isso...
   Programação única A programação única invoca o destino somente uma vez na data e hora que você especificar.	Em Data e hora, faça o seguinte: Insira uma data válida no formato YYYY/MM/DD. Insira um carimbo de data/hora no formato de 24 horas hh:mm. Em Fuso horário, escolha o fuso horário.
   Programação recorrente A programação recorrente invoca o destino em uma taxa especificada por você usando uma expressão cron ou rate.	Em Tipo de programação, siga um dos procedimentos a seguir. Para usar uma expressão cron para definir a programação, escolha Programação baseada em cron e insira a expressão cron. Para usar uma expressão rate para definir a programação, escolha Programação baseada em rate e insira a expressão rate. Para obter mais informações sobre expressões cron e de taxa, consulte Tipos de programação no EventBridge Scheduler no Guia do usuário do Amazon EventBridge Scheduler. Em Janela de tempo flexível, escolha Desativar para desativar a opção ou escolha uma das janelas de tempo predefinidas. Por exemplo, se você escolher 15 minutos e definir uma programação recorrente para invocar o destino uma vez a cada hora, a programação será executada em até 15 minutos após o início de cada hora.

5. (Opcional) Se você escolher Programação recorrente na etapa anterior, na seção Período, faça o seguinte:

   1. Em Fuso horário, escolha um fuso horário.

   2. Em Data e hora de início, insira uma data válida no formato YYYY/MM/DD e, em seguida, especifique um carimbo de data/hora no formato de 24 horas hh:mm.

   3. Para Data e hora de término, insira uma data válida no formato YYYY/MM/DD e, em seguida, especifique um carimbo de data/hora no formato 24 horas hh:mm.

6. Escolha Próximo.

7. Na página Selecionar destino, faça o seguinte:

   1. Escolha Todas as APIs e, na caixa de pesquisa, digite ECS.

   2. Selecione Amazon ECS.

   3. Na caixa de pesquisa, digite e RunTask, em seguida, escolha RunTask.

   4. Em Cluster do ECS, escolha o cluster.

   5. Em Tarefa do ECS, escolha a definição de tarefa a ser usada para a tarefa.

   6. Para usar um tipo de inicialização, expanda Opções de computação e selecione Tipo de inicialização. Em seguida, escolha o tipo de inicialização.

      Quando o tipo de inicialização do Fargate for especificado, em Versão da plataforma, insira a versão da plataforma a ser usada. Se não for especificada uma plataforma, a versão da plataforma LATEST será usada.

   7. Em Sub-redes, insira os IDs de sub-rede nas quais executar a tarefa.

   8. Em Grupos de segurança, insira as IDs do grupo de segurança da sub-rede.

   9. (Opcional) Para usar uma estratégia de posicionamento de tarefas diferente da padrão, expanda Restrição de posicionamento e insira as restrições.

      Para ter mais informações, consulte Como o Amazon ECS coloca tarefas em instâncias de contêineres.

   10. (Opcional) Para ajudar a identificar as tarefas, em Tags, configure suas tags.

       Para que o Amazon ECS atribua tags automaticamente a todas as tarefas recém-iniciadas com tags de definição de tarefa, selecione Habilitar tags gerenciadas pelo Amazon ECS.

8. Escolha Próximo.

9. Na página Configurações, faça o seguinte:

   1. Para ativar a programação, em Estado da programação, mude para Ativar programação.

   2. Para configurar uma política de novas tentativas para a programação, em Política de novas tentativas e fila de mensagens não entregues (DLQ), faça o seguinte:

      • Mude para Tentar novamente.

      • Em Tempo máximo de retenção do evento, insira o máximo de horas e minutos em que o EventBridge Agendador deve manter um evento não processado.

      • O período máximo é de 24 horas.

      • Em Máximo de tentativas, insira o número máximo de vezes que o EventBridge Scheduler repete o agendamento se o alvo retornar um erro.

        O valor máximo é 185 tentativas.

      Com políticas de repetição, se um agendamento falhar em invocar seu destino, o EventBridge Scheduler executará novamente o agendamento. Se configurado, você deve definir o tempo máximo de retenção e as novas tentativas da programação.

   3. Escolha onde o EventBridge Scheduler armazena os eventos não entregues.

      Opção Fila de mensagens não entregues (DLQ)	Fazer isso...
      Não armazene	Selecione Nenhum.
      Armazene o evento no mesmo Conta da AWS local em que você está criando a programação	Escolha Selecionar uma fila do Amazon SQS em my Conta da AWS as a DLQ. Escolha o nome do recurso da Amazon (ARN) da fila do Amazon SQS.
      Armazene o evento em um local Conta da AWS diferente de onde você está criando a programação	Escolha Especificar uma fila do Amazon SQS em outra Contas da AWS como DLQ. Insira o nome do recurso da Amazon (ARN) da fila do Amazon SQS.

   4. Para usar uma chave gerenciada pelo cliente para criptografar a entrada de destino, em Criptografia, escolha Personalizar as configurações de criptografia (avançado).

      Se você escolher essa opção, insira o ARN da chave do KMS existente ou escolha Criar AWS KMS key para navegar até o console do AWS KMS . Para obter mais informações sobre como o EventBridge Scheduler criptografa seus dados em repouso, consulte Criptografia em repouso no Guia do usuário do Amazon EventBridge Scheduler.

   5. Em Permissões, escolha Usar perfil existente e selecione o perfil.

      Para que o EventBridge Scheduler crie uma nova função de execução para você, escolha Criar nova função para esta agenda. Depois, insira um nome em Nome do perfil. Se você escolher essa opção, o EventBridge Scheduler anexará as permissões necessárias para seu alvo modelado à função.

10. Escolha Próximo.

11. Na página Revisar e criar programação, revise os detalhes da programação. Em cada seção, escolha Editar para voltar a essa etapa e editar seus detalhes.

12. Clique em Criar programação.

    Você pode ver a lista com as programações novas e existentes na página Programações. Na coluna Status, verifique se a nova programação está Ativada.

Próximas etapas

Você pode usar o console do EventBridge Scheduler ou o AWS CLI para gerenciar a agenda. Para obter mais informações, consulte Gerenciando uma programação no Guia do usuário do Amazon EventBridge Scheduler.