Perfiles
Un perfil es una forma de máquina con nombre, asociada a una cuenta. Lo referencias desde el campo runs-on de un flujo de trabajo y Tuist enruta la tarea a un runner que coincida. Los perfiles centralizan las decisiones de infraestructura (plataforma, tamaño, versión de Ubuntu o de Xcode) en un solo lugar, en vez de dispersas por cada archivo de flujo de trabajo, y te ofrecen una etiqueta estable para apuntar tu CI.
jobs:
build:
runs-on: tuist-macos
La etiqueta es el nombre del perfil con el prefijo tuist-. Un perfil llamado macos se usa como runs-on: tuist-macos; un perfil llamado linux-large se usa como runs-on: tuist-linux-large. La coincidencia no distingue entre mayúsculas y minúsculas.
Perfiles predeterminados#
Cada cuenta habilitada para Runners comienza con dos perfiles para que puedas usar la flota sin configurar nada:
| Profile | Label | Default shape |
|---|---|---|
linux |
tuist-linux |
2 vCPU / 8 GB |
macos |
tuist-macos |
8 vCPU / 24 GB, Xcode 27.2 |
Ambos apuntan a la forma predeterminada de su plataforma. Están protegidos, por lo que no se pueden eliminar y las etiquetas de las que dependen tus flujos de trabajo siempre se resuelven. Aun así puedes cambiar su forma o la versión de Xcode, y crear perfiles adicionales para otros tamaños o versiones de Xcode.
Formas de máquina#
Los runners están disponibles en macOS (Apple Silicon, virtualizados en la flota de Mac) y Linux. Cada perfil fija una forma de máquina, un par (vCPUs, memory), del catálogo siguiente.
Linux#
| vCPUs | Memory |
|---|---|
| 1 | 2 GB |
| 2 | 4 GB |
| 2 | 8 GB (default) |
| 4 | 8 GB |
| 4 | 16 GB |
| 8 | 16 GB |
| 8 | 32 GB |
| 16 | 32 GB |
| 16 | 64 GB |
Los perfiles de Linux también eligen una versión de Ubuntu, igual que los perfiles de macOS eligen una versión de Xcode:
- Ubuntu 24.04 (
ubuntu-24.04), la opción predeterminada para nuevos perfiles. - Ubuntu 22.04 (
ubuntu-22.04), para flujos de trabajo que aún lo necesiten. GitHub ha marcado como obsoleta su imagen alojada 22.04 y la eliminará el 17 de abril de 2027; planifica migrar antes de esa fecha.
Un perfil permanece en la versión que elegiste hasta que la cambies, así que un nuevo valor predeterminado nunca mueve tus tareas a otro sistema operativo por sí solo. Los binarios compilados en 24.04 necesitan su glibc más reciente (2.39) y pueden no ejecutarse en sistemas anteriores, y el Python del sistema rechaza pip install fuera de un entorno virtual (PEP 668). El runner establece ImageOS (ubuntu24 o ubuntu22) como hacen los runners alojados en GitHub, para que las acciones de configuración elijan las compilaciones adecuadas para la versión correcta.
Cada perfil de Linux admite emuladores de Android con aceleración por hardware a través de /dev/kvm. No hace falta un perfil KVM separado.
macOS#
| vCPUs | Memory |
|---|---|
| 8 | 24 GB (default) |
| 16 | 48 GB |
Las formas de macOS más grandes se ejecutan en menos máquinas de la flota, por lo que una tarea que solicite una puede tardar más en arrancar que la misma tarea en una forma más pequeña. Opta por una forma más grande cuando una tarea esté limitada por CPU y mantén la forma predeterminada para todo lo demás. Si no estás seguro, ejecuta la tarea en ambas y compara las duraciones en el panel.
Los perfiles de macOS también fijan una versión de Xcode. La versión selecciona una imagen de runner con ese Xcode preinstalado, de modo que las tareas arrancan con la toolchain ya lista. Versiones admitidas hoy:
27.3-beta27.2(default)27.127.026.626.526.4.126.326.1.126.0.1
El catálogo evoluciona a medida que añadimos hardware y lanzamientos de Xcode. El formulario Nuevo perfil del panel y tuist runner profile catalog siempre muestran las formas, versiones de Xcode y versiones de Ubuntu disponibles actualmente para tu cuenta, así que considéralos la fuente de verdad.
El nombre de un runner de macOS muestra la versión de macOS que ejecuta, la versión de Xcode del perfil y su forma, por ejemplo tuist-macos-26.6-xcode-27.0-8vcpu-24gb-1a2b3c4d5e6f. El nombre aparece en el paso Set up job de la tarea en GitHub y en los detalles de la tarea en el panel de Tuist.
Crear un perfil#
- Abre la sección Runners → Profiles del panel de tu cuenta.
- Elige New profile.
- Asigna un nombre, elige una plataforma y selecciona una forma. Para Linux, elige también una versión de Ubuntu; para macOS, una versión de Xcode.
- Guarda y luego referéncialo desde un flujo de trabajo con
runs-on: tuist-<name>.
También puedes gestionar perfiles desde la línea de comandos. Crear, modificar y eliminar perfiles requiere administración de la cuenta, como en el panel, o un token de cuenta con el ámbito account:runners:write:
tuist runner profile catalog
tuist runner profile create linux-large --platform linux --vcpus 8 --memory-gb 32
tuist runner profile update linux-large --vcpus 16 --memory-gb 32
tuist runner profile delete linux-large --yes
Los agentes pueden hacer lo mismo a través del servidor MCP.
Por ejemplo, un perfil llamado linux-large en la forma de 8 vCPU / 32 GB:
jobs:
integration-tests:
runs-on: tuist-linux-large
O un perfil de macOS llamado xcode-26-4 fijado a Xcode 26.4.1, para que una tarea pueda ejecutarse con una toolchain anterior mientras tu perfil macos predeterminado sigue la última:
jobs:
build-legacy:
runs-on: tuist-xcode-26-4