Skip to content
GAIA Logo
PricingDocs
GAIA Logo
  1. Início
  2. Glossário
  3. Cron Job

Cron Job

Um cron job é um comando ou script que roda sozinho em um horário que se repete, por exemplo toda noite às 2h ou toda segunda-feira às 9h. O horário é escrito como uma expressão cron de cinco campos (minuto, hora, dia do mês, mês e dia da semana), e o agendador cron do Linux, do macOS e de outros sistemas Unix confere essa expressão a cada minuto e inicia a tarefa quando o horário bate.

Entendendo Cron Job

O nome vem de Chronos, a personificação grega do tempo. O cron é uma utilidade do Unix que executa comandos programados com base em um arquivo de configuração (crontab) contendo expressões que definem quando cada tarefa deve ser executada. A sintaxe permite especificar minutos, horas, dias, meses e dias da semana.

Uma expressão cron como "0 9 * * 1-5" significa: no minuto 0, hora 9, qualquer dia do mês, qualquer mês, nos dias úteis (segunda a sexta), ou seja, às 9h da manhã durante a semana. Isso permite agendar tarefas recorrentes de forma precisa.

Cron jobs impulsionam automações em segundo plano: backups noturnos de banco de dados, sincronizações horárias de dados, geração diária de relatórios, envio semanal de e-mails resumo e ciclos de cobrança mensais são normalmente implementados como cron jobs. Para assistentes de IA, cron jobs disparam fluxos de trabalho agendados como briefings matinais, resumos de fim de dia e e-mails de revisão semanal.

Ambientes modernos em nuvem evoluíram além do cron do Unix e oferecem serviços gerenciados de agendamento (AWS EventBridge, Google Cloud Scheduler) e agendadores de nível de aplicação (Celery Beat, APScheduler, ARQ). Estes fornecem mais confiabilidade, logs e monitoramento do que o cron puro.

Como ler uma expressão cron: os cinco campos são minuto (0-59), hora (0-23), dia do mês (1-31), mês (1-12) e dia da semana (0-6, em que 0 é domingo). Um asterisco significa qualquer valor, a vírgula separa valores (1,15), o hífen define um intervalo (1-5) e a barra define um passo (*/15 no campo de minutos significa a cada 15 minutos). Exemplos comuns: 0 2 * * * roda todo dia às 2h, */15 * * * * a cada 15 minutos, 0 9 1 * * às 9h do primeiro dia de cada mês e 30 17 * * 5 às sextas às 17h30. Se você restringir ao mesmo tempo o dia do mês e o dia da semana, o cron clássico roda a tarefa quando qualquer um dos dois bate, o que surpreende muita gente.

Como criar um cron job no Linux ou no macOS: rode crontab -e para editar o crontab do seu usuário, adicione uma linha por tarefa com a expressão seguida do comando (por exemplo 0 2 * * * /home/eu/backup.sh), salve e confira com crontab -l. O cron inicia as tarefas com um ambiente mínimo, então use caminhos absolutos, defina PATH ou outras variáveis no topo do arquivo e mande a saída para um arquivo de log; caso contrário, os erros somem ou vão parar em uma caixa de email local que ninguém lê. As tarefas usam o fuso horário da máquina, a menos que você configure outro.

Onde o cron deixa a desejar: ele não tenta de novo uma tarefa que falhou, não roda as tarefas que venceram enquanto a máquina estava desligada (o anacron e os timers do systemd conseguem) e não impede que duas cópias de uma tarefa lenta se sobreponham (envolver o comando com flock resolve). O Kubernetes oferece o recurso CronJob com a mesma sintaxe para contêineres, e agendadores em nuvem como AWS EventBridge Scheduler e Google Cloud Scheduler também aceitam expressões cron. Quando o gatilho é algo que acontece, e não um horário, como um email novo ou uma issue nova, a automação orientada a eventos funciona melhor que um cron job.

Como GAIA usa Cron Job

Os fluxos de trabalho do GAIA podem rodar em um agendamento cron. Diga ao GAIA o horário com suas palavras ("todo dia útil às 8h") ou informe uma expressão cron de cinco campos, e o agendamento é calculado no seu fuso horário. Cada execução entra na fila do ARQ, a fila de tarefas do GAIA baseada em Redis, e os passos do fluxo rodam em segundo plano; o GAIA pode avisar você do resultado. Um agendamento pode disparar no máximo uma vez por hora, então expressões que rodam a cada minuto ou a cada 15 minutos são recusadas. Briefings matinais, resumos de fim de dia e revisões semanais são fluxos agendados típicos.

