👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Agregar ejecutores autoalojados

Puedes agregar un ejecutor auto-hospedado a GitHub Actions.

En este artículo

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

Advertencia: Te recomendamos que no utilices ejecutores auto-hospedados con repositorios públicos.

Las bifurcaciones de tu repositorio público pueden ejecutar código potencialmente peligroso en tu máquina de ejecutor auto-hospedado creando una solicitud de extracción que ejecute el código en un flujo de trabajo.

Para obtener más información, consulta la sección "Acerca de los ejecutores auto-hospedados".

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.

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

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

    Botón de configuración del repositorio

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

    Configuración de acciones

  4. Debajo de "Eejcutores auto-hospedados", da clic en Agregar ejecutor.

  5. Selecciona el sistema operativo y arquitectura de tu máquina de ejecutor auto-hospedado.

    Selecciona el sistema operativo del ejecutor autoalojado

  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 los pasos para agregar un ejecutor autoalojado, el ejecutor y su estado se enumeran ahora en "Self-hosted runners" (Ejecutores autoalojados).

Lista del ejecutor autoalojado

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 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, navega hasta la página principal de la organización.

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

    Botón de configuración de organización

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

    Configuración de acciones

  4. Debajo de "Eejcutores auto-hospedados", da clic en Agregar ejecutor.

  5. Selecciona el sistema operativo y arquitectura de tu máquina de ejecutor auto-hospedado.

    Selecciona el sistema operativo del ejecutor autoalojado

  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 los pasos para agregar un ejecutor autoalojado, el ejecutor y su estado se enumeran ahora en "Self-hosted runners" (Ejecutores autoalojados).

Lista del ejecutor autoalojado

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 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".

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos