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 available in GitHub Enterprise Server 3.0 or higher. If you're using an earlier version of GitHub Enterprise Server, you'll have to upgrade to use GitHub Actions. Para obtener más información sobre cómo mejorar tu instancia de GitHub Enterprise Server, consulta la sección "Acerca de las mejoras a los lanzamientos nuevos".
GitHub Actions is not enabled for GitHub Enterprise Server by default. You'll need to determine whether your instance has adequate CPU and memory resources to handle the load from GitHub Actions without causing performance loss, and possibly increase those resources. You'll also need to decide which storage provider you'll use for the blob storage required to store artifacts generated by workflow runs. Then, you'll enable GitHub Actions for your enterprise, manage access permissions, and add self-hosted runners to run workflows.
Before you get started, you should make a plan for how you'll introduce GitHub Actions to your enterprise. Para obtener más información, consulta la sección "Introducción a las GitHub Actions para tu empresa".
If you're migrating your enterprise to GitHub Actions from another provider, there are additional considerations. Para obtener más información, consulta la sección "Migrar tu empresa a GitHub Actions".
Review hardware requirements
Nota:Si estás actualizando una instancia existente de GitHub Enterprise Server hacia la versión 3.0 o superior y quieres configurar las GitHub Actions, nota que los requisitos mínimos de hardware han aumentado. Para obtener más información, consulta "Actualizar GitHub Enterprise Server."
Los recursos de CPU y de memoria que están disponibles para tu instancia de GitHub Enterprise Server determinan el rendimiento máximo de jobs para GitHub Actions. GitHub recommends a minimum of 8 vCPU and 64 GB memory to run GitHub Actions.
Las pruebas internas de GitHub demostraron el siguiente rendimiento máximo para las instancias de GitHub Enterprise Server con un rango de CPU y configuraciones de memoria. Puede que vas rendimientos diferentes dependiendo de los niveles generales de actividad en tu instancia.
| vCPU | Memoria | Rendimiento máximo del job |
|---|---|---|
| 4 | 32 GB | Demo o pruebas leves |
| 8 | 64 GB | 25 puestos de trabajo |
| 16 | 160 GB | 35 puestos de trabajo |
| 32 | 256 GB | 100 puestos de trabajo |
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 utiliza el almacenamiento de blobs para almacenar artefactos que se generan con las ejecuciones de flujo de trabajo, tales como las bitácoras de flujo de trabajo y los artefactos de compilaciones que sube el usuario. 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.
Before you enable GitHub Actions, you can test your storage configuration from the administrative shell with the ghe-actions-precheck utility. 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:
- Habilitar las GitHub Actions con el almacenamiento de Azure Blob
- Habilitar las GitHub Actions con el almacenamiento de Amazon S3
- Habilitar las GitHub Actions con la puerta de enlace de MinIO para el almacenamiento en NAS
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.