Vercel CLI: activa Turbo en un solo despliegue

El 17 de septiembre de 2026, Vercel convirtió Turbo en un gasto que puede decidirse para un solo despliegue, en vez de exigir un compromiso para todo el proyecto. Con Vercel CLI —o con las otras dos vías disponibles— puedes invertir más en una compilación urgente y dejar que el siguiente despliegue vuelva a la máquina habitual del proyecto.

Ya no hace falta cambiar la configuración del proyecto

Una máquina de compilación es el equipo temporal que Vercel asigna al código mientras instala dependencias, compila la aplicación y prepara el despliegue. Turbo es la opción fija de mayor capacidad: 30 vCPUs, 60 GB de memoria y 64 GB de disco.

Antes de este cambio, elegir una máquina de compilación fija implicaba modificar una configuración del equipo o del proyecto. Para una entrega con poco margen, eso era incómodo: había que pagar Turbo también en las compilaciones rutinarias de vista previa, o cambiar la configuración para la urgencia y acordarse de restaurarla después.

La nueva activación puntual asigna Turbo a un solo despliegue. La configuración del proyecto no cambia. Si el proyecto utiliza Basic, Standard o Elastic de forma habitual, el siguiente despliegue vuelve a esa selección normal, salvo que se aplique otra activación puntual.

Esa es la ventaja: el gasto adicional de compilación puede seguir a la urgencia, no a cada commit.

Turbo, Enhanced y Elastic están disponibles en Pro y Enterprise. Los proyectos Hobby siempre usan Basic, así que esta opción no sirve para acelerar Hobby. Tampoco aporta nada a un proyecto que ya ejecuta todos sus despliegues con Turbo.

Cómo activar Turbo una vez con Vercel CLI, GitHub o la API

El método depende de qué inicie el despliegue. Las tres vías activan Turbo únicamente para ese despliegue.

1. 1

   Usa el marcador del commit de GitHub

   Si el despliegue se activa mediante la integración de GitHub de Vercel, incluye el marcador exacto, respetando mayúsculas y minúsculas en el cuerpo del mensaje del commit:

   git commit -m "Test this change with Turbo" \
     -m "#VERCEL_BUILD_MACHINE=TURBO"

   El marcador se aplica únicamente al despliegue generado por ese commit. Por ahora, no funciona con las integraciones de GitLab o Bitbucket de Vercel.

2. 2

   Usa Vercel CLI

   Desde un proyecto vinculado, ejecuta:

   vc deploy --turbo

   Esta vía requiere Vercel CLI 59.20.0 o una versión posterior. Si la opción no se reconoce, lo primero que conviene comprobar es si la CLI está desactualizada.

3. 3

   Configura el campo en la API de despliegues

   Si un servicio interno de lanzamientos crea el despliegue mediante POST /v13/deployments, establece buildMachine como turbo en esa solicitud. El campo es opcional y solo afecta a ese despliegue; no modifica la configuración del proyecto.

Necesitas permiso para actualizar la máquina de compilación del proyecto. También hay un fallo silencioso que conviene conocer: si Turbo no está disponible o la cuenta carece de permisos, Vercel utiliza la máquina habitual del proyecto en lugar de interrumpir el despliegue.

Una vez cuesta poco; por costumbre, sale caro

Vercel cobra actualmente el uso de sus máquinas de compilación a $0.0035 por minuto de CPU. Eso equivale a precios base de $0.007 por minuto de compilación facturado para Basic, $0.014 para Standard cuando se factura, $0.028 para Enhanced y $0.105 para Turbo.

El contador de facturación redondea cada compilación al minuto siguiente antes de multiplicar por el número de vCPUs de la máquina. Por eso, una compilación con Turbo que dura 3 minutos 40 segundos se factura como 4 minutos, es decir, $0.42.

Para decidir entre Basic y Elastic a nivel de proyecto, consulta Reduce los costos de compilación de Vercel con máquinas Basic. La decisión nueva es más concreta: determinar si un único plazo urgente justifica el sobreprecio de Turbo.

Un ejemplo de carga de trabajo, no un benchmark

Supongamos que un equipo realiza 20 despliegues rutinarios y 1 despliegue urgente por semana. Sus propias mediciones muestran que la misma carga tarda 7 minutos 20 segundos con Basic y 3 minutos 40 segundos con Turbo. Esos tiempos son ficticios y solo sirven para hacer el cálculo. Turbo no reducirá a la mitad todas las compilaciones.

La activación puntual para la urgencia añade $0.364 frente a ejecutar ese despliegue con Basic. En este ejemplo, ese sobreprecio permite ahorrar 3 minutos 40 segundos en el lanzamiento que importa.

