Nota: Los ejecutores hospedados en GitHub no son compatibles con GitHub Enterprise Server actualmente. Puedes encontrar más información sobre el soporte que se tiene planeado en el futuro en el Itinerario público de GitHub.
You can add a self-hosted runner to a repository, an organization, or an enterprise.
If you are an organization or enterprise administrator, you might want to add your self-hosted runners at the organization or enterprise level. This approach makes the runner available to multiple repositories in your organization or enterprise, and also lets you to manage your runners in one place.
For information on supported operating systems for self-hosted runners, or using self-hosted runners with a proxy server, see "About self-hosted runners."
Warning: Te recomendamos que solo utilices los ejecutores auto-hospedados con los repositorios privados. Esto se debe a que tu repositorio podría ejecutar código peligroso en tu máquina de ejecutor auto-hospedado potencialmente al crear una solicitud de cambios que excluya el código en un flujo de trabajo.
For more information, see "About self-hosted runners."
Adding a self-hosted runner to a repository
You can add self-hosted runners to a single repository. To add a self-hosted runner to a user repository, you must be the repository owner. For an organization repository, you must be an organization owner or have admin access to the repository. For information about how to add a self-hosted runner with the REST API, see "Self-hosted runners."
-
En tu instancia de GitHub Enterprise Server, visita la página principal del repositorio.
-
Debajo de tu nombre de repositorio, da clic en Configuración.
-
En la barra lateral izquierda, haz clic en Acciones.
-
Under "Self-hosted runners", click Add runner.
-
La imagen y arquitectura de tu sistema operativo para tu máquina del ejecutor auto-hospedado.
-
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.
Nota: En Windows, si deseas instalar la aplicación del ejecutor autoalojado como un servicio, debes abrir un shell con privilegios de administrador. También recomendamos que uses
C:\actions-runner
como el directorio para la aplicación del ejecutor autoalojado 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 del ejecutor auto-hospedado y registrarlo con GitHub Actions. El scriptconfig
requiere la URL destino y un token de tiempo limitado generado automáticamente para autenticar la solicitud.- En Windows, el script
config
también te pregunta si deseas instalar la aplicación del ejecutor autoalojado 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, consulta "Configurar la aplicación del ejecutor autoalojado como un servicio."
- En Windows, el script
- 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 auto-hospedado, dicho ejecutor y su estado ahora se listan bajo "Ejecutores auto-hospedados".
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 Enterprise Server y lista para recibir trabajos, verás el siguiente mensaje en la terminal de la máquina.
√ Connected to GitHub
2019-10-24 05:45:56Z: Listening for Jobs
Para obtener más información, consulta la sección "Monitorear y solucionar problemas de los ejecutores auto-hospedados".
Adding a self-hosted runner to an organization
You can add self-hosted runners at the organization level, where they can be used to process jobs for multiple repositories in an organization. To add a self-hosted runner to an organization, you must be an organization owner. For information about how to add a self-hosted runner with the REST API, see "Self-hosted runners."
-
En tu instancia de GitHub Enterprise Server, navega hasta la página principal de la organización.
-
Debajo del nombre de tu organización, da clic en Ajustes.
-
En la barra lateral izquierda, haz clic en Acciones.
-
Under "Self-hosted runners", click Add runner."
-
La imagen y arquitectura de tu sistema operativo para tu máquina del ejecutor auto-hospedado.
-
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.
Nota: En Windows, si deseas instalar la aplicación del ejecutor autoalojado como un servicio, debes abrir un shell con privilegios de administrador. También recomendamos que uses
C:\actions-runner
como el directorio para la aplicación del ejecutor autoalojado 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 del ejecutor auto-hospedado y registrarlo con GitHub Actions. El scriptconfig
requiere la URL destino y un token de tiempo limitado generado automáticamente para autenticar la solicitud.- En Windows, el script
config
también te pregunta si deseas instalar la aplicación del ejecutor autoalojado 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, consulta "Configurar la aplicación del ejecutor autoalojado como un servicio."
- En Windows, el script
- 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 auto-hospedado, dicho ejecutor y su estado ahora se listan bajo "Ejecutores auto-hospedados".
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 Enterprise Server y lista para recibir trabajos, verás el siguiente mensaje en la terminal de la máquina.
√ Connected to GitHub
2019-10-24 05:45:56Z: Listening for Jobs
Para obtener más información, consulta la sección "Monitorear y solucionar problemas de los ejecutores auto-hospedados".
Nota: Por razones de seguridad, los repositorios públicos no pueden utilizar ejecutores en un grupo de ejecutores predeterminadamente, pero puedes anular esto en la configuración del grupo de ejecutores. Para obtener más información, consulta la sección "Administrar el acceso a los ejecutores auto-hospedados".
Adding a self-hosted runner to an enterprise
You can add self-hosted runners to an enterprise, where they can be assigned to multiple organizations. The organization admins are then able to control which repositories can use it.
New runners are assigned to the default group. You can modify the runner's group after you've registered the runner. For more information, see "Managing access to self-hosted runners."
To add a self-hosted runner at the enterprise level of tu instancia de GitHub Enterprise Server, you must be a site administrator.
-
En la esquina superior derecha de GitHub Enterprise Server, da clic en tu foto de perfil y luego en Configuración de empresa.
-
En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).
-
Debajo de " Políticas", haz clic en Acciones.
-
Haz clic en la pestaña de Ejecutores auto-hospedados.
-
Click Add new, then click New runner.
-
La imagen y arquitectura de tu sistema operativo para tu máquina del ejecutor auto-hospedado.
-
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.
Nota: En Windows, si deseas instalar la aplicación del ejecutor autoalojado como un servicio, debes abrir un shell con privilegios de administrador. También recomendamos que uses
C:\actions-runner
como el directorio para la aplicación del ejecutor autoalojado 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 del ejecutor auto-hospedado y registrarlo con GitHub Actions. El scriptconfig
requiere la URL destino y un token de tiempo limitado generado automáticamente para autenticar la solicitud.- En Windows, el script
config
también te pregunta si deseas instalar la aplicación del ejecutor autoalojado 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, consulta "Configurar la aplicación del ejecutor autoalojado como un servicio."
- En Windows, el script
- 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 auto-hospedado, dicho ejecutor y su estado ahora se listan bajo "Ejecutores auto-hospedados".
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 Enterprise Server y lista para recibir trabajos, verás el siguiente mensaje en la terminal de la máquina.
√ Connected to GitHub
2019-10-24 05:45:56Z: Listening for Jobs
Para obtener más información, consulta la sección "Monitorear y solucionar problemas de los ejecutores auto-hospedados".
Nota: Por razones de seguridad, los repositorios públicos no pueden utilizar ejecutores en un grupo de ejecutores predeterminadamente, pero puedes anular esto en la configuración del grupo de ejecutores. Para obtener más información, consulta la sección "Administrar el acceso a los ejecutores auto-hospedados".
Making enterprise runners available to repositories
By default, runners in an enterprise's "Default" self-hosted runner group are available to all organizations in the enterprise, but are not available to all repositories in each organization.
To make an enterprise-level self-hosted runner group available to an organization repository, you might need to change the organization's inherited settings for the runner group to make the runner available to repositories in the organization.
For more information on changing runner group access settings, see "Managing access to self-hosted runners using groups."