EventBridge Agendador de tarefas agendadas

O Amazon ECS oferece suporte à criação de tarefas programadas. As tarefas agendadas usam o Amazon EventBridge Scheduler.

Crie uma tarefa agendada no console do EventBridge Scheduler

As tarefas agendadas são iniciadas pelo cronograma do Amazon EventBridge Scheduler, que você pode criar usando o console do EventBridge Scheduler. Embora você possa criar uma tarefa agendada no console do Amazon ECS, atualmente o console do EventBridge Scheduler fornece mais funcionalidades. Portanto, as etapas a seguir orientam você na criação de uma programação do EventBridge Scheduler que inicia uma tarefa agendada.

Conclua as etapas a seguir antes de agendar 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 do 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 agenda 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, escolha Criar uma 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 uma descrição para a sua programação. Por exemplo, TestSchedule.

   3. Para 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.

      Você usa grupos de programação para adicionar tags a eles.

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

   Ocorrência	Fazer isso...
   Programação única Uma programação única invoca um destino somente uma vez na data e hora que você especificar.	Para Data e hora, faça o seguinte: Insira uma data válida no formato YYYY/MM/DD. Insira um carimbo de data e hora no formato 24 horas, hh:mm. Para Fuso horário, escolha o fuso horário.
   Programação recorrente Uma programação recorrente invoca uma meta em uma taxa que você especifica usando uma expressão cron ou expressão de taxa.	Em Tipo de cronograma, siga um destes procedimentos: Para usar uma expressão cron para definir o cronograma, escolha Cronograma baseado em cron e insira a expressão cron. Para usar uma expressão rate para definir o cronograma, escolha Cronograma com base 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. Para Janela de tempo flexível, escolha Desativado para desativar a opção ou escolher uma das janelas de tempo predefinidas. Por exemplo, se você escolher 15 minutos e definir uma programação recorrente para invocar sua meta 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. Para Fuso horário, escolha um fuso horário.

   2. Para Data e hora de início, insira uma data válida no formato YYYY/MM/DD e, em seguida, especifique um carimbo de data e hora no formato 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 e hora no formato 24 horas, hh:mm.

6. Escolha Avançar.

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. Para o cluster ECS, escolha o cluster.

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

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

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

   7. Em Sub-redes, insira as 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 ajudar a identificar suas tarefas, em Tags, configure suas tags.

      Para que o Amazon ECS marque automaticamente todas as tarefas recém-lançadas com as tags de definição de tarefas, selecione Habilitar tags gerenciadas pelo Amazon ECS.

8. Escolha Avançar.

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

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

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

      • Alterne 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 tempo 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 novas 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 para a programação.

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

      Opção Filas de mensagens não entregues (DLQ)	Fazer isso...
      Não armazene	Selecione None.
      Armazenar o evento na mesma Conta da AWS em que você está criando a programação	Escolha Selecione uma fila do Amazon SQS na minha Conta da AWScomo uma DLQ. Escolha o nome do recurso da Amazon (ARN) da fila do Amazon SQS.
      Armazenar o evento em uma Conta da AWS diferente de onde você está criando a programação	Escolha Especifique uma fila do Amazon SQS em outras Contas da AWS como uma DLQ. Insira o nome do recurso da Amazon (ARN) da fila do Amazon SQS.

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

      Se você escolher essa opção, insira uma chave ARN do KMS existente ou escolha Criar um 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 função existente e selecione a função.

      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 para 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 Avançar.

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

12. Escolha Criar programação.

    Você pode ver uma lista das suas programações novas e existentes na página Programações. Na coluna Status, verifique se sua 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 Gerenciamento de uma programação no Guia do usuário do Amazon EventBridge Scheduler.