Saltar al contenido
Automatización y agentes

GitHub Actions: por qué el cron (schedule) sale tarde y cómo lanzarlo a su hora con Cloudflare

Actualizado el 8 min de lectura

Lo esencial

  • GitHub avisa en su documentación de que una tarea programada puede retrasarse cuando hay mucha carga, y de que algunas pueden no ejecutarse.
  • En este proyecto, turnos fijados a las 11:50 salieron con 4 a 6 horas de retraso, y una tarea de cada media hora corrió cada 6 u 8.
  • La solución: un Worker de Cloudflare, gratis, que a la hora exacta le pide a GitHub que ejecute la tarea. Lleva funcionando desde el 9 de octubre de 2026.
  • Nivel: intermedio. Una cuenta de Cloudflare, una clave de GitHub con un solo permiso y una hora la primera vez.

Programas una tarea en GitHub Actions para las 11:50, con su línea cron bien escrita, y sale a las 16:30. O no sale. No es un error tuyo: es como funciona el evento schedule, y la documentación de GitHub lo dice.

A este proyecto le pasó con la tarea que publica cada Reel. Esta guía cuenta qué pasaba, por qué, y cómo se resolvió con un programa de unas 30 líneas en Cloudflare que no cuesta nada.

Qué necesitas

  • Un repositorio en GitHub con la tarea que quieres lanzar a su hora.
  • Una cuenta de Cloudflare, en el plan gratuito de Workers. Según su página de precios, consultada el 12 de octubre de 2026, incluye 100.000 peticiones al día. Según la de límites, el plan gratuito admite 5 horarios (Cron Triggers) por cuenta: si necesitas más, hay que agruparlos o pagar.
  • Node.js en tu ordenador, para usar wrangler, la herramienta de Cloudflare para subir el programa.
  • Una clave de GitHub con un único permiso, que se crea en el paso 2.
  • Una hora la primera vez. Nivel: intermedio; no hace falta saber JavaScript para copiar el programa, pero sí para cambiarlo.
  • Dinero: nada, dentro de esos límites.

Por qué sale tarde

La documentación de los eventos de GitHub Actions, consultada el 12 de octubre de 2026, lo dice en una nota del evento schedule:

  • Puede retrasarse en periodos de mucha carga, y el comienzo de cada hora es uno de ellos.
  • Si la carga es bastante alta, algunas tareas en cola pueden descartarse: no salen nunca.
  • Recomienda programarlas en un minuto que no sea el principio de la hora.

También dice que el intervalo más corto es de una vez cada 5 minutos y que, por defecto, las horas van en tiempo universal (UTC). La misma página documenta una opción timezone para escribir la hora en tu zona; eso evita hacer cuentas, pero no quita el retraso.

Lo que vivimos el 9 de octubre de 2026, con minutos que ya no eran el principio de la hora:

  • Una tarea pensada para cada media hora se ejecutó cada 6 u 8 horas.
  • Los dos turnos de publicación del día llegaron con 4 a 6 horas de retraso. El de la noche se habría perdido si el retraso pasaba de la medianoche.

Para una copia de seguridad nocturna da igual. Para publicar a una hora o responder a quien te escribe, no.

La idea

GitHub tiene otra forma de lanzar una tarea: el botón Run workflow de la pestaña Actions, que por dentro es una llamada a su API. Esa llamada no espera en la cola del schedule.

Así que el reloj se pone fuera. Cloudflare Workers tiene Cron Triggers: horarios que ejecutan un programa tuyo. Ese programa hace una sola cosa: a la hora fijada, le pide a GitHub que ejecute la tarea. No publica nada, no guarda nada y no atiende visitas.

Paso 1 · Que la tarea se pueda lanzar desde fuera

En el archivo de la tarea, dentro de .github/workflows/, añade workflow_dispatch a sus disparadores. Puedes dejar el schedule como respaldo:

on:
  workflow_dispatch:
  schedule:
    - cron: "50 16 * * *"

La documentación pide que el archivo esté en la rama principal para que esto funcione.

Paso 2 · Una clave de GitHub que solo pueda hacer eso

En GitHub, en Settings → Developer settings → Personal access tokens → Fine-grained tokens, crea una clave nueva:

  • Repository access: solo el repositorio de la tarea.
  • Resource owner: tu cuenta o, si el repositorio es de una organización, la organización. Si la organización exige aprobar las claves, un administrador tendrá que aprobarla.
  • Permisos: solo Actions, en lectura y escritura (Read and write). Es el que pide la API para lanzar una tarea, según la lista de permisos de las claves fine-grained, consultada el 12 de octubre de 2026. GitHub añade solo Metadata en lectura: es obligatorio y no hay que quitarlo.
  • Caducidad: pon una. GitHub avisa por correo antes de que venza, y ese día hay que crearla de nuevo y cambiarla en Cloudflare.

Con esa clave, quien la robe solo puede manejar las tareas de ese repositorio: lanzarlas, cancelarlas o ver sus registros. No puede cambiar tu código.

Paso 3 · El programa

Crea una carpeta con dos archivos. El primero, reloj.js:

// Lanza a su hora tareas de GitHub Actions. No hace nada más.
// Cada horario de wrangler.jsonc ("triggers") lanza una tarea. Los horarios van en hora universal (UTC).
const TAREAS = {
  '50 16 * * *': 'publicar.yml', // 11:50 en Colombia (UTC-5)
  '7,37 * * * *': 'revisar.yml', // cada media hora
};

