Ejecutores y recursos de hardware compatibles
Hay disponibles distintas gamas de ejecutores alojados en GitHub para su uso en repositorios públicos y privados.
Para ver listas de los ejecutores disponibles, consulte:
GitHubLos ejecutores de Linux hospedados admiten la aceleración de hardware para las herramientas de Android SDK, lo que hace que la ejecución de pruebas de Android sea mucho más rápida y consume menos minutos. Para más información sobre la aceleración de hardware de Android, consulta Configuración de la aceleración de hardware para Android Emulator en la documentación de desarrolladores de Android.
Nota:
Las imágenes de ejecutor -latest son las imágenes estables más recientes que proporciona GitHub y puede que no sean la versión más reciente del sistema operativo disponible del proveedor del sistema operativo.
Advertencia
Las imágenes beta y en desuso se proporcionan "tal cual", "con todos sus fallos" y "conforme estén disponibles" y están excluidas del acuerdo de nivel de servicio y de la garantía. Es posible que el soporte al cliente no cubra las imágenes beta.
Ejecutores estándar hospedados GitHub para repositorios públicos
En el caso de los repositorios públicos, los trabajos que usan las etiquetas de flujo de trabajo que se muestran en la tabla siguiente se ejecutarán con las especificaciones asociadas. A excepción de los ejecutores de CPU única, cada GitHubejecutor hospedado por }es una nueva máquina virtual hospedada por GitHub. Runners de CPU única se ejecutan en un contenedor en una VM compartida; consulte Referencia de ejecutores hospedados en GitHub. El uso de los ejecutores hospedados estándar GitHubes gratuito y ilimitado en repositorios públicos.
| Máquina virtual o contenedor | Procesador (CPU) | Memoria (RAM) | Almacenamiento (SSD) | Arquitectura | Etiqueta de flujo de trabajo |
|---|---|---|---|---|---|
| Linux | 1 | 5 GB | 14 GB | x64 |
ubuntu-slim
|
| Linux | 4 | 16 GB | 14 GB | x64 |
|
GitHubEjecutores hospedados estándar para privados
En privados, los trabajos que usan las etiquetas de flujo de trabajo que se muestran en la tabla siguiente se ejecutarán en máquinas virtuales con las especificaciones asociadas. Estos ejecutores utilizan la asignación de minutos gratuitos de su GitHub cuenta y, enseguida, se aplica el cobro según las tarifas por minuto. Consulta Precios del ejecutor de acciones.
| Máquina virtual | Procesador (CPU) | Memoria (RAM) | Almacenamiento (SSD) | Arquitectura | Etiqueta de flujo de trabajo |
|---|---|---|---|---|---|
| Linux | 1 | 5 GB | 14 GB | x64 |
ubuntu-slim
|
| Linux | 2 | 8 GB | 14 GB | x64 |
|
Las bitácoras de flujos de trabajo listan el runner utilizado para llevar a cabo una tarea. Para más información, consulta Visualizar el historial de ejecución del flujo de trabajo.
Limitaciones de los ejecutores de macOS arm64
- Todas las acciones proporcionadas por GitHub son compatibles con los ejecutores hospedados en arm64 GitHub. Sin embargo, las acciones de la comunidad pueden no ser compatibles con arm64 y deben instalarse manualmente en runtime.
- No se admite la virtualización anidada debido a la limitación del marco de virtualización de Apple.
- Las funcionalidades de red, como las redes privadas de Azure y la asignación de direcciones IP estáticas, no están disponibles actualmente para los ejecutores de mayor capacidad de macOS.
- Los ejecutores de macOS arm64 no tienen asignado un UUID/UDID estático porque Apple no admite esta característica. Sin embargo, a los ejecutores de MacOS de Intel se les asigna un UDID estático, específicamente
4203018E-580F-C1B5-9525-B745CECA79EB. Si va a compilar e iniciar sesión en el mismo host en el que planea probar la compilación, puede iniciar sesión con un perfil de aprovisionamiento de desarrollo. Si necesita un UDID estático, puede usar ejecutores de Intel y agregar su UDID a su cuenta de desarrollador de Apple.
Ejecutores con una sola CPU
Los ejecutores alojados de una sola CPU GitHubestán disponibles tanto en los repositorios públicos como en los privados. Estos ejecutores, especificados mediante la etiqueta de flujo de trabajo ubuntu-slim, ofrecen una opción de menor costo para ejecutar operaciones ligeras. Este tipo de ejecutor está optimizado para tareas de automatización, gestión de incidencias y trabajos de corta duración. No son adecuados para las típicas compilaciones CI/CD de gran peso.
ubuntu-slim los ejecutores ejecutan flujos de trabajo de acciones en Ubuntu Linux, dentro de un contenedor en lugar de una instancia de máquina virtual completa. Cuando se inicia el trabajo, GitHub aprovisiona automáticamente un nuevo contenedor para ese trabajo. Todos los pasos del trabajo se ejecutan en el contenedor, lo que permite que los pasos de ese trabajo compartan información utilizando el sistema de archivos del ejecutor. Una vez finalizado el trabajo, el contenedor se retira automáticamente. Cada contenedor proporciona aislamiento de nivel 2 del hipervisor.
Nota:
El contenedor para ejecutores ubuntu-slim se ejecuta en el modo sin privilegios. Esto significa que algunas operaciones que requieren privilegios elevados, como el montaje de sistemas de archivos, el uso de Docker en Docker o el acceso a características de kernel de bajo nivel, no se admiten.
Se instala un conjunto mínimo de herramientas en la imagen del ejecutor ubuntu-slim, adecuado para tareas ligeras. Para obtener más información sobre qué software está instalado en la ubuntu-slim imagen, consulte el archivo LÉAME en el actions/runner-images repositorio.
Límites de uso
Los ejecutores de una sola CPU siguen el mismo modelo de concurrencia que otros ejecutores estándar alojados en GitHub. Consulta Límites de acciones. La simultaneidad de los ejecutores viene determinada por el plan.
El tiempo de espera del trabajo para los ejecutores con una sola CPU es de 15 minutos. Si un trabajo alcanza este límite, se terminará y fallará.
Ejecutor más grande
Ejecutor más grande están disponibles para organizaciones y empresas en los planes GitHub Team y GitHub Enterprise Cloud.
Ejecutor más grandeson máquinas virtuales administradas con más recursos que los ejecutores hospedados estándarGitHub. Ofrecen las siguientes características avanzadas:
- Más RAM, CPU y espacio en disco
- Direcciones IP estáticas
- Azure redes privadas
- La posibilidad de agrupar runners
- Escalado automático para admitir flujos de trabajo simultáneos
- runners con GPU
Estos ejecutores más grandes se hospedan en GitHub y tienen preinstalada la aplicación del ejecutor y otras herramientas.
Para más información, consulta Uso de ejecutores más grandes.
Privilegios administrativos
Las máquinas virtuales Linux y macOS se ejecutan sin la contraseña sudo. Cuando necesite ejecutar comandos o instalar herramientas que requieran más privilegios que el usuario actual, puede usar sudo sin tener que introducir una contraseña. Para obtener más información, consulta el Manual de Sudo.
Las máquinas virtuales de Windows están configuradas para ejecutarse como administradores con el control de cuentas de usuario (UAC) inhabilitado. Para obtener más información, consulta Funcionamiento del control de cuentas de usuario en la documentación de Windows.
Direcciones IP
Para obtener una lista de rangos de direcciones IP que GitHub Actions usa para ejecutores alojados en GitHub, puede utilizar la API de REST de GitHub. Para obtener más información, consulta la clave actions en la respuesta del punto de conexión GET /meta. Para más información, consulta Puntos de conexión de la API de REST para metadatos.
Los ejecutores de Windows y de Ubuntu se hospedan en Azure y, subsecuentemente, tienen los mismos rangos de direcciones IP que los centros de datos de Azure. Los ejecutores de macOS están alojados en la propia nube macOS de GitHub.
Dado que hay tantos intervalos de direcciones IP para los runners alojados en GitHub, no recomendamos usarlos como listas de direcciones permitidas para sus recursos internos. En su lugar, se recomienda usar ejecutor más grandes con un intervalo de direcciones IP estáticas o ejecutores autohospedados. Para más información, consulta Uso de ejecutores más grandes o Ejecutores autohospedados.
La lista de GitHub Actions direcciones IP devueltas por la API se actualiza una vez a la semana.
Requisitos de comunicación para agentes de ejecución alojados en GitHub
Un ejecutor alojado en GitHub debe establecer conexiones con extremos propiedad de GitHub para realizar operaciones esenciales de comunicación. Además, el ejecutor puede requerir acceso a redes adicionales que especifiques o utilices en una acción.
Para garantizar una comunicación adecuada de los GitHubrunners hospedados entre las redes de su configuración, asegúrese de que las siguientes comunicaciones estén permitidas.
Nota:
Algunos de los dominios que se enumeran antes se configuran mediante registros CNAME. Es posible que algunos firewalls necesiten agregar reglas de forma recursiva para todos los registros CNAME. Tenga en cuenta que es posible que los registros CNAME cambien en el futuro y que solo los dominios enumerados permanezcan constantes.
Necesarios para operaciones esenciales:
github.com api.github.com *.actions.githubusercontent.com
github.com
api.github.com
*.actions.githubusercontent.com
Necesarios para acciones de descarga:
codeload.github.com
codeload.github.com
Necesarios para cargar o descargar resúmenes de trabajos, registros, artefactos de flujo de trabajo y cachés:
results-receiver.actions.githubusercontent.com *.blob.core.windows.net
results-receiver.actions.githubusercontent.com
*.blob.core.windows.net
Necesario para las actualizaciones de la versión del runner:
objects.githubusercontent.com objects-origin.githubusercontent.com github-releases.githubusercontent.com github-registry-files.githubusercontent.com
objects.githubusercontent.com
objects-origin.githubusercontent.com
github-releases.githubusercontent.com
github-registry-files.githubusercontent.com
Necesarios para recuperar tokens de OIDC:
*.actions.githubusercontent.com
*.actions.githubusercontent.com
Necesario para descargar o publicar paquetes o contenedores en GitHub Paquetes:
*.pkg.github.com pkg-containers.githubusercontent.com ghcr.io
*.pkg.github.com
pkg-containers.githubusercontent.com
ghcr.io
Necesario para Almacenamiento de archivos de gran tamaño de Git
github-cloud.githubusercontent.com github-cloud.s3.amazonaws.com
github-cloud.githubusercontent.com
github-cloud.s3.amazonaws.com
Necesario para trabajos de Dependabot updates
dependabot-actions.githubapp.com
dependabot-actions.githubapp.com
Necesario para la descarga de los archivos de la versión:
release-assets.githubusercontent.com
release-assets.githubusercontent.com
Necesario para la red virtual:
api.snapcraft.io
api.snapcraft.io
Sistemas de archivos
GitHub ejecuta acciones y comandos de shell en directorios específicos de la máquina virtual. Las rutas de archivo en las máquinas virtuales no son estáticas. Use las variables de entorno que proporciona GitHub para construir rutas de archivo para los directorios home, workspace y workflow.
| Directorio | Variable de entorno | Descripción |
|---|---|---|
home | HOME | Contiene datos relacionados con el usuario. Por ejemplo, este directorio podría contener las credenciales de un intento de inicio de sesión. |
workspace | GITHUB_WORKSPACE | Las acciones y los comandos del shell se ejecutan en este directorio. Una acción puede modificar los contenidos de este directorio, al que pueden tener acceso acciones posteriores. |
workflow/ | GITHUB_EVENT_PATH | La carga POST del evento webhook que desencadenó el flujo de trabajo. |
| GitHub vuelve a escribir esto cada vez que se ejecuta una acción para aislar el contenido del archivo entre acciones. |
Para obtener una lista de las variables GitHub de entorno que se crean para cada flujo de trabajo, consulte Almacenamiento de información en variables.
Sistema de archivos del contenedor de Docker
Las acciones que se ejecutan en los contenedores Docker tienen directorios estáticos en la ruta de acceso /github. Sin embargo, te recomendamos encarecidamente que uses las variables de entorno predeterminadas para construir rutas de archivos en contenedores de Docker.
GitHub reserva el prefijo de ruta /github y crea tres directorios para acciones.
/github/home/github/workspace- Nota: El usuario de Docker predeterminado (root) debe ejecutar GitHub Actions. Asegúrese de que Dockerfile no establece la instrucciónUSER; de lo contrario, no podrás acceder aGITHUB_WORKSPACE./github/workflow