Uso do Agendador do Amazon EventBridge para programar tarefas do Amazon ECS

O Agendador do EventBridge é um programador com tecnologia sem servidor que permite criar, executar e gerenciar tarefas de um serviço gerenciado central. Ele fornece uma funcionalidade de programação única e recorrente, independente das regras e barramentos de eventos. O Agendador do EventBridge é altamente personalizável e oferece escalabilidade aprimorada em relação às regras programadas do EventBridge, com um conjunto mais amplo de operações da API de destino e serviços da AWS. O Agendador do EventBridge fornece as programações a seguir que podem ser configuradas para suas tarefas no console do Agendador do EventBridge:

• 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 o Amazon ECS usando o Agendador do Amazon EventBridge.

Embora seja possível criar uma tarefa programada no console do Amazon ECS, no momento, o console do Agendador do EventBridge fornece 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 o perfil de execução do Agendador do EventBridge. Para obter mais informações, consulte Configurar o perfil de execução no Guia do usuário do Agendador do Amazon EventBridge.

Para criar uma nova programação usando o console

1. Abra o console do Agendador do Amazon EventBridge 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 agendamentos, escolha um grupo de agendamento. 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 as expressões cron e rate, consulte Tipos de programação no Agendador do EventBridge no Guia do usuário do Agendador do Amazon EventBridge. 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, insira RunTask e, 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 posiciona 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 de retenção máximo do evento, insira a(s) hora(s) e o(s) minuto(s) máximo(s) que o Agendador do EventBridge deverá 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 Agendador do EventBridge tentará executar a programação se o destino retornar um erro.

        O valor máximo é 185 tentativas.

      Com as políticas de novas tentativas, se a programação não conseguir invocar o destino, o Agendador do EventBridge tentará executar novamente a programação. Se configurado, você deve definir o tempo máximo de retenção e as novas tentativas da programação.

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

      Opção Fila de mensagens não entregues (DLQ)	Fazer isso...
      Não armazene	Selecione Nenhum.
      Armazenar o evento na mesma Conta da AWS em que você está criando a programação	Escolha Selecionar uma fila do Amazon SQS na minha Conta da AWS como 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 Especificar 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 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 Agendador do EventBridge criptografa os dados em repouso, consulte Criptografia em repouso no Guia do usuário do Agendador do Amazon EventBridge.

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

      Para que o Agendador do EventBridge crie um novo perfil de execução para você, escolha Criar novo perfil para esta programação. Depois, insira um nome em Nome do perfil. Se você escolher essa opção, o Agendador do EventBridge anexará as permissões necessárias para o destino de exemplo ao perfil.

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

É possível usar o console do Agendador do EventBridge ou a AWS CLI para gerenciar a programação. Para obter mais informações, consulte Gerenciamento de uma programação no Guia do usuário do Agendador do Amazon EventBridge.