# 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 [Sub-redes para sua VPC](https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html) e [Controlar o tráfego para seus recursos da AWS usando grupos de segurança](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) no *Guia do usuário da Amazon VPC*.
1. Configure o perfil de execução do Agendador do EventBridge. Para obter mais informações, consulte [Configurar o perfil de execução](https://docs.aws.amazon.com/scheduler/latest/UserGuide/setting-up.html#setting-up-execution-role) no *Guia do usuário do Agendador do Amazon EventBridge*.
1. Se você desejar usar uma estratégia de provedor de capacidade para executar a tarefa, você deverá ter um provedor de capacidade associado ao cluster.
**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](https://console.aws.amazon.com/scheduler/home/).
1. Na página **Programações**, clique em **Criar programação**.
1. 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**.
1. (Opcional) Em **Descrição**, insira a descrição da programação. Por exemplo, **TestSchedule**.
1. 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.
1. Escolha as opções de programação.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/tasks-scheduled-eventbridge-scheduler.html)
1. (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.
1. 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`.
1. 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`.
1. Escolha **Próximo**.
1. Na página **Selecionar destino**, faça o seguinte:
1. Escolha **Todas as APIs** e, na caixa de pesquisa, digite **ECS**.
1. Selecione **Amazon ECS**.
1. Na caixa de pesquisa, insira **RunTask** e, em seguida, escolha **RunTask**.
1. Em **Cluster do ECS**, escolha o cluster.
1. Em **Tarefa do ECS**, escolha a definição de tarefa a ser usada para a tarefa.
1. Escolha como suas tarefas serão distribuídas em toda a infraestrutura do cluster. Expanda **Opções de computação** e, em seguida, escolha uma das opções a seguir
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/tasks-scheduled-eventbridge-scheduler.html)
1. Em **Sub-redes**, insira os IDs de sub-rede nas quais executar a tarefa.
1. Em **Grupos de segurança**, insira as IDs do grupo de segurança da sub-rede.
1. (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 obter mais informações, consulte [Como o Amazon ECS posiciona tarefas em instâncias de contêineres](task-placement.md).
1. (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**.
1. Escolha **Próximo**.
1. 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**.
1. 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.
1. Escolha onde o Agendador do EventBridge armazena os eventos não entregues.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/tasks-scheduled-eventbridge-scheduler.html)
1. 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](https://docs.aws.amazon.com/scheduler/latest/UserGuide/encryption-rest.html) no *Guia do usuário do Agendador do Amazon EventBridge*.
1. 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.
1. Escolha **Próximo**.
1. 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.
1. 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](https://docs.aws.amazon.com/scheduler/latest/UserGuide/managing-schedule.html) no *Guia do usuário do Agendador do Amazon EventBridge*.