# Perfiles {#profiles}

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.

```yaml
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 {#default-profiles}

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 <.localized_link href="/guides/features/runners/profiles#machine-shapes">forma</.localized_link> 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 {#machine-shapes}

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 {#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 <.localized_link href="/guides/features/runners#android-emulators">emuladores de Android con aceleración por hardware</.localized_link> a través de `/dev/kvm`. No hace falta un perfil KVM separado.

### macOS {#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-beta`
- `27.2` (default)
- `27.1`
- `27.0`
- `26.6`
- `26.5`
- `26.4.1`
- `26.3`
- `26.1.1`
- `26.0.1`

> [!NOTE]
> 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 {#creating-a-profile}

1. Abre la sección **Runners → Profiles** del panel de tu cuenta.
2. Elige **New profile**.
3. 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.
4. 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`:

```bash
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 <.localized_link href="/guides/features/agentic-coding/mcp">servidor MCP</.localized_link>.

Por ejemplo, un perfil llamado `linux-large` en la forma de 8 vCPU / 32 GB:

```yaml
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:

```yaml
jobs:
  build-legacy:
    runs-on: tuist-xcode-26-4
```
