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 GitHub Actions para GitHub Enterprise Server

Aprende cómo habilitar y configurar las GitHub Actions en GitHub Enterprise Server por primera vez.

Site administrators can enable GitHub Actions and configure enterprise settings.

Nota: Los ejecutores hospedados en GitHub no son compatibles con GitHub Enterprise Server actualmente. Puedes encontrar más información sobre el soporte que se tiene planeado en el futuro en el Itinerario público de GitHub.

Acerca del GitHub Actions en GitHub Enterprise Server

Este artículo explica cómo los administradores de sitio pueden habilitar GitHub Enterprise Server para utilizar GitHub Actions.

GitHub Actions is not enabled for GitHub Enterprise Server by default. Necesitarás determinar si tu instancia tiene recursos de CPU y memoria adecuados para manejar la carga de GitHub Actions sin causar una pérdida de rendimiento e incrementar esos recursos posiblemente. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts generated by workflow runs. Entonces, habilitarás las GitHub Actions para tu empresa, administrarás los permisos de acceso y agregarás los ejecutores auto-hospedados para ejecutar los flujos de trabajo.

Antes de iniciar, debes hacer un plan de cómo introducirás las GitHub Actions a tu empresa. Para obtener más información, consulta la sección "Introducción a las GitHub Actions para tu empresa".

Si estás migrando tu empresa a las GitHub Actions desde otro proveedor, hay consideraciones adicionales. Para obtener más información, consulta la sección "Migrar tu empresa a GitHub Actions".

Revisar los requisitos de hardware

Los recursos de memoria y CPU que tu instancia de GitHub Enterprise Server tiene disponibles determinan la cantidad de jobs que se pueden ejecutar simultáneamente sin pérdida de rendimiento. GitHub recommends a minimum of 8 vCPU and 64 GB memory to run GitHub Actions.

La cantidad máxima de ejecución simultánea de jobs sin pérdida de rendimiento depende de factores tales como la duración de los jobs, el uso de artefactos, la cantidad de repositorios ejecutando acciones y qué tanto trabajo adicional sin relación a las acciones ejecuta tu instancia. Las pruebas internas en GitHub demostraron los siguientes objetivos de rendimiento para GitHub Enterprise Server en un rango de configuraciones de memoria y CPU:

vCPUMemoriaSimultaneidad máxima
864 GB300 puestos de trabajo
16128 GB700 puestos de trabajo
32160 GB1300 puestos de trabajo
64256 GB2000 puestos de trabajo
96384 GB4000 puestos de trabajo

La simultaneidad máxima se midió utilizando repositorios múltiples, una duración de los jobs de aproximadamente 10 minutos y 10 MB de cargas de artefactos. Puedes experimentar rendimientos diferentes dependiendo de los niveles de actividad generales de tu instancia.

Si planeas habilitar las GitHub Actions para los usuarios de una instancia existente, revisa los niveles de actividad para los usuarios y automatizaciones en la instancia y asegúrate de haber proporcionado memoria y CPU adecuados para tus usuarios. Para obtener más información acerca de cómo monitorear la capacidad y rendimiento de GitHub Enterprise Server, consulta la sección "Monitorear tu aplicativo".

Para obtener más información acerca de los requisitos mínimos de tu instancia de GitHub Enterprise Server, consulta las consideraciones de hardware para la plataforma de tu instancia.

Para obtener más información sobre el ajuste de recursos para una instancia existente, consulta las secciones "Incrementar la capacidad de almacenamiento" e "Incrementar los recursos de memoria o de CPU".

Requisitos de almacenamiento externo

Para habilitar GitHub Actions en GitHub Enterprise Server, debes tener acceso al almacenamiento externo de blobs.

GitHub Actions uses blob storage to store data generated by workflow runs, such as workflow logs and user-uploaded build artifacts. La cantidad de almacenamiento requerida dependerá de tu uso de GitHub Actions. Sólo se admite una sola configuración de almacenamiento externo y no puedes utilizar varios proveedores de almacenamiento al mismo tiempo.

