Skip to main content
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.

Iniciar con los ejecutores auto-hospedados para tu empresa

Puedes configurar una máquina ejecutora para tu empresa para que tus desarrolladores puedan comenzar a automatizar flujos de trabajo con GitHub Actions.

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

Acerca de los ejecutores auto-hospedados para las GitHub Actions

Las GitHub Actions permiten que los miembros de tu empresa mejoren su productividad al automatizar cada fase del flujo de trabajo de desarrollo de software. Para obtener más información, consulta la sección "Acerca de las GitHub Actions para las empresas".

Con GitHub Actions, los desarrolladores pueden escribir y combinar tareas individuales llamadas acciones para crear flujos de trabajo personalizados. Puedes hospedar tu propia máquina ejecutora para ejecutar jobs y esta máquina se denomina como un ejecutor auto-hospedado. Los ejecutores auto-hospedados pueden ser físicos, virtuales, estar en un contenedor, en las instalaciones o en la 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, consulta "Acerca de los ejecutores autoalojados."

Como alternativa, puedes utilizar las máquinas ejecutoras que hospeda GitHub. Los ejecutores hospedados en GitHub están fuera del alcance de esta guía. Para obtener más información, consulta la sección "Acerca de los ejecutores hospedados en GitHub".

Esta guía te muestra cómo aplicar un enfoque de administración centralizada para los ejecutores auto-hospedados para GitHub Actions en tu empresa. En la guía, completarás las siguientes tareas.

  1. Configurar una política limitada para restringir las acciones y flujos de trabajo reutilizables que pueden ejecutarse dentro de tu empresa
  2. Desplegar un ejecutor auto-hospedado para tu empresa
  3. Crear un grupo para administrar el acceso a los ejecutores disponibles para tu empresa
  4. Opcionalmente, restringir aún más los repositorios que puede utilizar el ejecutor
  5. Opcionalmente, crear herramientas personalizadas para escalar tus ejecutores auto-hospedados automáticamente

También encontrarás información adicional sobre cómo monitorear y asegurar tus ejecutores auto-hospedados, y cómo personalizar el software en tus máquinas ejecutoras.

Después de que termines la guía, los miembros de tu empresa podrán ejecutar jobs de flujo de trabajo desde GitHub Actions en una máquina ejecutora auto-hospedada.

Prerrequisitos

1. Configurar políticas para las GitHub Actions

Primero, habilita las GitHub Actions para todas las organizaciones y configura una política para restringir las acciones y flujos de trabajo reutilizables que pueden ejecutarse dentro de tu empresa en GitHub Enterprise Cloud. Opcionalmente, los propietarios de las organizaciones pueden seguir restringiendo estas políticas para cada una de ellas.

  1. En la esquina superior derecha de GitHub.com, da clic en tu foto de perfil y luego en Tus empresas. "Tus empresas" en el menú desplegable de la foto de perfil en GitHub Enterprise Cloud

  2. En la lista de empresas, da clic en aquella que quieras ver. Nombre de una empresa en la lista de tus empresas

  3. En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas). Pestaña Policies (Políticas) en la barra lateral de la cuenta de empresa

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

  5. Debajo de "Políticas", selecciona Habilitar para todas las organizaciones.

    Captura de pantalla de la política "Habilitar para todas las organizaciones" para GitHub Actions

  6. Selecciona Permite acciones y flujos de trabajo reutilizables de empresa y los selectos diferentes a los de empresa y Permitir las acciones que cree GitHub para permitir las acciones locales y los flujos de trabajo reutilizables y las acciones que cree GitHub.

    Captura de pantalla de "Permitir acciones seleccionadas" y "Permitir acciones creadas por GitHub" para las GitHub Actions

  7. Haz clic en Save (guardar).

Puedes configurar políticas adicionales para restringir las acciones disponibles para los miembros de la empresa. Para obtener más información, consulta la sección "Requerir políticas para las GitHub Actions en tu empresa".

2. Despliega el ejecutor auto-hospedado para tu empresa

A continuación, agrega un ejecutor auto-hospedado a tu empresa. GitHub Enterprise Cloud te guiará durante la instalación del software necesario en la máquina ejecutora. Después de que despliegues el ejecutor, puedes verificar la conectividad entre la máquina ejecutora y tu empresa.

Agregar el ejecutor auto-hospedado

  1. En la esquina superior derecha de GitHub.com, da clic en tu foto de perfil y luego en Tus empresas. "Tus empresas" en el menú desplegable de la foto de perfil en GitHub Enterprise Cloud

  2. En la lista de empresas, da clic en aquella que quieras ver. Nombre de una empresa en la lista de tus empresas

  3. En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas). Pestaña Policies (Políticas) en la barra lateral de la cuenta de empresa

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

  5. Haz clic en la pestaña de Ejecutores.

  6. Haz clic en Ejecutor nuevo.

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

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

