Tarefas agendadas usando EventBridge regras

Você pode usar o console do Amazon ECS para programar tarefas usando EventBridge regras.

nota

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

Recomendamos que você use o EventBridge Scheduler para invocar alvos em uma agenda. Para obter mais informações, consulte EventBridge Agendador de tarefas agendadas.

Crie uma tarefa agendada usando EventBridge regras no console do Amazon ECS

Para programar tarefas usando EventBridge regras (console do Amazon ECS)

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Escolha Clusters e, em seguida, escolha o cluster em que suas tarefas agendadas serão executadas.

3. Na página Cluster: nome do cluster, escolha Tarefas agendadas e, em seguida, escolha Criar.

4. Na página Criar nova tarefa agendada, na seção Nome e descrição da agenda, faça o seguinte:

   1. Em Nome do cronograma, insira um nome exclusivo.

   2. (Opcional) Em Descrição, insira uma descrição para a sua programação.

   3. Para ativar a regra, ative a opção Ativada.

   4. Em Tipo de regra agendada, escolha suas opções de agendamento.

      Ocorrência	Fazer isso...
      Taxa fixa	Em Valor para a expressão de taxa e Unidade para a expressão de taxa, faça o seguinte: Insira uma tarifa válida, por exemplo, 1. Insira uma unidade, por exemplo, Dias.
      Horário específico	Em Expressão Cron, insira a expressão de taxa. Para obter mais informações sobre expressões cron e de taxa, consulte a referência de expressões Cron no Guia do EventBridge usuário da Amazon.

5. Na seção Destino, configure as informações sobre a tarefa:

   1. Em Target id, insira um nome exclusivo para o alvo.

   2. Escolha o tipo de lançamento. Em Tipo de lançamento, 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.

   3. Em Definição da tarefa, escolha a família e a revisão da definição da tarefa.

      Importante

      O console valida a seleção para garantir que a família e a revisão de definição de tarefa selecionadas sejam compatíveis com a configuração computacional definida.

   4. Em Desired tasks (Tarefas desejadas), insira o número de tarefas que serão iniciadas.

6. Se a definição de tarefa usar o modo de redeawsvpc, expanda Networking (Redes). Use as etapas a seguir para especificar uma configuração personalizada.

   1. Em VPC, selecione a VPC a ser usada.

   2. Em Subnets (Sub-redes), selecione uma ou mais sub-redes na VPC que o programador de tarefas levará em consideração ao posicionar as tarefas.

      Importante

      Somente as sub-redes privadas são compatíveis com o modo de rede awsvpc. As tarefas não recebem endereços IP públicos. Portanto, é necessário um gateway NAT para o acesso à Internet de saída e o tráfego de entrada da Internet é roteado por meio de um balanceador de carga.

   3. Para Grupo de segurança, você pode escolher um grupo de segurança existente ou criar um novo. Para usar um grupo de segurança existente, escolha o grupo de segurança e vá para a próxima etapa. Para criar um novo grupo de segurança, escolha Create a new security group (Criar um novo grupo de segurança). Você deve especificar o nome de um grupo de segurança, uma descrição e, em seguida, adicionar uma ou mais regras de entrada para o grupo de segurança.

   4. Em Public IP (IP público), escolha se um endereço IP público deve ou não ser atribuído automaticamente à interface de rede elástica (ENI) da tarefa.

      AWS Fargateas tarefas podem receber um endereço IP público quando executadas em uma sub-rede pública para que tenham uma rota para a Internet. Para obter mais informações, consulte Redes de tarefas do Fargate no Guia do usuário do Amazon Elastic Container Service para AWS Fargate.

7. (Opcional) Para usar uma função de tarefa diferente para o destino, em Substituição da função da tarefa, escolha a função.

8. (Opcional) Para associar o ecsEventsRole à definição da tarefa, para a função EventBridge do IAM para esse destino, escolha a função.

9. (Opcional) Para substituir os comandos do contêiner e as variáveis de ambiente, expanda Container Overrides (Substituições de contêiner) e expanda o contêiner.

   • Para enviar um comando ao contêiner que não seja o comando de definição de tarefa, em Substituição de comando, insira o comando Docker.

     Para obter mais informações sobre o comando run do Docker, consulte Docker Run reference (Referência do Docker Run) no manual de referência do Docker.

   • Para adicionar uma variável de ambiente, use Add environment variable (Adicionar variável de ambiente). Em Key (Chave), insira o nome da variável de ambiente. Em Value (Valor), insira um valor de string para seu valor de ambiente (sem as aspas duplas (" ")).

     A AWS delimita a string com aspas duplas (" ") e a transmite ao contêiner no seguinte formato:

     MY_ENV_VAR="This variable contains a string."

10. Escolha Create (Criar).

Visualize suas tarefas EventBridge agendadas no console

As tarefas EventBridge agendadas do seu Scheduler podem ser visualizadas no console do Amazon ECS.

Para visualizar as tarefas programadas (console do Amazon ECS)

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Escolha Clusters e, em seguida, escolha o cluster em que suas tarefas agendadas serão executadas.

3. Na página Cluster: nome do cluster, escolha a guia Scheduled Tasks (Tarefas programadas).

4. Todas as tarefas programadas são listadas.

Editar uma tarefa EventBridge agendada

Você pode modificar uma EventBridge agenda existente usando o console.

Para editar uma tarefa EventBridge agendada (console do Amazon ECS)

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Escolha o cluster no qual editar sua tarefa programada.

3. Na página Cluster: nome do cluster, escolha a guia Scheduled Tasks (Tarefas programadas).

4. Escolha a regra de agendamento a ser editada e, em seguida, escolha Atualizar.

5. Para desativar a programação, em Regra agendada, ative.

6. Para modificar suas opções de agendamento, em Tipo de agendamento, faça o seguinte.

   Ocorrência	Fazer isso...
   Execute em um intervalo fixo	Em Valor, insira o número de horas, minutos ou dias e, em Unidade, escolha a unidade de intervalo.
   Cron	Em Expressão cron, insira a expressão cron. 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.

7. Faça quaisquer alterações adicionais nos destinos (clusters e tarefas) e escolha Atualizar.