GitHub Actions es compatible con estos proveedores de almacenamiento:

  • Azure Blob storage
  • Amazon S3
  • S3-compatible MinIO Gateway para NAS

Nota: Estos son los únicos proveedores de almacenamiento compatibles con GitHub y sobre los que éste puede proporcionar asistencia. Es muy poco probable que otros proveedores de almacenamiento de S3 compatibles con la API funcionen, debido a las diferencias de la API de S3. Contáctanos para solicitar soporte para proveedores de almacenamiento adicionales.

Advertencia: MinIO anunció la eliminación de MinIO Gateways. Desde el 1 de junio de 2022, tanto el soporte como las correcciones de errores para la implementación de la puerta de enlace de la NAS de MinIO estarán disponibles únicamente para los clientes con suscripciones de pago a través de su contrato de soporte LTS. Si quieres seguir utilizando MinIO Gateways con GitHub Actions, te recomendamos migrarte al soporte LTS de MinIO. Para obtener más información, consulta el programa para eliminar a MinIO Gateway para GCS, Azure, HDFS en el repositorio minio/minio.

Antes de que habilites las GitHub Actions, puedes probar tu configuración de almacenamiento desde el shell administrativo con la utilidad ghe-actions-precheck. Para obtener más información, consulta las secciones "Utilidades de línea de comandos" y "Acceder al shell administrativo (SSH)".

Consideraciones de las conexiones

Si se habilitan las GitHub Actions para tu empresa, solo los proxies HTTP serán compatibles. No son compatibles los proxies SOCK5, HTTPS y Polipo. Para obtener más información sobre cómo utilizar un proxy con GitHub Enterprise Server, consulta la sección "Configurar un servidor proxy saliente".

Habilitar las GitHub Actions con tu proveedor de almacenamiento

Sigue uno de los procedimientos siguientes para habilitar las GitHub Actions con el proveedor de almacenamiento de tu elección:

Administrar los permisos de acceso para GitHub Actions en tu empresa

Puedes utilizar políticas para administrar el acceso a las GitHub Actions. Para obtener más información, consulta la sección "Requerir las políticas de GitHub Actions para tu empresa".

Agrega ejecutores auto-hospedados

Nota: Los ejecutores hospedados en GitHub no son compatibles con GitHub Enterprise Server actualmente. Puedes encontrar más información sobre el soporte que se tiene planeado en el futuro en el Itinerario público de GitHub.

Para ejecutar los flujos de trabajo de GitHub Actions, necesitas agregar ejecutores auto-hospedados. Puedes agregar ejecutores auto-hospedados a nivel de empresa, organización o repositorio. Para obtener más información, consulta "Agregar ejecutores autoalojados."

Administrar qué acciones pueden utilizarse en tu empresa

Puedes controlar las acciones que pueden utilizar tus usuarios en tu empresa. Esto incluye el configurar GitHub Connect para el acceso automático a las acciones de GitHub.com, o sincronizar las acciones de GitHub.com manualmente.

Para obtener más información, consulta la sección "Acerca de utilizar las acciones en tu empresa".

Fortalecimiento de seguridad general para las GitHub Actions

Si quieres aprender más acerca de las prácticas de seguridad para GitHub Actions, consulta la sección "Fortalecimiento de seguridad para las GitHub Actions".

Nombres reservados

Cuando habilitas las GitHub Actions para tu empresa, se crean dos organizaciones: github y actions. Si tu empresa utiliza el nombre de organización github, github-org (o github-github-org si github-org también se está utilizando) se utilizará en su lugar. Si tu empresa ya utiliza el nombre de organización actions, github-actions (or github-actions-org si github-actions también se está utilizando) se utilizará en su lugar. Una vez que se habiliten las acciones, ya no podrás utilizar estos nombres.