Skip to main content

Iniciar con GitHub Actions para GitHub Enterprise Server

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

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

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 y las cachés 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 "Presentar GitHub Actions en su 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 la empresa a GitHub Actions."

Revisar los requisitos de hardware

Los recursos de memoria y CPU que your GitHub Enterprise Server instance tiene disponibles determinan la cantidad de ejecutores que se pueden configurar 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 ejecutores 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 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:

vCPUMemoriaNúmero máximo de ejecutores conectados
864 GB740 ejecutores
32160 GB2700 ejecutores
96384 GB7000 ejecutores
128512 GB7000 ejecutores

GitHub ha medido el número máximo de ejecutores conectados mediante el uso de 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.

Notas:

  • A partir de GitHub Enterprise Server 3.6, GitHub documenta ejecutores conectados en lugar de trabajos simultáneos. Los ejecutores conectados representan la mayoría de los ejecutores que se pueden conectar y esperar utilizar. También se debe tener en cuenta que la conexión de más ejecutores de lo que puede esperar usar puede afectar negativamente al rendimiento.

  • A partir de GitHub Enterprise Server 3.5, las pruebas internas de GitHub 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 objetivos de rendimiento de esta versión de GitHub Enterprise Server.

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 "Supervisión del dispositivo".

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

Para más información sobre cómo ajustar los recursos de una instancia existente, vea "Aumento de la capacidad de almacenamiento" y "Aumento de los recursos de CPU o memoria".

Opcionalmente, puedes limitar el consumo de recursos en your GitHub Enterprise Server instance si configuras un límite de velocidad para GitHub Actions. Para obtener más información, consulta "Configuración de límites de velocidad".

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 para almacenar los datos que se generan con las ejecuciones de flujo de trabajo, tales como registros de flujo de trabajo, cachés, y artefactos de compilación cargados por 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 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. Póngase en contacto con nosotros a fin de solicitar soporte técnico para proveedores de almacenamiento adicionales.

Advertencia: MinIO ha anunciado la eliminación de puertas de enlace de MinIO. A partir del 1 de junio de 2022, el soporte técnico y las correcciones de errores para la implementación actual de la puerta de enlace NAS de MinIO solo estarán disponibles para los clientes de pago a través de su contrato de soporte técnico LTS. Si quieres seguir usando puertas de enlace de MinIO con GitHub Actions, se recomienda pasar a la compatibilidad con MinIO LTS. Para obtener más información, consulta Eliminación programada de la puerta de enlace MinIO para GCS, Azure, HDFS en el repositorio de minio/minio.

Antes de habilitar GitHub Actions, puede probar la configuración de almacenamiento desde el shell administrativo con la utilidad ghe-actions-precheck. Para más información, vea "Utilidades de línea de comandos" y "Acceso al shell administrativo (SSH)".

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, vea "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:

Administrar los permisos de acceso para GitHub Actions en tu empresa

Puedes utilizar políticas para administrar el acceso a las GitHub Actions. Para más información, vea "Aplicación de directivas de Acciones de GitHub para la 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 más información, vea "Adición de ejecutores autohospedados".

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 más información, vea "Acerca del uso de acciones en la empresa".

Fortalecimiento de seguridad general para las GitHub Actions

Si quiere más información sobre los procedimientos de seguridad para GitHub Actions, vea "Fortalecimiento de la 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.