Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.
Acerca de 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 no está habilitado para GitHub Enterprise Server de manera predeterminada. 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. También tendrás que decidir qué proveedor de almacenamiento usarás para el almacenamiento de blobs que se requiere para almacenar los artefactos que las ejecuciones de flujo de trabajo generan. 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, vea «Intruducir las GitHub Actions a tu empresa».
Si estás migrando tu empresa a las GitHub Actions desde otro proveedor, hay consideraciones adicionales. Para obtener más información, vea «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 trabajos que se pueden ejecutar simultáneamente sin pérdida de rendimiento. GitHub recomienda un mínimo de 8 vCPU y 64 GB de memoria para ejecutar 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:
| vCPU | Memoria | Simultaneidad máxima |
|---|---|---|
| 8 | 64 GB | 300 trabajos |
| 16 | 128 GB | 700 trabajos |
| 32 | 160 GB | 1500 trabajos |
| 64 | 256 GB | 2500 trabajos |
| 96 | 384 GB | 4500 trabajos |
| 128 | 550 GB | 5000 trabajos |
La simultaneidad máxima se ha medido utilizando varios repositorios, una duración de trabajo 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 más información sobre la supervisión de la capacidad y el rendimiento de GitHub Enterprise Server, vea "Monitorear tu aplicativo".
Para obtener más información sobre los requisitos mínimos de tu instancia de GitHub Enterprise Server, consulta las consideraciones de hardware relativas a la plataforma de tu instancia.
Para más información sobre cómo ajustar recursos para una instancia existente, consulta "Aumentar la capacidad de almacenamiento" y "Aumentar el CPU o los recursos de memoria".
Requisitos de almacenamiento externo
Para habilitar GitHub Actions en GitHub Enterprise Server, debes tener acceso al almacenamiento externo de blobs.
GitHub Actions usa el almacenamiento de blobs externo para almacenar los datos que se generan con las ejecuciones de flujo de trabajo, como registros de flujo de trabajo y artefactos de compilación cargados por el usuario. La cantidad de almacenamiento requerida dependerá de tu utilización 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.
Todos los demás datos de GitHub Actions, como los archivos de flujo de trabajo de la estructura de archivos de un repositorio, se almacenan en el volumen de almacenamiento de datos para tu instancia de GitHub Enterprise Server.
GitHub Actions es compatible con estos proveedores de almacenamiento:
- Azure Blob Storage
- Amazon S3
- Clúster de minIO compatible con S3
Nota: Estos son los únicos proveedores de almacenamiento compatibles con GitHub y sobre los que puede proporcionar asistencia.
Hay otros productos de almacenamiento compatibles con la API de S3 que los partners de GitHub han autovalidado como compatibles con GitHub Actions en GitHub Enterprise Server. Para obtener más información, consulta el repositorio de partners de almacenamiento de GHES.
En el caso de los productos de almacenamiento validados a través del programa de asociación tecnológica GitHub, el proveedor de almacenamiento es responsable del soporte técnico y la documentación para usar el producto de almacenamiento con GitHub Actions.
Consideraciones sobre redes
Si se habilitan las GitHub Actions para tu empresa, solo los proxies HTTP serán compatibles. No se admiten los servidores proxy SOCKS5 y HTTPS. Para más información sobre el uso de un proxy con GitHub Enterprise Server, consulta "Configuración de un servidor proxy web de salida".
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:
- Habilitación de Acciones de GitHub con Azure Blob Storage
- Habilitar Acciones de GitHub con almacenamiento de Amazon S3
- Habilitación de acciones de GitHub mediante el almacenamiento de MinIO
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, vea «Requerir políticas para las GitHub Actions en tu empresa».
Agrega ejecutores auto-hospedados
Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.
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, vea «Agrega ejecutores auto-hospedados».
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, vea «Acerca de utilizar las acciones en tu empresa».
Fortalecimiento de seguridad general para las GitHub Actions
Si quieres más información sobre los procedimientos de seguridad para GitHub Actions, consulta "Fortalecimiento de seguridad para GitHub Actions".
Nombres reservados
Al habilitar GitHub Actions para la empresa, se crean dos organizaciones: github y actions. Si en la empresa ya se usa el nombre de organización github, en su lugar se usará github-org (o github-github-org si github-org también está en uso). Si en la empresa ya se usa el nombre de organización actions, en su lugar se usará github-actions (o github-actions-org si github-actions también está en uso). Una vez que se habiliten las acciones, ya no podrás utilizar estos nombres.