Agrega ejecutores auto-hospedados

Puede agregar un ejecutor autohospedado a un repositorio, una organización o una empresa.

So eres un administrador de alguna organización o empresa, podría que quisieras agregar tus ejecutores auto-hospedados a nivel organizacional o empresarial. Este acercamiento hace que el ejecutor esté disponible para múltiples repositorios en tu organización o empresa y también te permite administrar tus ejecutores en un solo lugar.

Para obtener información sobre los sistemas operativos compatibles con los ejecutores autohospedados o sobre el uso de ejecutores autohospedados con un servidor proxy, consulta Acerca de los ejecutores autohospedados.

Puedes configurar la automatización para escalar la cantidad de ejecutores auto-hospedados. Para más información, consulta Autoescalar con ejecutores auto-hospedados.

Puedes registrar ejecutores efímeros que realizan un único trabajo antes de limpiar el registro mediante el registro de ejecutor Just-In-Time. Para más información, consulta Fortalecimiento de seguridad para GitHub Actions.

Requisitos previos

• Debe tener acceso a la máquina que usará como ejecutor autohospedado en su entorno.

Agregar un ejecutor auto-hospedado a un repositorio

Puedes agregar ejecutores auto-hospedados a un solo repositorio. Para agregar un ejecutor auto-hospedado a un repositorio de usuario, debes ser el dueño del mismo. Para un repositorio de la organización, debe ser propietario de la organización o tener acceso de administrador al repositorio.

Para obtener información sobre cómo añadir un ejecutor autohospedado con la API REST, consulta Puntos de conexión de API de REST para ejecutores autohospedados.

1. En GitHub, navegue hasta la página principal del repositorio.

2. En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

4. Haga clic en New self-hosted runner (Nuevo ejecutor autohospedado).

5. La imagen y arquitectura de tu sistema operativo para tu máquina del ejecutor auto-hospedado.

   

6. Verás instrucciones que te mostrarán cómo descargar la aplicación del ejecutor e instalarla en tu máquina de ejecutor autoalojado.

   Abre un shell en tu máquina de ejecutor autoalojado y ejecuta cada comando del shell en el orden que se muestra.

   Note

   En Windows, si quieres instalar la aplicación de ejecutor auto-hospedado como un servicio, tendrás que abrir un shell con privilegios de administrador. También se recomienda usar C:\actions-runner como directorio para la aplicación del ejecuto autohospedado de modo que las cuentas del sistema de Windows puedan acceder al directorio del ejecutor.

   Las instrucciones te guían para completar estas tareas:

   • Descargar y extraer la aplicación de ejecutor autoalojado.
   • Ejecutar el script config para configurar la aplicación de ejecutor autohospedado y registrarla con GitHub Actions. El script config necesita la URL de destino y un token generado automáticamente de duración limitada para autenticar la solicitud. El token caduca después de una hora.
     • En Windows, el script config también le pregunta si quiere instalar la aplicación de ejecutor autohospedado como un servicio. Para Linux y macOS, puedes instalar un servicio después de que termines de agregar el ejecutor. Para obtener más información, vea «Configurar la aplicación del ejecutor autoalojado como un servicio».
   • Ejecutar la aplicación del ejecutor autoalojado para conectar la máquina a las GitHub Actions.

Revisar que tu ejecutor auto-hospedado se haya agregado exitosamente

Después de completar estos pasos para agregar un ejecutor autohospedado, este ejecutor y su estado ahora se muestran en "Ejecutores".

La aplicación del ejecutor autoalojado debe estar activa para que el ejecutor acepte trabajos. Cuando la aplicación del ejecutor esté conectada a GitHub y esté lista para recibir trabajos, verá el siguiente mensaje en el terminal de la máquina.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

Para más información, consulta Supervisión y solución de problemas de ejecutores autohospedados.

Agregar un ejecutor auto-hospedado a una organización

Puedes agregar ejecutores auto-hospedados a nivel organizacional, en donde se podrán utilizar para procesar jobs para varios repositorios en una organización. Para agregar un ejecutor autohospedado a una organización, debe ser propietario de la organización. Para obtener información sobre cómo añadir un ejecutor autohospedado con la API REST, consulta Puntos de conexión de API de REST para ejecutores autohospedados.

1. En GitHub, navega a la página principal de tu organización.

2. En el nombre de la organización, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

4. Haz clic en Nuevo ejecutor y, a continuación, en Nuevo ejecutor autohospedado. 1. La imagen y arquitectura de tu sistema operativo para tu máquina del ejecutor auto-hospedado.

   

5. Verás instrucciones que te mostrarán cómo descargar la aplicación del ejecutor e instalarla en tu máquina de ejecutor autoalojado.

   Abre un shell en tu máquina de ejecutor autoalojado y ejecuta cada comando del shell en el orden que se muestra.

   Note

   En Windows, si quieres instalar la aplicación de ejecutor auto-hospedado como un servicio, tendrás que abrir un shell con privilegios de administrador. También se recomienda usar C:\actions-runner como directorio para la aplicación del ejecuto autohospedado de modo que las cuentas del sistema de Windows puedan acceder al directorio del ejecutor.

   Las instrucciones te guían para completar estas tareas:

   • Descargar y extraer la aplicación de ejecutor autoalojado.
   • Ejecutar el script config para configurar la aplicación de ejecutor autohospedado y registrarla con GitHub Actions. El script config necesita la URL de destino y un token generado automáticamente de duración limitada para autenticar la solicitud. El token caduca después de una hora.
     • En Windows, el script config también le pregunta si quiere instalar la aplicación de ejecutor autohospedado como un servicio. Para Linux y macOS, puedes instalar un servicio después de que termines de agregar el ejecutor. Para obtener más información, vea «Configurar la aplicación del ejecutor autoalojado como un servicio».
   • Ejecutar la aplicación del ejecutor autoalojado para conectar la máquina a las GitHub Actions.

Revisar que tu ejecutor auto-hospedado se haya agregado exitosamente

Después de completar estos pasos para agregar un ejecutor autohospedado, este ejecutor y su estado ahora se muestran en "Ejecutores".

La aplicación del ejecutor autoalojado debe estar activa para que el ejecutor acepte trabajos. Cuando la aplicación del ejecutor esté conectada a GitHub y esté lista para recibir trabajos, verá el siguiente mensaje en el terminal de la máquina.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

Para más información, consulta Supervisión y solución de problemas de ejecutores autohospedados.

Agregar un ejecutor auto-hospedado a una empresa

Si utilizas GitHub Enterprise Cloud, puedes agregar ejecutores auto-hospedados a una empresa en donde estos pueden asignarse a varias organizaciones. El propietario de la organización podrá controlar entonces qué repositorios pueden utilizarlo. Para obtener más información, consulta la documentación de GitHub Enterprise Cloud.