Agrega ejecutores auto-hospedados

Puedes agregar un ejecutor auto-hospedado a GitHub Actions.

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 para los ejecutores autoalojados o el uso de ejecutores autoalojados con un servidor proxy, consulta "Acerca de los ejecutores autoalojados."

Agregar un ejecutor auto-hospedado a un repositorio

Puedes agregar ejecutores auto-hospedados a un solo repositorio. Para agregar un ejecutor autoalojado a un repositorio de usuario, debes ser el propietario del repositorio. Para los repositorios organizacionales, debes ser el propietario de la organización o tener acceso de administrador a éste.

1. En GitHub Enterprise Server, visita la página principal del repositorio.

2. Debajo de tu nombre de repositorio, da clic en Configuración.

3. En la barra lateral izquierda, haz clic en Acciones.

4. Debajo de "Ejecutores auto-hospedados", haz clic en Agregar ejecutor.

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.

   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 script config 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."
   • 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".

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 auto-hospedado a una organización, debes ser el dueño de la misma.

1. En GitHub Enterprise Server, navega hasta la página principal de la organización.

2. Debajo del nombre de tu organización, da clic en Ajustes.

   

3. En la barra lateral izquierda, haz clic en Acciones.

4. Debajo de "Ejecutores auto-hospedados", haz clic en Agregar ejecutor.

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.

   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 script config 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."
   • 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".

Agregar un ejecutor auto-hospedado a una empresa

Puedes agregar ejecutores auto-hospedados a una empresa, en donde pueden asignarse a organizaciones múltiples. Los administradores de la organización podrán controlar entonces qué repositorios pueden utilizarlo.

Los ejecutores nuevos se asignan al grupo predeterminado. Puedes modificar el grupo del ejecutor después de que lo hayas registrado. Para obtener más información, consulta la sección "Administrar el acceso a los ejecutores auto-hospedados".

Para agregar un ejecutor auto-hospedado a nivel empresarial de tu instancia de GitHub Enterprise Server, debes ser un administrador de sitio.

1. En la esquina superior derecha de GitHub Enterprise Server, da clic en tu foto de perfil y luego en Configuración de empresa.

2. En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas).

3. Debajo de " Políticas", haz clic en Acciones.

4. Haz clic en la pestaña de Ejecutores auto-hospedados.

5. Da clic en Agregar nuevo y luego en Ejecutor nuevo.

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

7. 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 script config 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."
   • 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".

Hacer que los ejecutores empresariales estén disponibles para los repositorios

Predeterminadamente, los ejecutores en un grupo de ejecutores auto hospedados "Predeterminado" de una empresa se encontrarán disponibles para todas las organizaciones de ésta, pero no así para todos los repositorios en cada una de las organizaciones.

Para que un grupo de ejecutores auto-hospedados a nivel empresarial se encuentre disponible para el repositorio de una organización, podría que necesites cambiar la configuración heredada de dicha organización para que el grupo de ejecutores pueda poner el ejecutor disponible para sus repositorios.

Para obtener más información acerca de cómo cambiar la configuración de acceso en un grupo de ejecutores, consulta la sección "Administrar el acceso a los ejecutores auto-hospedados utilizando grupos".