Saltar al contenido

Esperando a un runner para ejecutar este job: soluciones

Última actualización

Waiting for a runner to pick up this job significa que su job está en cola y ningún runner lo ha aceptado todavía. En los runners alojados por GitHub, suele deberse a un límite de concurrencia o a un retraso breve de capacidad; en los runners autohospedados, casi siempre es una etiqueta runs-on que no coincide con ningún runner en línea. Esta página cubre ambos casos, con los límites de la página de límites de uso de GitHub, consultada en octubre de 2026.

El mensaje exacto

Waiting for a runner to pick up this job...

Lo verá en la parte superior del registro de un job en cola, y el job muestra el estado amarillo "Queued". Algunas configuraciones autohospedadas muestran Requested labels: self-hosted, linux, gpu y Job defined at: ... junto a Waiting for a runner to pick up this job..., lo que ayuda a detectar la falta de coincidencia.

Causa 1: las etiquetas del runner autohospedado no coinciden

Si usa runs-on: [self-hosted, linux, x64], un runner debe estar en línea y tener todas esas etiquetas. Las erratas y las etiquetas que faltan son la causa más frecuente. Compruebe:

  1. Settings, después Actions, después Runners: ¿el runner está Online y Idle?
  2. ¿Sus etiquetas incluyen todo lo que aparece en runs-on? Cada etiqueta debe estar presente en el mismo runner.
  3. ¿El runner pertenece al grupo de runners correcto y ese grupo permite su repositorio?
  4. ¿Está en ejecución el servicio del runner en el host (systemctl status actions.runner.*)?
jobs:
  build:
    runs-on: [self-hosted, linux, x64]

El tiempo de espera en cola de los runners autohospedados está limitado a 24 horas; después de ese plazo, el job se cancela automáticamente, según la página de límites.

Causa 2: ha alcanzado el límite de concurrencia

GitHub limita cuántos jobs se ejecutan a la vez. Los jobs adicionales esperan en cola hasta que se libere una plaza. Cifras para los runners estándar alojados por GitHub:

PlanJobs simultáneosmacOS
Gratuito205
Pro405
Equipo605
Enterprise50050

Los runners más grandes tienen sus propios límites: los planes Team y Enterprise pueden ejecutar hasta 1,000 jobs simultáneos en total, y la concurrencia por runner varía según el tipo. Una matriz de 30 celdas en el plan Free ejecutará 20 y pondrá 10 en cola. El tamaño de la matriz, muchos PR que envían cambios a la vez y los workflows programados a la hora en punto se suman. Consulte compilaciones con matrices para max-parallel y el expansor de matrices para contar sus celdas.

Solución: reduzca los jobs en paralelo, cancele las ejecuciones que hayan quedado obsoletas o añada capacidad.

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

Esto cancela las ejecuciones anteriores de la misma rama cuando llega un nuevo push, lo que libera plazas (lea The operation was canceled antes de activarlo en workflows de despliegue).

Causa 3: el job espera a un runner más grande

Un runner más grande (con una etiqueta personalizada) se pone en cola cuando alcanza su propio máximo o cuando el autoescalado aún no ha aprovisionado máquinas. Compruebe la concurrencia máxima del runner y auméntela en su configuración si el plan lo permite.

Causa 4: un retraso breve de capacidad o de incidencia

En ocasiones, los runners alojados de un tipo concreto tardan en arrancar. Si hay muchos jobs no relacionados en cola en varios repositorios, consulte la página de estado de GitHub y espere. No cancele y vuelva a ejecutar en bucle, porque cada nueva ejecución va al final de la cola.

Causa 5: etiqueta runs-on incorrecta para runners alojados

Una etiqueta que no existe (por ejemplo ubuntu-24 en lugar de ubuntu-24.04, o una imagen retirada) deja el job en cola sin ningún runner que lo recoja. Use una etiqueta de la lista de runners alojados. El comprobador de YAML detecta erratas evidentes.

Causa 6: bloqueos de facturación o de políticas

Si la cuenta ha alcanzado un límite de gasto, el job falla en lugar de ponerse en cola, con un mensaje distinto. La política de la organización también puede restringir qué runners puede usar un repositorio.

Cómo diagnosticarlo rápidamente

gh run list --status queued --limit 20
gh api repos/OWNER/REPO/actions/runners --jq '.runners[] | {name, status, busy, labels: [.labels[].name]}'

Si los runners aparecen como online y busy: false pero su job sigue esperando, las etiquetas o los grupos no coinciden. Si todos los runners están busy: true, necesita más capacidad.

Elimine el tiempo en cola de forma definitiva

El tiempo en cola es tiempo perdido para los desarrolladores que esperan una respuesta. Puede añadir runners autohospedados (y gestionar usted el escalado), contratar los runners más grandes de GitHub o usar un proveedor de runners que suministre máquinas bajo demanda. compiler.dev inicia una VM nueva de 8 vCPU / 16 GB por job y ejecuta sus jobs existentes tras cambiar una sola línea a runs-on: [self-hosted, Linux, compiler-ci], de modo que la concurrencia no está limitada por el nivel de su plan de GitHub. Consulte precios y runners autohospedados frente a runners alojados por GitHub.

Cómo prevenirlo

  1. Use concurrency con cancel-in-progress en los workflows de pull request.
  2. Mantenga los tamaños de matriz dentro de la concurrencia de su plan, o defina max-parallel.
  3. Escalone las programaciones cron en lugar de usar 0 * * * * para todo (el generador de cron ayuda).
  4. Supervise los runners autohospedados y configure alertas cuando no haya ninguno en línea.
  5. Mantenga las etiquetas de los runners en un único lugar documentado.

Preguntas frecuentes

¿Cuánto tiempo puede esperar un job a un runner?

En los runners autohospedados, 24 horas; después GitHub cancela el job. Los jobs en runners alojados normalmente empiezan en segundos o minutos, salvo que haya alcanzado su límite de concurrencia.

¿Por qué mi job está en cola si no hay otros jobs en ejecución?

En los runners autohospedados, las etiquetas o el grupo de runners no coinciden, o ningún runner está en línea. En los runners alojados, revise la etiqueta y la página de estado.

¿Los trabajos en cola tienen coste?

El tiempo en cola no se factura. La facturación comienza cuando un runner empieza a ejecutar el trabajo.

¿Puedo aumentar el límite de concurrencia?

Los límites dependen del plan. Los planes más grandes tienen límites más altos, y los runners más grandes tienen límites independientes. Póngase en contacto con GitHub Support para solicitar aumentos específicos de su plan.