Introducción a Acciones de GitHub para GitHub Enterprise Server

Acerca de GitHub Actions en GitHub Enterprise Server

En este artículo se explica cómo los administradores del sitio pueden configurar GitHub Enterprise Server para usar GitHub Actions.

GitHub Actions no está habilitado para GitHub Enterprise Server de manera predeterminada. Deberá determinar si la instancia tiene recursos adecuados de CPU y memoria para controlar la carga sin GitHub Actions causar pérdida de rendimiento y, posiblemente, aumentar esos recursos. También necesitarás decidir qué proveedor de almacenamiento usarás para el almacenamiento de blobs que se requiere para almacenar los artefactos y las cachés que generan las ejecuciones de flujo de trabajo. A continuación, habilitará GitHub Actions para su empresa, administrará los permisos de acceso y agregará ejecutores autohospedados para ejecutar flujos de trabajo.

Antes de empezar, debería planificar cómo introducir GitHub Actions en su empresa. Para más información, consulta Presentación de Acciones de GitHub a su empresa.

Si va a migrar su empresa de otro proveedor a GitHub Actions, hay consideraciones adicionales. Para más información, consulta Migración de la empresa a Acciones de GitHub.

Revisar los requisitos de hardware

Los recursos de CPU y memoria disponibles para tu instancia de GitHub Enterprise Server determinan el número de ejecutores que se pueden configurar sin perder rendimiento. GitHub recomienda un mínimo de 8 vCPU y 64 GB de memoria para ejecutar GitHub Actions.

La cantidad máxima de runners conectados sin pérdida de rendimiento depende de factores tales como la duración de los trabajos, el uso de artefactos, la cantidad de repositorios ejecutando Actions y la cantidad de trabajo adicional que realiza tu instancia sin relación con Actions. Las pruebas internas en GitHub mostraron los objetivos de rendimiento para GitHub Enterprise Server en una variedad de configuraciones de CPU y memoria.

vCPUs	Memoria	Número máximo de ejecutores conectados
8	64 GB	740 corredores
32	160 GB	2700 corredores
96	384 GB	7000 corredores

GitHub midió el número máximo de ejecutores conectados mediante múltiples repositorios, una duración de los trabajos de aproximadamente 10 minutos y subidas de artefactos de 10 MB. Puedes experimentar rendimientos diferentes dependiendo de los niveles de actividad generales de tu instancia.

GitHub Enterprise Server A partir de la versión 3.5, GitHublas pruebas internas usan CPU de tercera generación para reflejar mejor una configuración típica del cliente. Este cambio en la CPU representa una pequeña parte de los cambios en los destinos de rendimiento de esta versión de GitHub Enterprise Server.

Si tiene previsto habilitar GitHub Actions para los usuarios de una instancia existente, revise los niveles de actividad de los usuarios y las automatizaciones de la instancia y asegúrese de que ha aprovisionado la CPU y la memoria adecuadas para los usuarios. Para obtener más información sobre la supervisión de la capacidad y el rendimiento de GitHub Enterprise Server, vea Supervisión de la instancia.

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

• AWS
• Azure
• Google Cloud Platform
• Hyper-V
• OpenStack KVM
• VMware (en inglés)

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.

Opcionalmente, puede limitar el consumo tu instancia de GitHub Enterprise Server de recursos mediante la configuración de un límite de velocidad para GitHub Actions. Para más información, consulta Configuración de los límites de frecuencia.

Requisitos de almacenamiento externo

Para habilitar GitHub Actions en GitHub Enterprise Server, debe tener acceso a Blob Storage externo.

GitHub Actions usa el almacenamiento de blobs externo para almacenar los datos generados por las ejecuciones de flujo de trabajo. Los datos almacenados incluyen registros de flujo de trabajo, cachés y artefactos de compilación cargados por el usuario. La cantidad de almacenamiento necesaria depende del 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.

Todos los demás GitHub Actions datos, 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 admite estos proveedores de almacenamiento:

• Almacenamiento de blobs de Azure
• Amazon S3
• Google Cloud Storage
• Clúster de minIO compatible con S3

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 obtener más información sobre el uso de un proxy con GitHub Enterprise Server, vea Configuración de un servidor proxy web de salida.

Activar GitHub Actions con tu proveedor de almacenamiento

Siga uno de los procedimientos que se indican a continuación para habilitar GitHub Actions con el proveedor de almacenamiento elegido:

• Habilitar Acciones de GitHub con Azure Blob storage
• Habilitar Acciones de GitHub con almacenamiento de Amazon S3
• Habilitación de Acciones de GitHub con Google Cloud Storage
• Habilitación de Acciones de GitHub con almacenamiento MinIO

Administración de permisos de acceso para GitHub Actions en su empresa

Puede usar directivas para administrar el acceso a GitHub Actions. Para más información, consulta Aplicación de directivas para Acciones de GitHub en la empresa.

Agrega ejecutores auto-hospedados

Para ejecutar flujos de trabajo GitHub Actions, debe agregar ejecutores autohospedados. Puedes agregar ejecutores auto-hospedados a nivel de empresa, organización o repositorio. Para más información, consulta 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 configurar GitHub Connect para acceder automáticamente a las acciones desde GitHub.com, o sincronizar manualmente las acciones desde GitHub.com.

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

Refuerzo general de la seguridad para GitHub Actions

Si desea obtener más información sobre los procedimientos de seguridad para GitHub Actions, consulte Referencia de uso seguro.

Nombres reservados

Cuando se habilita GitHub Actions para su 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.