Conceitos relacionados

Automação de Fluxos de Trabalho

A automação de fluxos de trabalho é o uso da tecnologia para executar automaticamente processos e tarefas repetitivas de negócios, reduzindo o esforço manual e o erro humano.

Automação Orientada a Eventos

Automação orientada a eventos (também chamada de automação baseada em eventos) roda um fluxo de trabalho no momento em que algo acontece, como a chegada de um email novo, a criação de uma issue ou uma linha nova em uma planilha, em vez de em um horário fixo. Cada automação liga um evento gatilho às ações que devem ser feitas, e o sistema onde o evento aconteceu avisa a plataforma de automação, geralmente por um webhook.

Automação de Tarefas

Automação de tarefas é o uso da tecnologia, especialmente da IA, para criar, gerenciar, priorizar e executar automaticamente tarefas repetitivas que normalmente exigiriam trabalho manual.

Webhook

Um webhook é um mecanismo de callback HTTP em que um sistema envia uma requisição HTTP automatizada para uma URL especificada sempre que um evento definido ocorre, permitindo notificações em tempo real e integração entre serviços sem necessidade de polling.

Perguntas frequentes

Sim. O recurso de fluxos de trabalho agendados do GAIA permite configurar acionadores temporais. Um briefing diário pode ser programado para qualquer horário, combinando seu resumo por e-mail, visão geral da agenda, prioridades de tarefas e outros conteúdos configurados.

Cada execução agendada é uma tarefa no ARQ, a fila do GAIA baseada em Redis. Uma varredura de recuperação periódica coloca de volta na fila qualquer execução vencida cuja tarefa se perdeu, por exemplo depois de um worker reiniciar, e reinicia execuções que travaram no meio. Depois disso, um fluxo recorrente passa para o próximo horário futuro em vez de repetir todas as execuções perdidas. Se uma execução falha, o GAIA registra a falha e avisa você.

Os cinco campos são minuto, hora, dia do mês, mês e dia da semana. */5 no campo de minutos significa a cada 5 minutos, e o asterisco nos outros campos significa qualquer hora, dia e mês, então */5 * * * * roda a cada cinco minutos. Outro exemplo: 0 9 * * 1-5 roda às 9h nos dias úteis.

Rode crontab -e, adicione uma linha com o horário seguido do comando, por exemplo 0 2 * * * /home/eu/backup.sh, e salve. crontab -l lista suas tarefas. Use caminhos absolutos e mande a saída para um arquivo de log, porque o cron roda as tarefas com um ambiente mínimo.

Um cron job roda porque o relógio chegou a um horário definido. A automação orientada a eventos roda porque algo aconteceu, como um email novo ou uma issue nova no GitHub. Use cron para relatórios, backups e briefings regulares; use um gatilho de evento quando a reação deve vir logo depois do fato.

Automações relacionadas

google-calendar Iconslack Icon

Google Calendar + Slack

Receba atualizações da agenda no Slack e gerencie reuniões pelo chat

slack Iconasana Icon

Slack + Asana

Crie tarefas do Asana pelo Slack e acompanhe o progresso no chat

notion Iconstripe Icon

Notion + Stripe

Acompanhe a receita da Stripe em bancos do Notion e direcione alertas

Explorar mais

Compare o GAIA com alternativas

Veja como o GAIA se compara a outras ferramentas de produtividade com IA

GAIA para o seu papel

Descubra como o GAIA ajuda profissionais em diferentes funções

Stop doing everything yourselfStop doing everything yourself

Join thousands of professionals who gave their grunt work to GAIA.

WhatsappDiscord
Product
FeaturesDownloadUse CasesMarketplaceBotsPricingRoadmap
Explore
Compare GAIAAlternativesAutomationsAI GlossaryGAIA for Your RoleBest AI Assistants
Resources
DocumentationBlogFAQRelease NotesStatusRequest a Feature
Company
AboutManifestoContactBranding
Legal
Terms of UsePrivacy PolicySubprocessors
The Experience Company Inc.
DiscordWhatsapp