¿Qué es un runner en GitHub Actions?
Última actualización
Un runner en GitHub Actions es la máquina, virtual o física, que ejecuta un job de un workflow. GitHub elige un runner cuyas etiquetas coinciden con el valor de runs-on del job, ejecuta en él los steps del job y devuelve el resultado.
Cómo funciona
Cuando se activa un workflow, cada job se pone en cola con sus etiquetas runs-on. Un runner que tenga todas esas etiquetas y esté libre toma el job. El runner descarga las actions que necesitan sus steps, ejecuta cada step en orden, envía los logs a GitHub y, después, informa de si el resultado ha sido correcto o fallido.
Los jobs no comparten máquina. Dos jobs del mismo workflow se ejecutan en dos runners distintos, por lo que los archivos de un job no son visibles para el siguiente, a menos que los pase como un artifact o como caché.
Existen tres tipos habituales de runner:
- Alojados por GitHub: máquinas virtuales que GitHub crea para cada job y elimina después. Etiquetas como
ubuntu-latest,windows-latestymacos-latest. - Runners grandes: máquinas alojadas por GitHub con más CPU y RAM, facturadas por minuto a una tarifa más alta.
- Runners autoalojados: máquinas que usted o un proveedor ejecutan, identificadas mediante etiquetas personalizadas.
Cada runner es también una unidad de facturación. Cada minuto que un job ocupa un runner cuenta para sus minutos de CI.
Ejemplo
jobs:
test:
runs-on: ubuntu-latest # GitHub-hosted, 2-core
steps:
- uses: actions/checkout@v4
- run: npm ci && npm test
build:
runs-on: [self-hosted, Linux, compiler-ci] # matched by labels
steps:
- uses: actions/checkout@v4
- run: make build
Errores comunes
- Suponer que el estado se conserva. Un runner alojado se borra después de cada job. Todo lo que quiera conservar debe guardarse en caché o subirse.
- Errores tipográficos en las etiquetas. Si ningún runner coincide con las etiquetas, el job queda en cola hasta que agota el tiempo de espera. Revise la ortografía y las mayúsculas.
- Usar el runner más grande por defecto. Las máquinas más potentes solo ayudan si su job está realmente limitado por la CPU. Mida primero con el selector de tamaño de runner.
- Ignorar el límite de tiempo de los jobs. Los jobs tienen un tiempo máximo de ejecución; consulte los límites de tiempo de GitHub Actions.
Si sus jobs son lentos, un runner más rápido es la solución más económica, porque no requiere cambios en el workflow. La guía de runners más rápidos compara las opciones, y compiler.dev ejecuta sus jobs existentes en máquinas de 8 vCPU con una sola línea de YAML. Consulte los precios.
Términos relacionados
Preguntas frecuentes
¿Es un runner lo mismo que un workflow?
No. Un workflow es el archivo YAML que define qué hacer. Un runner es la máquina que lo hace. Un mismo workflow puede usar varios runners, uno por job.
¿Puede un mismo runner ejecutar varios jobs a la vez?
Un runner estándar ejecuta un job cada vez. Los jobs paralelos se asignan a runners distintos. Algunas configuraciones autoalojadas inician varios procesos de runner en un mismo host, pero cada uno sigue ejecutando un único job.
¿Qué me ofrece ubuntu-latest?
Una máquina virtual Linux alojada por GitHub. Su tamaño depende del tipo de repositorio y del plan, así que consulte la referencia actual de runners de GitHub antes de suponer sus especificaciones.
Relacionado
- ¿Qué son los minutos de CI? Facturación de GitHub ActionsLos minutos de CI son el tiempo de cómputo facturado que usan sus pipelines. Cómo GitHub Actions cuenta los minutos y reduzca su consumo.
- ¿Qué es una clave de caché en GitHub Actions?Una clave de caché identifica una caché guardada en GitHub Actions. Aprenda cómo funcionan las claves y restore-keys y cómo evitar cachés obsoletas.
- ¿Qué es un grupo de concurrencia en GitHub Actions?Un grupo de concurrencia hace que GitHub Actions ejecute un workflow o job a la vez por clave y puede cancelar ejecuciones antiguas. Vea el YAML y los errores comunes.
- ¿Qué es una prueba inestable? Definición y causasUna prueba inestable pasa y falla con el mismo código sin cambios. Conozca las causas habituales, cómo detectarlas en CI y cómo corregirlas o aislarlas.