Introducción a los ejecutores autohospedados para la empresa

Acerca de los ejecutores autohospedados para GitHub Actions

GitHub Actions permite a los miembros de la empresa mejorar la productividad mediante la automatización de todas las fases del flujo de trabajo de desarrollo de software. Para obtener más información, consulte "Acerca de las GitHub Actions para las empresas".

Con GitHub Actions, los desarrolladores pueden escribir y combinar tareas individuales, denominadas acciones, para crear flujos de trabajo personalizados. Puedes hospedar tu propio equipo ejecutor para ejecutar trabajos y 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 Cloud utilizando la aplicación para ejecutores auto-hospedados de GitHub Actions. Todos los ejecutores pueden ejecutar Linux, Windows o macOS. Para obtener más información, vea «Acerca de los ejecutores autohospedados».

También puedes usar máquinas ejecutoras que hospeda GitHub. En esta guía, no se abordan los ejecutores que hospeda GitHub. Para obtener más información, vea «Acerca de los ejecutores hospedados en GitHub».

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.

Configurar una directiva limitada para restringir las acciones y los flujos de trabajo reutilizables que se pueden ejecutar en tu empresa
Implementar un ejecutor autohospedado para la empresa
Crear un grupo para administrar el acceso a los ejecutores que están disponibles para la empresa
De manera opcional, restringir aún más los repositorios que pueden utilizar el ejecutor
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, y cómo personalizar el software en las máquinas ejecutoras.

Cuando finalices la guía, los miembros de la empresa podrán ejecutar trabajos de flujo de trabajo desde GitHub Actions en un equipo ejecutor autohospedado.

Requisitos previos

Debe tener acceso a la máquina que usará como ejecutor autohospedado en su entorno.
Para más información, consulta "Acerca de los ejecutores autohospedados".
La empresa debe ser propietaria de al menos una organización. Para obtener más información, vea «Acerca de las organizaciones» y «Crear una organización nueva desde cero».

1. Configura directivas para GitHub Actions

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

En la esquina superior derecha de GitHub.com, haga clic en la imagen de perfil y después en Your enterprises.
En la lista de empresas, da clic en aquella que quieras ver.
En la barra lateral de la cuenta de empresa, haz clic en Directivas. 1. En " Directivas", haz clic en Acciones.
En "Directivas", selecciona Habilitar para todas las organizaciones.
Para permitir las acciones locales y los flujos de trabajo reutilizables, , además de las acciones que crea GitHub, selecciona Permitir la empresa y seleccionar acciones no empresariales y flujos de trabajo reutilizables y, a continuación, selecciona Permitir acciones creadas por GitHub .
Haga clic en Save(Guardar).

Puedes configurar directivas adicionales para restringir las acciones disponibles para miembros de la empresa. Para obtener más información, vea «Requerir políticas para las GitHub Actions en tu empresa».

2. Implementa el ejecutor autohospedado para tu empresa

A continuación, agrega un ejecutor autohospedado a la empresa. GitHub Enterprise Cloud 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 la empresa.

Incorporación de un ejecutor autohospedado

En la esquina superior derecha de GitHub.com, haga clic en la imagen de perfil y después en Your enterprises.
En la lista de empresas, da clic en aquella que quieras ver.
En la barra lateral de la cuenta de empresa, haz clic en Directivas. 1. En " Directivas", haz clic en Acciones. 1. Haz clic en la pestaña Ejecutores. 1. Haz clic en Nuevo ejecutor y, a continuación, en Nuevo ejecutor autohospedado. 1. 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 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.
  - En Windows, el script config también le pregunta si quiere instalar la aplicación de ejecutor autohospedado 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, vea «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 autohospedado, este ejecutor y su estado ahora se muestran en "Runners" (Ejecutores).

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 Cloud 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 Cloud agrega todos los ejecutores nuevos a un grupo. Los ejecutores solo pueden estar en un grupo a la vez. De manera predeterminada, GitHub Enterprise Cloud agrega ejecutores nuevos al grupo "Predeterminado".

En la esquina superior derecha de GitHub.com, haga clic en la imagen de perfil y después en Your enterprises.
En la lista de empresas, da clic en aquella que quieras ver.
En la barra lateral de la cuenta de empresa, haz clic en Directivas. 1. En " Directivas", haz clic en Acciones. 1. Haga clic en la pestaña Runner groups.
Haga clic en New runner group.
En "Group name", escriba un nombre para el grupo de ejecutores.
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.
A la derecha del menú desplegable con la directiva de acceso de la organización, haz clic en .
Selecciona las organizaciones a las que deseas conceder acceso al grupo de ejecutores.
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 obtener más información, vea «Acerca de los ejecutores autohospedados».

1. Haz clic en **Crear grupo** para crear el grupo y aplicar la política.
Haz clic en la pestaña "Ejecutores".
En la lista de ejecutores, haz clic en el ejecutor que implementaste en la sección anterior.
Haga clic en Editar.
Haz clic en Grupos de ejecutores .
En la lista de grupos de ejecutores, haz clic en el nombre del grupo que creaste anteriormente.
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 obtener más información, vea «Administración del acceso a los 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 la empresa. Por ejemplo, las herramientas pueden responder a eventos de webhook de GitHub.com para escalar automáticamente un clúster de equipos ejecutores. Para obtener más información, vea «Autoescalar con ejecutores auto-hospedados».

Pasos siguientes

Puedes supervisar ejecutores autohospedados y solucionar problemas comunes. Para obtener más información, vea «Supervisión y solución de problemas de ejecutores autohospedados».
GitHub te recomienda revisar las consideraciones de seguridad para las máquinas ejecutoras autohospedadas. Para obtener más información, vea «Fortalecimiento de seguridad para GitHub Actions».
Si utilizas GitHub Enterprise Server o GitHub AE, puedes sincronizar manualmente los repositorios de GitHub.com que contengan acciones hacia tu empresa en GitHub Enterprise Server o GitHub AE. De manera alternativa, puedes permitir que los miembros de la empresa accedan automáticamente a acciones de GitHub.com mediante GitHub Connect. Para obtener más información, vea lo siguiente.
- "Sincronización manual de acciones de GitHub.com" en la documentación de GitHub Enterprise Server o de GitHub AE
- "Habilitación del acceso automático a acciones de GitHub.com mediante GitHub Connect" en la documentación de GitHub Enterprise Server o de GitHub AE
Puedes personalizar el software disponible en las máquinas ejecutoras autohospedadas, o bien configurar los ejecutores para que ejecuten software similar a los ejecutores que hospeda GitHub. El software que impulsa las máquinas ejecutoras para GitHub Actions es de código abierto. Para más información, consulta los repositorios actions/runner y actions/runner-images.