Saltar al contenido

¿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.

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.