Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Introducción a los ejecutores autohospedados para la empresa

Puedes configurar una máquina ejecutora para la empresa de modo que los desarrolladores puedan empezar a automatizar los flujos de trabajo con GitHub Actions.

Who can use this feature

Enterprise owners can configure policies for GitHub Actions and add self-hosted runners to the enterprise.

Acerca de los ejecutores autohospedados para GitHub Actions

GitHub Actions permite los usuarios que usen your GitHub Enterprise Server instance mejorar la productividad mediante la automatización de todas las fases del flujo de trabajo de desarrollo de software. Si deseas más información, consulta "Acerca de GitHub Actions para empresas."

Con GitHub Actions, los desarrolladores pueden escribir y combinar tareas individuales, denominadas acciones, para crear flujos de trabajo personalizados. Para habilitar GitHub Actions para your GitHub Enterprise Server instance, debes hospedar por lo menos un equipo para ejecutar trabajos. Este equipo se denomina como un ejecutor auto-hospedado. Los ejecutores autohospedados pueden ser físicos, virtuales, en un contenedor, locales o en una nube. La máquina de tu ejecutor se conecta aGitHub Enterprise Server utilizando la aplicación para ejecutores auto-hospedados de GitHub Actions. autohospedados pueden ejecutar Linux, Windows o macOS. Para más información, consulte Seguridad del ejecutor autohospedado con repositorios públicos.

En esta guía, se muestra cómo puedes aplicar un enfoque de administración centralizada a los ejecutores autohospedados para GitHub Actions en tu empresa. En la guía, completarás las tareas siguientes.

  1. Configurar una directiva limitada para restringir las acciones que se pueden ejecutar en tu empresa
  2. Implementar un ejecutor autohospedado para la empresa
  3. Crear un grupo para administrar el acceso a los ejecutores que están disponibles para la empresa
  4. De manera opcional, restringir aún más los repositorios que pueden utilizar el ejecutor
  5. De manera opcional, crear herramientas personalizadas para escalar automáticamente los ejecutores autohospedados

También encontrarás información adicional sobre cómo supervisar y proteger los ejecutores autohospedados, cómo acceder a las acciones desde GitHub.com y cómo personalizar el software en las máquinas ejecutoras.

Cuando finalices la guía, los usuarios de your GitHub Enterprise Server instance podrán ejecutar trabajos de flujo de trabajo desde GitHub Actions en un equipo ejecutor autohospedado.

Requisitos previos

1. Configura directivas para GitHub Actions

En primer lugar, habilita GitHub Actions para todas las organizaciones y configura una directiva para restringir las acciones que se pueden ejecutar en your GitHub Enterprise Server instance. De manera opcional, los propietarios de las organizaciones pueden restringir aún más estas directivas para cada organización.

  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.

  2. En "Directivas", selecciona Habilitar para todas las organizaciones.

    Captura de pantalla de la directiva "Habilitar para todas las organizaciones" para GitHub Actions

  3. Selecciona Permitir seleccionar acciones y Permitir las acciones que crea GitHub para permitir las acciones locales, además de las acciones que crea GitHub.

    Captura de pantalla de "Permitir las acciones seleccionadas" y "Permitir las acciones que crea GitHub" para GitHub Actions

  4. Haga clic en Save(Guardar).

Puedes configurar directivas adicionales para restringir las acciones disponibles para usuarios de your GitHub Enterprise Server instance. Para más información, vea "Aplicación de directivas para GitHub Actions en la empresa".

2. Implementa el ejecutor autohospedado para tu empresa

A continuación, agrega un ejecutor autohospedado a la empresa. GitHub Enterprise Server te guiará a través de la instalación del software necesario en la máquina ejecutora. Después de implementar el ejecutor, puedes comprobar la conectividad entre el equipo ejecutor y your GitHub Enterprise Server instance.

Incorporación de un ejecutor autohospedado

  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

3. Administra el acceso al ejecutor autohospedado mediante un grupo

Puedes crear un grupo de ejecutores para administrar el acceso al ejecutor que agregaste a la empresa. Usarás el grupo para elegir las organizaciones que pueden ejecutar trabajos desde GitHub Actions en el ejecutor.

GitHub Enterprise Server agrega todos los ejecutores nuevos a un grupo. Los ejecutores solo pueden estar en un grupo a la vez. De manera predeterminada, GitHub Enterprise Server agrega ejecutores nuevos al grupo "Predeterminado".

  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. Haga clic en la pestaña Runner groups.

  2. Haga clic en New runner group.

  3. En "Group name", escriba un nombre para el grupo de ejecutores.

  4. Si deseas elegir una directiva para el acceso de la organización, en "Acceso de organización", selecciona el menú desplegable Acceso de organización y haz clic en Organizaciones seleccionadas.

  5. A la derecha del menú desplegable con la directiva de acceso de organización, haz clic en .

  6. Selecciona las organizaciones a las que deseas conceder acceso al grupo de ejecutores.

  7. De manera opcional, para permitir repositorios públicos en las organizaciones seleccionadas para usar ejecutores en el grupo, selecciona Permitir repositorios públicos.

    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.

    1. Haz clic en **Crear grupo** para crear el grupo y aplicar la directiva.
  8. Haz clic en la pestaña "Ejecutores".

  9. En la lista de ejecutores, haz clic en el ejecutor que implementaste en la sección anterior.

  10. Haga clic en Editar.

  11. Haz clic en Grupos de ejecutores .

  12. En la lista de grupos de ejecutores, haz clic en el nombre del grupo que creaste anteriormente.

  13. Haz clic en Guardar para mover el ejecutor al grupo.

Implementaste un ejecutor autohospedado que puede ejecutar trabajos desde GitHub Actions en las organizaciones que especificaste.

4. Restringe aún más el acceso al ejecutor autohospedado

De manera opcional, los propietarios de las organizaciones pueden restringir aún más la directiva de acceso del grupo de ejecutores que creaste. Por ejemplo, el propietario de una organización podría permitir que solo ciertos repositorios de la organización utilicen el grupo de ejecutores.

Para más información, vea "Administración del acceso a ejecutores autohospedados mediante grupos".

5. Escala automáticamente los ejecutores autohospedados

De manera opcional, puedes crear herramientas personalizadas para escalar automáticamente los ejecutores autohospedados para your GitHub Enterprise Server instance. Por ejemplo, las herramientas pueden responder a eventos de webhook de your GitHub Enterprise Server instance para escalar automáticamente un clúster de equipos ejecutores. Para obtener más información, consulte "Escalado automático con ejecutores autohospedados".

Pasos siguientes

Información adicional