Expressão cron: a cada minuto

* * * * * roda a cada minuto. Veja o que cada campo significa, quando ele roda em seguida e como usar no crontab, GitHub Actions, Kubernetes e Node.js.

Atualizado em

* * * * *
Expressão cron
A cada minuto
Agendamento

Abrir no Gerador de Expressões Cron →

O que * * * * * significa

O cron lê cinco campos da esquerda para a direita: minuto, hora, dia do mês, mês e dia da semana. Para a cada minuto, eles são:

CampoValorSignificadoPermitido
Minuto*a cada minuto0–59
Hora*toda hora0–23
Dia do mês*todo dia do mês1–31
Mês*todo mês1–12
Dia da semana*todo dia da semana0–6 (Dom–Sáb)

Próximas execuções

Calculado no seu navegador para seu fuso horário. Em um servidor, o cron usa o fuso horário do servidor (geralmente UTC).

  1. Ative o JavaScript para ver os próximos horários de execução.

Usos comuns

  • Consultar uma fila ou caixa de entrada
  • Verificações de saúde e heartbeats
  • Testar se o cron está rodando

Bom saber

Roda 1.440 vezes por dia. Garanta que o job termine bem antes de um minuto, ou use um lock (flock) para que as execuções não se sobreponham.

Use no crontab, GitHub Actions, Kubernetes e Node.js

crontab (crontab -e):

* * * * * /usr/local/bin/my-job.sh >> /var/log/my-job.log 2>&1

GitHub Actions (horários em UTC): o GitHub Actions executa agendamentos no máximo a cada 5 minutos, então este seria limitado por lá.

on:
  schedule:
    - cron: '* * * * *'

Kubernetes CronJob:

apiVersion: batch/v1
kind: CronJob
metadata:
  name: my-job
spec:
  schedule: "* * * * *"
  concurrencyPolicy: Forbid
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: my-job
              image: alpine:3
              command: ["sh", "-c", "echo running"]

Node.js (node-cron):

import cron from 'node-cron';
cron.schedule('* * * * *', () => {
  // your job
});

Agendamentos relacionados

Perguntas frequentes

Qual é a expressão cron para a cada minuto?
* * * * *. Roda a cada minuto.
Qual fuso horário o cron usa?
O cron clássico usa o fuso horário local do servidor, e muitos servidores rodam em UTC. O GitHub Actions sempre usa UTC. Os CronJobs do Kubernetes usam o fuso horário do controlador, a menos que você defina spec.timeZone (por exemplo Europe/Berlin).
Como testo uma expressão cron?
Cole no Gerador de Expressões Cron para ver em linguagem simples, com os próximos horários de execução, e depois confira o log do seu job após a primeira execução agendada.