Mantener los 20 despliegues rutinarios en Basic reduce el total semanal en $7.28 frente a ejecutar los 21 con Turbo. Ese es el nuevo control presupuestario, resumido en una línea. La decisión real exige usar las duraciones propias, porque el estado de la caché, el uso de CPU, la presión de memoria y el redondeo pueden alterar el resultado.

¿A quién le resulta útil este flujo de trabajo?

Un fundador independiente que publica una corrección en producción

Quien gestione un SaaS conectado a GitHub puede añadir el marcador a un solo commit de corrección urgente. La ventaja no consiste en acelerar el proyecto de forma permanente, sino en reducir la espera del lanzamiento ligado a una caída, una promesa a un cliente o una ventana de lanzamiento, para después volver al gasto normal en el siguiente push.

La persona responsable de un lanzamiento en una agencia

Una agencia puede ejecutar vc deploy --turbo para el lanzamiento de un cliente mientras hay personas esperando la revisión. Las vistas previas rutinarias se mantienen en la configuración habitual del proyecto, evitando que el costo de compilación crezca silenciosamente con cada revisión del cliente.

Un ingeniero de plataforma con un circuito de aprobación

Un equipo de plataforma puede añadir buildMachine: "turbo" solo a una ruta aprobada para lanzamientos urgentes dentro de su servicio de despliegue. Así, la capacidad adicional se convierte en una decisión explícita que puede registrarse, revisarse y presupuestarse, en lugar de quedar como opción predeterminada permanente del proyecto.

Los límites, sin rodeos

Tener treinta vCPUs no significa que una compilación vaya a ejecutarse 15 veces más rápido que con las 2 vCPUs de Basic. Algunas compilaciones no pueden mantener ocupados todos esos núcleos. Vercel señala que muchos proyectos no aprovechan una máquina Turbo por completo; esa es también la razón por la que Elastic puede elegir una máquina más pequeña para el trabajo rutinario.

Turbo cambia la máquina, no la política de la cola. Si la mayor parte de la demora ocurre esperando un turno de compilación, una máquina más grande podría resolver el problema equivocado. Antes de pagar por más CPU, compara el tiempo en cola con el tiempo efectivo de compilación.

El estado de la caché también puede invalidar la comparación. Enfrentar una compilación normal con caché caliente a una compilación Turbo con caché fría no revela qué cambió realmente la máquina. Usa revisiones y condiciones de caché similares, y compara tanto los minutos facturados como el tiempo total transcurrido.

Haz una prueba controlada

1. 1

   Registra el despliegue habitual

   Abre Build Diagnostics y anota la máquina habitual del proyecto, la duración de la compilación, el tiempo en cola, los minutos facturados y el resultado. Elige un despliegue similar a la carga urgente que quieres evaluar.

2. 2

   Activa Turbo en un despliegue

   Utiliza el marcador de GitHub, la opción de la CLI o el campo de la API en un despliegue comparable. No cambies la configuración de la máquina de compilación del equipo ni del proyecto.

3. 3

   Calcula el precio del ahorro observado

   Multiplica los minutos de compilación con Turbo, redondeados hacia arriba, por $0.105. Compara ese cargo con el uso facturado del despliegue habitual y después divide los dólares adicionales entre los minutos realmente ahorrados.

4. 4

   Comprueba el despliegue siguiente

   Inicia otro despliegue normal sin el marcador, la opción ni el campo de la API. Confirma que utiliza la máquina habitual del proyecto. Así detectarás un cambio accidental en la configuración y demostrarás que la selección puntual fue temporal.

Qué conviene hacer ahora

• Actúa esta semana si utilizas un proyecto Pro o Enterprise con lanzamientos urgentes ocasionales y quieres conservar la máquina configurada normalmente.
• Mide primero si el proyecto usa Elastic. Quizá ya asigne suficiente CPU y memoria, por lo que forzar Turbo podría aumentar la factura sin reducir mucho el tiempo.
• Cambia la configuración del proyecto si la mayoría de los despliegues necesita Turbo. Repetir una excepción en cada commit es una política disfrazada de opción.
• Ignora esta función si estás en Hobby, ya utilizas Turbo de forma predeterminada o la demora proviene principalmente de la cola.

La tarea del lunes

Elige un despliegue representativo el lunes. Registra la compilación habitual, activa Turbo de forma puntual, calcula el sobreprecio frente al tiempo realmente ahorrado y, por último, envía un despliegue normal para confirmar que el proyecto volvió a su configuración habitual.

Suscríbete al boletín para recibir explicaciones claras sobre los cambios de plataforma que afectan al presupuesto o al flujo de trabajo.