La aplicación del ejecutor autoalojado debe estar activa para que el ejecutor acepte trabajos. Cuando se conecta la aplicación del ejecutor a GitHub Enterprise Cloud y está lista para recibir jobs, verás el siguiente mensaje en la terminal de la máquina.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

3. Administra el acceso al ejecutor auto-hospedado utilizando un grupo

Puedes crear un grupo de ejecutores para administrar el acceso al ejecutor que agregaste a tu empresa. Utilizarás el grupo para elegir qué organizaciones pueden ejecutar jobs desde GitHub Actions en el ejecutor.

GitHub Enterprise Cloud agrega a todos los ejecutores nuevos a un grupo. Los ejecutores pueden estar en solo un grupo a la vez. Predeterminadamente, GitHub Enterprise Cloud agrega ejecutores nuevos al grupo "Predeterminado".

  1. En la esquina superior derecha de GitHub.com, da clic en tu foto de perfil y luego en Tus empresas. "Tus empresas" en el menú desplegable de la foto de perfil en GitHub Enterprise Cloud

  2. En la lista de empresas, da clic en aquella que quieras ver. Nombre de una empresa en la lista de tus empresas

  3. En la barra lateral de la cuenta de empresa, haz clic en Policies (Políticas). Pestaña Policies (Políticas) en la barra lateral de la cuenta de empresa

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

  5. Haz clic en la pestaña Grupos de ejecutores.

  6. Haz clic en Grupo de ejecución nuevo.

  7. Debajo de "Nombre de grupo", escribe un nombre para tu grupo de ejecutores.

  8. Para elegir una política para el acceso de la organización, debajo de "Acceso de la organización", selecciona el menú desplegable Acceso de la organización y haz clic en Organizaciones selectas.

  9. A la derecha del menú desplegable con la política de acceso de la organización, haz clic en .

  10. Selecciona las organizaciones a las cuales te gustaría otorgar acceso al grupo de ejecutores.

  11. Opcionalmente, para permitir que los repositorios públicos en las organizaciones seleccionadas utilicen los 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 tu repositorio podría ejecutar código peligroso en tu máquina de ejecutor auto-hospedado potencialmente al crear una solicitud de cambios que excluya el código en un flujo de trabajo.

    Para obtener más información, consulta "Acerca de los ejecutores autoalojados."

  12. Haz clic en Crear grupo para crear el grupo y aplicar la política.

  13. Haz clic en la pestaña de "Ejecutores".

  14. En la lista de ejecutores, haz clic en aquél que hayas desplegado en la sección previa.

  15. Da clic en Editar.

  16. Haz clic en Grupos de ejecutores .

  17. En la lista de grupos de ejecutores, haz clic en el nombre del grupo que hayas creado previamente.

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

Ya desplegaste un ejecutor auto-hospedado que puede ejecutar jobs de GitHub Actions dentro de las organizaciones que especificaste.

4. Restringir aún más el acceso al ejecutor auto-hospedado

Opcionalmente, los propietarios de las organizaciones pueden restringir aún más la política de acceso del grupo de ejecutores que creaste. Por ejemplo, los propietarios de las organizaciones podrían permitir que solo ciertos repositorios de la organización utilicen el grupo de ejecutores.

Para obtener más información, consulta la sección "Administrar el acceso a los ejecutores auto-hospedados".

5. Escalar automáticamente tus ejecutores auto-hospedados

Opcionalmente, puedes crear herramientas personalizadas para escalar automáticamente a los ejecutores auto-hospedados para tu empresa. Por ejemplo, tus herramientas pueden responder a eventos de webhook de GitHub.com para escalar automáticamente un clúster de máquinas ejecutoras. Para obtener más información, consulta la sección "Autoescalar con ejecutores auto-hospedados".

Pasos siguientes

  • Puedes monitorear los ejecutores auto-hospedados y solucionar problemas comunes. Para obtener más información, consulta la sección "Monitorear y solucionar problemas de los ejecutores auto-hospedados".

  • GitHub te recomienda revisar las consideraciones de seguridad para las máquinas ejecutoras auto-hospedadas. Para obtener más información, consulta la sección "Fortalecimiento de seguridad para las 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. Como alternativa, puedes permitir que los miembros de tu empresa accedan automáticamente a las acciones de GitHub.com utilizando GitHub Connect. Para obtener más información, consulta lo siguiente.

  • Puedes personalizar el software disponible en tus máquinas ejecutoras auto-hospedadas o configurar tus ejecutores para que ejecuten software similar a aquellos hospedados en GitHub. El software que impulsa las máquinas ejecutoras para GitHub Actions es de código abierto. Para obtener más información, consulta los repositorios actions/runner y actions/virtual-environments.

Leer más