GitHub Actions: el workflow programado no se ejecuta
Actualizada el 15 de noviembre de 2026
Un workflow (flujo de trabajo) programado puede no iniciarse sin que aparezca una ejecución fallida en la pestaña Actions. Revisa estos puntos en orden: primero si GitHub puede iniciar el workflow y después si el horario está configurado como esperas. Los comandos usan la CLI de GitHub (gh); ejecútalos desde el repositorio y reemplaza backup.yml por el nombre de tu archivo.
1. ¿El workflow está en la rama predeterminada?
Un workflow programado se ejecuta sobre el último commit de la rama predeterminada, y solo si su archivo está en esa rama. Un schedule agregado en otra rama no hace nada hasta que lo fusionas. Mira cuál es la rama predeterminada, y qué workflows encuentra GitHub en ella:
gh repo view --json defaultBranchRef --jq .defaultBranchRef.name
gh workflow list --all
Si el workflow no está en la lista, comprueba que su archivo esté en .github/workflows/ en la rama predeterminada.
2. ¿GitHub lo desactivó?
gh workflow list --all también muestra el estado de cada workflow. Si el estado empieza con disabled, el workflow está desactivado y no puede ejecutarse. Estas son algunas causas:
- En un repositorio público, GitHub desactiva los workflows programados tras 60 días sin actividad en el repositorio. La documentación de GitHub no dice qué cuenta como actividad; en la práctica, los commits nuevos cuentan, y las ejecuciones programadas no. Es la causa habitual en un repositorio que solo existe para ejecutar algo por horario.
- En un fork de un repositorio público, los workflows programados empiezan desactivados.
- Alguien lo desactivó en la pestaña Actions.
Actívalo de nuevo en la pestaña Actions, con el botón “Enable workflow” del workflow, o con:
gh workflow enable backup.yml
Revisa también si Actions está desactivado para todo el repositorio en Settings → Actions → General.
Si tu empresa usa cuentas de usuario administradas, revisa la cuenta de la última persona que cambió el horario. Si se dio de baja, el workflow programado deja de ejecutarse. Una persona con permiso de escritura puede reactivarlo con un commit que cambie la línea cron.
3. ¿La expresión cron es válida para GitHub?
on:
schedule:
- cron: '17 3 * * *'
-
Tiene cinco campos, como en un crontab: minuto, hora, día del mes, mes y día de la semana, con
*,,,-y/. Una expresión con segundos o con?, como las de Quartz o AWS, aquí no es válida. -
Va entre comillas. En YAML, un valor que empieza con
*significa otra cosa. -
@daily,@hourlyy los otros atajos no funcionan. Sí se admiten abreviaturas de meses y días de la semana, comoJAN-DECySUN-SAT. - El intervalo más corto es de 5 minutos.
Pega la expresión en el probador de expresiones cron para ver qué significa y cuándo se ejecuta.
4. ¿Está en la zona horaria que crees?
Los horarios usan UTC salvo que configures otra zona horaria: 0 9 * * 1-5 corresponde a las 9:00 UTC, que son las 4:00 o las 5:00 en Nueva York, según la época del año. Para usar otra zona horaria, agrega su nombre junto a la expresión:
on:
schedule:
- cron: '30 5 * * 1-5'
timezone: "America/New_York"
Cuando empieza el horario de verano, un horario en la hora que ese día no existe pasa a la siguiente hora válida: uno a las 2:30 se ejecuta a las 3:00. Más detalles en la zona horaria de cron.
5. Se ejecuta tarde, o no todos los días
GitHub no garantiza que la ejecución empiece en el minuto indicado. Su documentación dice que las ejecuciones programadas pueden atrasarse cuando muchos workflows empiezan a la vez, especialmente al inicio de cada hora. Si la carga es alta, algunas ejecuciones en cola pueden descartarse.
-
Evita el minuto 0. Usar
17 3 * * *en lugar de0 3 * * *ayuda a evitar el período de mayor carga. - No lo uses para algo que debe empezar a una hora exacta, o que no puede saltarse un día sin que nadie lo sepa.
Para ver cuándo empezaron de verdad las ejecuciones programadas:
gh run list --workflow=backup.yml --event=schedule --limit 10
6. ¿La ejecución empieza, pero se salta sus jobs?
Si la ejecución aparece en la pestaña Actions, pero sus jobs (grupos de pasos) están omitidos, revisa sus condiciones if:. Una condición escrita para otro evento, como github.event_name == 'push', es falsa en una ejecución programada. Además, los parámetros de entrada de workflow_dispatch están vacíos. Si el workflow tiene varios horarios, github.event.schedule contiene la expresión que inició esa ejecución:
on:
schedule:
- cron: '17 3 * * *'
- cron: '17 15 * * 1'
jobs:
weekly-report:
if: github.event.schedule == '17 15 * * 1'
Ejecútalo ahora
Un workflow que solo tiene schedule no se puede iniciar a mano. Agrega workflow_dispatch junto a él:
on:
schedule:
- cron: '17 3 * * *'
workflow_dispatch:
Cuando eso esté en la rama predeterminada, la pestaña Actions muestra un botón “Run workflow”, y puedes iniciarlo y seguirlo desde la terminal:
gh workflow run backup.yml
gh run watch
La ejecución manual permite comprobar si los jobs funcionan. Para comprobar también el horario, usa gh run list después de la próxima hora programada y revisa si se inició una ejecución.
Entérate cuando deje de ejecutarse
Cuando una ejecución programada falla, GitHub le avisa a una sola persona: la última que cambió la línea cron, o la que activó de nuevo el workflow. Cuando no empieza, porque GitHub desactivó el workflow o descartó la ejecución, no le avisa a nadie.
Para enterarte en los dos casos, el workflow tiene que avisar de cada ejecución a un monitor que la espera: cuándo empieza y cómo termina. Con CronDrive, agrega un paso al inicio y otro al final del job:
jobs:
backup:
runs-on: ubuntu-latest
env:
CRONDRIVE: https://job.crondrive.com/<token>
steps:
- run: curl -fsS -m 10 "$CRONDRIVE/start/$GITHUB_RUN_ID.$GITHUB_RUN_ATTEMPT" || true
- uses: actions/checkout@v4
- run: ./backup.sh
- if: always()
run: |
if [ "${{ job.status }}" = "success" ]; then code=0; else code=1; fi
curl -fsS -m 10 "$CRONDRIVE/end/$code/$GITHUB_RUN_ID.$GITHUB_RUN_ATTEMPT" || true
if: always() hace que el último paso se ejecute cuando uno anterior falla, y || true evita que un error de red en la llamada haga fallar el job. En un repositorio público, guarda la URL en un secreto: quien tenga el token puede informar ejecuciones.
Crea el job en CronDrive con la misma expresión y la misma zona horaria: UTC, o la indicada en timezone. Como GitHub puede iniciar una ejecución tarde, configura un margen de espera para el inicio; por ejemplo, 30 minutos. CronDrive te avisa si una ejecución falla, si no empieza dentro del margen de espera o si supera el tiempo máximo que configuraste para terminar.