Skip to main content

Agrega ejecutores auto-hospedados

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

Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.

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, consulte "Acerca de los ejecutores autohospedados".

Advertencia: Te recomendamos que solo utilices los ejecutores auto-hospedados con los repositorios privados. Esto se debe a que las bifurcaciones de tu repositorio público podrían ejecutar un código peligroso en tu máquina de ejecutor auto-hospedado al crear una solicitud de cambios que excluya el código en un flujo de trabajo.

Para más información, consulte Seguridad del ejecutor autohospedado con repositorios públicos.

Puedes configurar la automatización para escalar la cantidad de ejecutores auto-hospedados. Para más información, consulte "Escalado automático con ejecutores autohospedados".

Requisitos previos

  • Las GitHub Actions se deben habilitar para GitHub Enterprise Server. Un administrador de sitio puede habilitar y configurar GitHub Actions para la instancia. Para obtener más información, vea "Introducción a GitHub Actions para GitHub Enterprise Server".

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

  • La conexión entre los ejecutores autohospedados y GitHub Enterprise Server se realiza mediante HTTP (puerto 80) o HTTPS (puerto 443). Para garantizar la conectividad por HTTPS, configura TLS para your GitHub Enterprise Server instance. Para más información, vea "Configuración de TLS". Para obtener más información, vea "Acerca de los ejecutores autohospedados".

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 los repositorios organizacionales, debes ser el propietario de la organización o tener acceso de administrador a éste. Para obtener información sobre cómo agregar un ejecutor autohospedado con la API REST, consulte "Ejecutores autohospedados".

  1. En your GitHub Enterprise Server instance, navega a la página principal del repositorio. 1. Debajo del nombre del repositorio, haz clic en Configuración. Botón de configuración del repositorio 1. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

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

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

  4. 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 quiere instalar la aplicación de ejecutor autohospedado como un servicio, tendrá 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.
    • 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 "Self-hosted runners" (Ejecutores autohospedados).

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 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 obtener más detalles, consulte "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 auto-hospedado a una organización, debes ser el dueño de la misma. Para obtener información sobre cómo agregar un ejecutor autohospedado con la API REST, consulte "Ejecutores autohospedados".

  1. En , vaya hasta la página principal de la organización. 1. Debajo del nombre de la organización, haga clic en Settings. Botón de configuración de la organización 1. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores. 1. Haz clic en Nuevo ejecutor. 1. La imagen y arquitectura de tu sistema operativo para tu máquina del ejecutor auto-hospedado.

  2. 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 quiere instalar la aplicación de ejecutor autohospedado como un servicio, tendrá 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.
    • 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 "Self-hosted runners" (Ejecutores autohospedados).

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 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 obtener más detalles, consulte "Supervisión y solución de problemas de ejecutores autohospedados".

Nota: Por razones de seguridad, de manera predeterminada los repositorios públicos no pueden usar ejecutores en un grupo de ejecutores, pero esto se puede invalidar en la configuración del grupo de ejecutores. Para más información, vea "Administración del acceso a ejecutores autohospedados mediante grupos".

Agregar un ejecutor auto-hospedado a una empresa

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

Los nuevos ejecutores se asignan al grupo predeterminado. Puedes modificar el grupo del ejecutor después de que lo hayas registrado. Para más información, vea "Administración del acceso a los ejecutores autohospedados".

Para agregar un ejecutor auto-hospedado a una empresa, debes ser el propietario de la misma. Para obtener más información sobre cómo agregar un ejecutor autohospedado con la API REST, consulte los puntos de conexión empresariales en la API REST de GitHub Actions.

  1. En la esquina superior derecha de GitHub Enterprise Server, haga clic en la foto de perfil y luego en Configuración de empresa. "Configuración de empresa" en el menú desplegable de la foto de perfil de GitHub Enterprise Server 1. En la barra lateral de la empresa, haz clic en Directivas. Pestaña Directivas en la barra lateral de la cuenta de empresa 1. En " Directivas", haz clic en Acciones. 1. Haz clic en la pestaña Ejecutores. 1. Haz clic enNuevo ejecutor. 1. La imagen y arquitectura de tu sistema operativo para tu máquina del ejecutor auto-hospedado.

  2. 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 quiere instalar la aplicación de ejecutor autohospedado como un servicio, tendrá 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.
    • 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 "Self-hosted runners" (Ejecutores autohospedados).

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 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 obtener más detalles, consulte "Supervisión y solución de problemas de ejecutores autohospedados".

Nota: Por razones de seguridad, de manera predeterminada los repositorios públicos no pueden usar ejecutores en un grupo de ejecutores, pero esto se puede invalidar en la configuración del grupo de ejecutores. Para más información, vea "Administración del acceso a ejecutores autohospedados mediante grupos".

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 sobre cómo cambiar la configuración de acceso de un grupo de ejecutores, consulte "Administración del acceso a los ejecutores autohospedados mediante grupos".

Información adicional