export default {
  async scheduled(controlador, entorno) {
    const tarea = TAREAS[controlador.cron];
    if (!tarea) throw new Error(`Horario sin tarea: ${controlador.cron}`);
    if (!entorno.GITHUB_TOKEN) {
      console.log(`Falta el secreto GITHUB_TOKEN: no se lanzó ${tarea}.`);
      return;
    }
    const respuesta = await fetch(
      `https://api.github.com/repos/${entorno.REPOSITORIO}/actions/workflows/${tarea}/dispatches`,
      {
        method: 'POST',
        headers: {
          Authorization: `Bearer ${entorno.GITHUB_TOKEN}`,
          Accept: 'application/vnd.github+json',
          'X-GitHub-Api-Version': '2022-11-28',
          'User-Agent': 'mi-reloj',
        },
        body: JSON.stringify({ ref: 'main' }),
      },
    );
    if (!respuesta.ok) {
      throw new Error(`GitHub no aceptó lanzar ${tarea}: ${respuesta.status}`);
    }
    console.log(`Lanzada ${tarea}.`);
  },
};

El segundo, wrangler.jsonc, con los horarios y tu repositorio:

{
  "name": "mi-reloj",
  "main": "reloj.js",
  "compatibility_date": "2026-10-01",
  "triggers": { "crons": ["50 16 * * *", "7,37 * * * *"] },
  "vars": { "REPOSITORIO": "tu-usuario/tu-repositorio" }
}

Cambia los nombres de las tareas por los de tus archivos y cada horario por el tuyo. Cada línea de crons tiene que coincidir, letra por letra, con una clave de TAREAS: así sabe el programa qué tarea toca. Si no coincide, falla a propósito, para que lo veas en el registro.

Dos detalles de la documentación de Cron Triggers, consultada el 12 de octubre de 2026:

  • Las horas son UTC. Colombia y Perú están cinco horas por detrás todo el año. En España la diferencia cambia con el horario de verano, y el horario en UTC no se mueve solo: tendrás que ajustarlo dos veces al año o aceptar una hora de diferencia.
  • Los días de la semana van de 1 (domingo) a 7 (sábado), distinto de GitHub, donde van de 0 a 6. Si los usas, escribe las abreviaturas en inglés (MON, FRI) y te ahorras el error.

Paso 4 · Probarlo en tu ordenador

En la carpeta, ejecuta npx wrangler dev. Con el programa en marcha, la documentación de Cloudflare enseña a simular un horario:

curl "http://localhost:8787/cdn-cgi/local/scheduled?cron=50+16+*+*+*&format=json"

Sin la clave, el registro dice Falta el secreto GITHUB_TOKEN: no se lanzó publicar.yml. y no hace nada más. Es lo que queremos: sin clave, no hay riesgo.

Paso 5 · Subirlo y guardar la clave

  1. Ejecuta npx wrangler deploy. La primera vez te pedirá iniciar sesión en Cloudflare.
  2. En el panel de Cloudflare, abre tu Worker y ve a Settings → Runtime variables and secrets (o un nombre parecido). Añade un secreto llamado GITHUB_TOKEN con la clave del paso 2.

Nos pasó: hay otra sección de variables dentro de Builds que no sirve para esto. Tiene que ser la del Worker en marcha.

Según la documentación, un horario nuevo puede tardar hasta 15 minutos en activarse. Después, en Settings → Trigger Events del Worker verás las últimas 100 ejecuciones, y en la pestaña Actions de GitHub, cada tarea lanzada a su hora.

Qué se comprobó

  • El sistema está en uso en este proyecto desde el 9 de octubre de 2026. Esa noche lanzó la tarea de cada media hora a las 02:07 y a las 02:37 en hora universal, al minuto. Desde el día siguiente lanza también los dos turnos diarios de publicación: del 10 al 12 de octubre de 2026, los turnos de las 16:50 y las 00:30 UTC dejaron su anotación en el repositorio entre uno y tres minutos después de la hora, contando lo que tarda la propia tarea.
  • El programa de esta guía es una versión reducida del que usamos, sin nada propio del proyecto. Se ejecutó el 11 de octubre de 2026 con wrangler dev y la simulación del paso 4, y otra vez el 12: sin clave, avisa y no hace nada; con una clave falsa, GitHub respondió 401 y el programa lo registró como error; con un horario que no está en la lista, falla con su aviso. No se ejecutó con una clave real: eso lo prueba el programa completo, que sí funciona a diario.
  • Los retrasos son los que vimos el 9 de octubre de 2026. Pueden ser menores o mayores en otro momento; la documentación no da cifras.
  • Los nombres de los menús de GitHub y Cloudflare pueden haber cambiado desde esa fecha.

Errores comunes

  • Olvidar workflow_dispatch. La tarea no se lanza: la documentación de GitHub exige ese disparador para hacerlo desde la API.
  • Escribir el horario en tu hora local. Cloudflare lo lee como UTC y la tarea sale cinco horas antes o después.
  • Guardar la clave en el código o en vars. Va como secreto, nunca en un archivo del repositorio.
  • Darle a la clave más permisos de los necesarios. Solo Actions, solo ese repositorio.
  • Pasar de 5 horarios en el plan gratuito. Junta varios en una sola línea, como 7,37 * * * *.

Para seguir

Este reloj es el que lanza la tarea que responde por mensaje directo a quien comenta en Instagram. Si todavía no has hecho tu primera automatización, empieza por algo sin código: tu primer flujo en n8n.

Ctrl+IA no tiene relación con GitHub ni con Cloudflare. Lo que conectes a tus cuentas lo haces bajo tu responsabilidad.

Recibe los prompts nuevos por correo

Al confirmar te llevas de regalo un PDF con los 62 prompts del sitio, listos para copiar. Sin spam, y te das de baja cuando quieras.

Te pediremos confirmar por correo. Al suscribirte aceptas la política de privacidad. Los envíos se gestionan con Kit.

Sigue con