Runners autohospedados para entornos locales

Le damos la bienvenida al mundo de los runners autoalojados. Estas herramientas permiten ejecutar flujos de trabajo de GitHub Actions en sus propias máquinas.

En lugar de utilizar los runners basados en la nube de GitHub, puede aportar su propio hardware, sistema operativo y entorno de red para ejecutar sus trabajos de CI/CD.

Aunque los runners alojados por GitHub son prácticos, los runners autoalojados ofrecen ventajas únicas:

• Hardware específico: Utilizar hardware personalizado, como GPU o arquitecturas de CPU específicas.
• Acceso a la red: Conectarse directamente a redes y recursos privados (bases de datos y servicios internos).
• Seguridad: Mantener los entornos de compilación confidenciales dentro de su propia infraestructura controlada.
• Optimización de costes: Reducir potencialmente los costes en usos de gran volumen al aprovechar la infraestructura existente.

Para configurar un runner autohospedado, su máquina debe cumplir algunos requisitos básicos:

• Sistema operativo: Se admiten Linux, Windows y macOS.
• Acceso a la red: La máquina del runner debe poder comunicarse con GitHub.com (o GitHub Enterprise Server).
• Recursos: CPU, RAM y espacio en disco suficientes para ejecutar los trabajos de su flujo de trabajo.
• Software: Las herramientas o los SDK que requieran sus flujos de trabajo deben estar instalados en el runner.

La configuración de un runner autohospedado implica varios pasos clave. Es como preparar su máquina para que se convierta en un trabajador dedicado para GitHub Actions:

1. Genere un token de registro único desde GitHub.
2. Descargue y extraiga la aplicación del runner en su máquina.
3. Configure el runner con la URL de su repositorio u organización de GitHub y el token.
4. Inicie la aplicación del runner para que escuche los trabajos.

Primero, debe informar a GitHub de que está configurando un runner nuevo. Para ello, necesita un token único.

Vaya a la configuración de su repositorio u organización en GitHub.com:

• Para un repositorio: Settings > Actions > Runners > New self-hosted runner
• Para una organización: Settings > Actions > Runners > New self-hosted runner

Siga las indicaciones para generar un token. Este token solo se utiliza para el registro.

A continuación, descargue la aplicación del runner en la máquina que haya elegido. La interfaz de GitHub proporcionará comandos específicos para su sistema operativo.

Por ejemplo, en una máquina Linux, podría usar:

Después de extraer los archivos, configurará el runner. Esto lo vincula a su repositorio u organización de GitHub y le permite establecer etiquetas.

Ejecute el script config.sh (Linux/macOS) o config.cmd (Windows). Deberá proporcionar la URL de GitHub y el token que generó anteriormente.

Una vez configurado, puede iniciar la aplicación del runner. Esta se conectará a GitHub y esperará los trabajos.

Solo tiene que ejecutar ./run.sh (Linux/macOS) o run.cmd (Windows). En entornos de producción, se recomienda instalar el runner como servicio para que se inicie automáticamente.

Para usar su runner autohospedado, especifíquelo en el archivo YAML del flujo de trabajo mediante la palabra clave runs-on. Puede usar self-hosted o etiquetas específicas que haya asignado durante la configuración.

Los runners autohospedados ofrecen ventajas únicas frente a los runners hospedados por GitHub. ¿Cuál de las siguientes es una ventaja principal de usar un runner autohospedado?

¡Ha aprendido sobre los runners autohospedados! Estos le permiten ejecutar flujos de trabajo de GitHub Actions en su propia infraestructura, con control sobre el hardware, el acceso a la red y la seguridad.

Hemos repasado el proceso de configuración: generar un token, descargar la aplicación, configurar e iniciar el runner. También ha visto cómo seleccionar sus runners personalizados en los archivos YAML de sus flujos de trabajo mediante runs-on.