¿Qué es un runner autoalojado? (GitHub Actions)
Última actualización
Un runner autohospedado es una máquina que usted administra o alquila a un proveedor, y que se registra en GitHub y ejecuta sus trabajos de Actions en lugar de una máquina virtual alojada por GitHub. Usted elige el hardware, el sistema operativo y las herramientas instaladas.
Cómo funciona
Instala la aplicación del runner de GitHub en un servidor, una VM o un contenedor, y lo registra en un repositorio, una organización o una empresa con un token. El runner abre una conexión saliente a GitHub y consulta si hay trabajo pendiente. Cuando las etiquetas de runs-on de un trabajo coinciden con las del runner, lo ejecuta localmente.
Cada runner recibe las etiquetas predeterminadas self-hosted, una etiqueta de sistema operativo (Linux, Windows, macOS) y una etiqueta de arquitectura (X64, ARM64). Puede añadir etiquetas personalizadas, como gpu o compiler-ci, para dirigir los trabajos a máquinas concretas.
Hay dos modos de funcionamiento:
- Persistente: el runner permanece activo y ejecuta trabajo tras trabajo. Las cachés son rápidas, pero el estado se filtra entre trabajos.
- Efímero: el runner ejecuta un único trabajo (
--ephemeral) y después se destruye. Es limpio, más seguro y normalmente se escala automáticamente.
Ejemplo
jobs:
build:
runs-on: [self-hosted, Linux, X64]
steps:
- uses: actions/checkout@v4
- run: ./gradlew build
Cuándo compensa
- Necesita hardware que GitHub no ofrece, como GPUs o tipos de CPU específicos.
- Los trabajos deben acceder a redes privadas o a sistemas locales.
- Los minutos alojados le cuestan demasiado con su volumen de uso. Consulte precios de GitHub Actions.
- Las compilaciones son lentas y quiere cachés locales ya calentadas.
Los compromisos se explican en runners autohospedados frente a runners alojados por GitHub. Los proveedores gestionados le ofrecen las ventajas sin el trabajo de parches y escalado automático; compiler.dev es uno de ellos, y para cambiar basta con modificar runs-on a [self-hosted, Linux, compiler-ci].
Errores comunes
- Uso de runners persistentes en repositorios públicos. Una pull request desde un fork puede ejecutar código arbitrario en su máquina. Evite los runners autohospedados en repositorios públicos, a menos que sean efímeros y estén aislados.
- No limpiar nunca el espacio de trabajo. Los archivos sobrantes provocan fallos desconcertantes del tipo «funciona en la segunda ejecución».
- Sin escalado automático. Un grupo fijo deja trabajos en cola en las horas punta y recursos inactivos por la noche.
- Omitir las actualizaciones. Los runners que se quedan muy atrás de la versión actual del runner pueden dejar de recibir trabajos.
- Almacenar secretos de larga duración en el host. Es preferible usar OIDC para el acceso a la nube. Consulte también cómo proteger GitHub Actions.
Términos relacionados
Preguntas frecuentes
¿Los runners autohospedados son gratuitos?
El precio de GitHub para los runners autohospedados ha cambiado con el tiempo, así que consulte la página de facturación actual de GitHub. En todo caso, usted paga siempre las propias máquinas.
¿Es segura un runner autohospedado?
Solo es tan segura como su aislamiento. Use runners efímeros, credenciales con los mínimos privilegios necesarios, y no ejecute en ellos código de forks no confiables.
¿Cómo envío un trabajo a uno?
Indique sus etiquetas en runs-on, como una lista. El trabajo se ejecuta en un runner que tenga todas las etiquetas de la lista.
Relacionado
- Runners autohospedados vs. GitHub-hosted: coste y riesgoCompare runners alojados en GitHub, autohospedados y de terceros en coste, velocidad, seguridad y mantenimiento, con fórmula de punto de equilibrio.
- Runner perdió la comunicación con el servidor: solución¿El runner perdió la comunicación con el servidor en GitHub Actions? Suele deberse a falta de memoria o disco lleno. Encuentre la causa y solúltela con YAML.
- ¿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.