Documentação

Agendas

Execute tarefas de forma recorrente e acompanhe os resultados gerados pela agenda.

Uma agenda executa tarefas de forma recorrente sem necessidade de intervenção manual. Encontre-as na visualização Agendas da fábrica.

Para que servem as agendas?

Manutenções recorrentes fáceis de combinar e fáceis de esquecer:

  • atualizações de dependências
  • tarefas de limpeza que se acumulam — código morto, flags obsoletas, exportações não utilizadas
  • relatórios periódicos
  • verificações periódicas em relação a um padrão previamente estabelecido

A característica comum é que o trabalho já está bem definido com antecedência. Uma agenda não pode decidir o que vale a pena ser feito; ela apenas repete uma instrução que você já criou.

Para que elas não são adequadas?

Qualquer coisa que exija julgamento sobre prioridades. Uma agenda que inicia tarefas toda segunda-feira, independentemente de outras atividades em andamento, competirá pelos mesmos slots de agente que as tarefas planejadas por você.

O trabalho agendado consome capacidade real.

Isso é algo que deve ser levado em conta antes de criar várias agendas.

Uma tarefa agendada é uma tarefa comum. Ela entra na fila, ocupa um slot de agente e consome recursos de modelo. Três agendas diárias em um plano de um slot podem impedir a execução de tudo o que você pretendia fazer.

Histórico de execução

Cada agenda mantém um histórico de execuções e dos resultados obtidos. Verifique-o ocasionalmente — o modo de falha da automação não é uma quebra grave, mas sim a produção silenciosa de resultados inúteis durante meses, enquanto consome orçamento.

Se uma agenda abriu doze pull requests e nenhum deles foi integrado, a agenda está configurada incorretamente.

Agendas, Sentinel e hooks

Três formas pelas quais o trabalho é iniciado sem intervenção humana:

MecanismoDisparado por
AgendaHorário
SentinelUma condição que está sendo monitorada
HookUm evento da plataforma

Use uma agenda quando o disparador for realmente o horário. Se o que você quer dizer é "quando essa condição se tornar verdadeira", trata-se de um Sentinel, que evitará trabalhos desnecessários.