
Desarrollo web · CI/CD y Turborepo
Vercel CI promete menos esperas en los monorepos de Next.js. Instalación, configuración de Turborepo, comparación con GitHub Actions, precios, limitaciones y protocolo de benchmark.
En un SaaS con Next.js, un pequeño cambio en un componente puede activar los mismos controles que la renovación de un paquete compartido: instalación de dependencias, lint, TypeScript, pruebas y compilación. Estas comprobaciones son imprescindibles, pero repetirlas innecesariamente acaba ralentizando cada pull request. Vercel CI, lanzado en beta pública el 28 de octubre de 2026, propone ejecutar solo las tareas pertinentes a partir del grafo de Turborepo, con caché remota y recursos ajustables.
La promesa es atractiva: mantener los controles de calidad y evitar al mismo tiempo un segundo sistema de configuración YAML para las tareas sencillas. Pero Vercel CI todavía no sustituye todas las automatizaciones de GitHub Actions. Esta primera versión depende de GitHub, los eventos git push, un repositorio conectado a Vercel e imágenes Linux. A continuación explicamos cómo funciona, incluimos un ejemplo de configuración, una comparación honesta y los aspectos que conviene medir antes de migrar.
Vercel CI lee las tareas declaradas en turbo.json, ejecuta las etiquetadas como "tags": ["ci"] y sus dependencias, restaura los resultados válidos desde Vercel Remote Cache y ejecuta las demás tareas en entornos aislados. El servicio está en beta; las cifras de velocidad publicadas por Vercel proceden de sus propios repositorios.
Vercel presentó Vercel CI en beta pública el 28 de octubre de 2026. A diferencia de su servicio ya existente para alojar previsualizaciones, este producto está pensado para ejecutar los controles de calidad del repositorio: lint, comprobación de tipos, pruebas unitarias, verificaciones y tareas definidas por los equipos.
En sus repositorios internos, Vercel informa de que el tiempo entre git push y el estado «CI passed» es entre dos y seis veces menor que con su solución anterior. Se trata de una medición interna comunicada por el proveedor, realizada en un conjunto de repositorios y con una configuración que no son los de los lectores. No basta para predecir las mejoras en un proyecto concreto de Next.js.
La empresa también indica que ha ejecutado cerca de ocho millones de tareas en sus repositorios y durante la beta privada. Esto informa sobre los usos probados, pero no demuestra ni una mejora universal ni una disponibilidad general: la funcionalidad sigue en beta a 29 de octubre de 2026.
Una vez configurado, las tareas seleccionadas de Turborepo no necesitan un workflow de GitHub Actions dedicado. Para publicar en npm, ejecutar matrices de Windows/macOS, realizar validaciones manuales o automatizaciones que no se activan con un push, puede seguir siendo necesario GitHub Actions u otra solución de CI. Las dos herramientas pueden coexistir.
El núcleo del mecanismo es el grafo de dependencias de Turborepo. Turborepo conoce los paquetes del repositorio, los scripts disponibles y las relaciones entre las tareas. Vercel CI utiliza este grafo para elegir los trabajos pertinentes, en lugar de volver a ejecutar a ciegas una lista de comandos.
ci y sus dependencias.La Remote Cache está activada de forma predeterminada. Aun así, hay que entender qué guarda en caché: resultados de tareas determinados por sus entradas y su entorno, no una garantía de que se pueda omitir cada prueba. Una prueba que use datos externos mutables, una base de datos remota o un reloj debe diseñarse para no producir falsos positivos.
Vercel CI instala las dependencias una vez por ejecución y comparte esa instalación con los entornos de las tareas. Por tanto, la organización influye tanto en el tiempo de preparación como en el de ejecución.
Tomemos un repositorio representativo de un SaaS con un frontend de Next.js, una biblioteca de UI y un paquete de funciones de negocio. Este ejemplo no corresponde a un repositorio que SDX haya sometido previamente a un benchmark: sirve para mostrar una configuración reproducible que se puede adaptar a una aplicación real.
monorepo/
├── apps/
│ └── web/ # aplicación Next.js
│ └── package.json
├── packages/
│ ├── ui/ # componentes compartidos
│ └── core/ # lógica de negocio TypeScript
├── package.json
├── pnpm-workspace.yaml
├── pnpm-lock.yaml
└── turbo.json
Cada paquete incluye los scripts que le corresponden. Por ejemplo, para la aplicación web se puede usar lo siguiente:
{
"name": "web",
"private": true,
"scripts": {
"lint": "eslint .",
"typecheck": "tsc --noEmit",
"test": "vitest run",
"build": "next build"
}
}
Estos scripts presuponen que Next.js, TypeScript, ESLint y Vitest ya están instalados y configurados en el proyecto. Una biblioteca como packages/ui tendrá sus propios scripts y salidas de compilación. Las tareas que se quieran seleccionar deben existir en los paquetes pertinentes.
En el turbo.json raíz, la siguiente configuración indica tres controles y la dependencia de algunos de ellos respecto a las compilaciones de las bibliotecas utilizadas:
{
"$schema": "https://turborepo.com/schema.json",
"tasks": {
"build": {
"dependsOn": ["^build"],
"outputs": ["dist/**", ".next/**", "!.next/cache/**"]
},
"lint": {
"tags": ["ci"]
},
"typecheck": {
"dependsOn": ["^build"],
"tags": ["ci"]
},
"test": {
"dependsOn": ["^build"],
"tags": ["ci"]
}
}
}
dependsOn: ["^build"] significa que las compilaciones necesarias de los paquetes de los que se depende deben terminar antes del control correspondiente. Las etiquetas ci indican qué tareas se deben seleccionar. Por tanto, una compilación utilizada como dependencia puede ejecutarse aunque no tenga la etiqueta ci. Según el proyecto, habrá que ajustar las salidas de compilación, las entradas de las tareas y las variables de entorno para mantener una caché correcta.
Comportamiento esperado a modo de ejemplo: modificar únicamente una página en apps/web no debería obligar a ejecutar las tareas de un paquete sin relación. En cambio, modificar packages/ui puede afectar a las aplicaciones que dependen de él. Modificar el archivo lockfile o la configuración común puede invalidar más resultados. Son situaciones que hay que comprobar en los registros, no promesas absolutas.
Se puede desactivar una selección en un paquete concreto con "tags": ["!ci"]. Atención: esta exclusión no elimina las tareas que sigan siendo necesarias como dependencias de otras tareas. Para personalizar los recursos, Vercel también documenta "ci:cpus:8", con un máximo indicado actualmente de 32 CPU por tarea.
La beta requiere Turborepo 2.11.7 o posterior y Vercel CLI 64.3.1 o posterior. También funciona con un repositorio de un solo paquete: en ese caso, puede ser menos útil añadir Turborepo si los controles ya son muy rápidos.
En un monorepo pnpm que ya disponga de su workspace y sus scripts, comprueba primero lo siguiente:
pnpm add --workspace-root --save-dev turbo@^2.11.7
pnpm exec turbo --version
vercel --version
pnpm exec turbo run lint typecheck test
El último comando permite comprobar el grafo localmente. Presupone que existen los scripts correspondientes; antes de activar CI, corrige cualquier error de lint, tipado o pruebas. Actualiza Vercel CLI si la versión mostrada es anterior a 64.3.1.
Conecta el repositorio de GitHub a al menos un proyecto de Vercel del equipo elegido. Para usar esta beta, un mismo repositorio no debe estar conectado a proyectos pertenecientes a varios equipos de Vercel. La activación de Vercel CI es explícita: no se activa automáticamente por el mero hecho de añadir turbo.json.
vercel ci enable
Vercel documenta este comando, que debe ejecutarse desde un clon local ya vinculado a un proyecto adecuado. También hay que comprobar los permisos necesarios de GitHub/Vercel en la organización.
Incluye en el control de versiones turbo.json, los scripts y el lockfile; después, ejecuta git push. Vercel CI crea la ejecución correspondiente a las tareas seleccionadas. El pull request de GitHub muestra el resultado, que puede utilizarse en una regla de protección de ramas para impedir la fusión si falla el check.
Evita activar inmediatamente dos sistemas que ejecuten las mismas comprobaciones sin motivo. Durante una migración, puede ser útil mantener ambos durante unos cuantos commits para compararlos, pero las comprobaciones duplicadas también consumen recursos.
El panel de Vercel agrupa las ejecuciones de CI del equipo. Vercel también ofrece comandos de CLI para inspeccionar una ejecución y aislar el error de una tarea. En el anuncio se utilizan, entre otros, los siguientes ejemplos con el alias vc:
vc ci ls
vc ci inspect <identificador-ejecucion>
vc ci logs <identificador-ejecucion>
vc ci logs <identificador-ejecucion> --task web#test --level=error
vc ci grep "WARNING"
Los corchetes angulares de este fragmento indican un espacio que hay que sustituir por el identificador de la ejecución. Para un equipo, la ventaja es poder encontrar un error en web#test sin leer todos los registros de un pipeline monolítico. Los resultados también están disponibles mediante Vercel MCP para las herramientas y los agentes compatibles.
Que un error sea más fácil de diagnosticar no significa necesariamente que sea menos frecuente: los tests inestables, las dependencias externas y las condiciones de carrera entre procesos siguen teniendo que corregirse en la aplicación y en su suite de pruebas.
GitHub Actions sigue siendo un motor de automatización de propósito general: puede ejecutar jobs ante distintos eventos y en distintos sistemas, orquestar matrices, publicar paquetes o iniciar workflows manuales. En esta primera beta, Vercel CI optimiza un problema más concreto: la ejecución de las tareas definidas en Turborepo cuando se hacen pushes a GitHub.
| Criterio | Vercel CI (beta) | GitHub Actions |
|---|---|---|
| Declaración de las comprobaciones | Etiquetas en turbo.json |
Workflows YAML, jobs y pasos |
| Selección de tareas del monorepo | Grafo de Turborepo y caché integrados | Hay que configurarla con filtros, Turborepo o acciones dedicadas |
| Activadores | Actualmente, git push en GitHub |
Push, PR, ejecución manual, programada y muchos otros eventos |
| Entornos | Actualmente, imagen base Linux | Linux, Windows, macOS y runners personalizados |
| Caché | Vercel Remote Cache integrada | Actions Cache o Remote Cache de Turborepo, configuradas manualmente |
| Resultados en GitHub | Check en el pull request | Checks y estados del workflow |
| Facturación | Minutos de CPU de Vercel según el plan | Modelo de facturación de GitHub Actions según el plan y los runners |
| Usos no relacionados con las pruebas | Alcance limitado de la beta | Publicación, automatización, matrices y tareas programadas |
Sería incorrecto contraponer un Vercel CI «inteligente» a un GitHub Actions que necesariamente lo vuelve a ejecutar todo. Un GitHub Actions bien diseñado también puede usar Turborepo, Remote Cache, filtros por rutas y jobs en paralelo. Por tanto, hay que comparar con el workflow actual del proyecto, no con un ejemplo deliberadamente ineficiente.
Aquí tienes un sencillo ejemplo de referencia que puedes adaptar (las versiones de las acciones deben seguir la política de fijación de versiones de tu organización):
name: Checks
on: [push, pull_request]
jobs:
checks:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: pnpm/action-setup@v4
with:
version: 10
- uses: actions/setup-node@v4
with:
node-version: 24
cache: pnpm
- run: pnpm install --frozen-lockfile
- run: pnpm exec turbo run lint typecheck test
Esta versión deja que Turborepo gestione parte del trabajo local del job, pero no reproduce automáticamente el modo de ejecución por tareas aisladas de Vercel CI. Para hacer una comparación justa, compara también con tus workflows de GitHub Actions realmente optimizados, no solo con este ejemplo didáctico.
La documentación de precios, actualizada el 28 de octubre de 2026, anuncia para Vercel Pro un precio de 0,0035 $ por minuto de CPU. El precio de Enterprise es personalizado. La disponibilidad de la beta en todos los planes no debe confundirse con recursos ilimitados o gratuitos: la página de precios consultada no indica un precio universal para Hobby.
La facturación no se basa únicamente en la duración mostrada del pipeline. La fórmula documentada es la siguiente:
Minutos de CPU = número de CPU asignadas × duración de la ejecución en minutos; después se aplica el precio unitario del plan. Vercel redondea el tiempo de un entorno al segundo superior, con un mínimo de un segundo.
De forma predeterminada, la fase de preparación de dependencias utiliza 4 CPU y 8 GB de RAM. A continuación, cada tarea utiliza 2 CPU y 4 GB de RAM, salvo que se personalice. Las tareas que se evitan o se restauran desde la caché no consumen minutos de CPU de ejecución de tareas.
Supongamos 2 minutos de preparación con 4 CPU y, después, dos tareas de 90 segundos con 2 CPU cada una. Esto equivale a 8 + 3 + 3 = 14 minutos de CPU, es decir, 0,049 $ con la tarifa Pro documentada, sin contar otros posibles conceptos facturables. Una ejecución real puede variar: tareas adicionales, duraciones variables o cambios en los recursos o las tarifas.
Para decidir si Vercel CI te conviene, ten en cuenta la factura mensual, el volumen de pushes, la tasa de aciertos de la caché, los recursos solicitados y el tiempo de espera de un desarrollador. Un pipeline más corto no cuesta automáticamente menos, sobre todo si se aumentan las CPU para acelerar las comprobaciones.
Los precios pueden cambiar durante la beta: comprueba siempre los detalles del plan y los parámetros de seguimiento del gasto antes de ponerlo en producción.
En este artículo, SDX no presenta ningún benchmark realizado en un repositorio de producción. Para obtener cifras útiles, hay que comparar las dos herramientas en la misma aplicación, con los mismos commits y un conjunto de pruebas equivalente.
El resultado debería incluir las duraciones medianas, los casos más lentos y los costes asociados. Así se podrá saber si la mejora se debe sobre todo a la caché, la planificación, el paralelismo o la instalación de dependencias. También se podrán identificar los casos en los que Vercel CI no supera al pipeline existente.
| Cambio probado | Qué hay que observar | Riesgo de interpretación |
|---|---|---|
Archivo en apps/web |
Ejecución del lint y las pruebas de Web; tareas no relacionadas evitadas | Una configuración compartida puede invalidar más tareas |
Componente en packages/ui |
Tareas del paquete y dependencias de las aplicaciones afectadas | Las dependencias mal declaradas distorsionan el grafo |
| Lockfile raíz | Caché invalidada e instalación potencialmente más larga | No atribuir toda la duración al motor de CI |
Antes de adoptar Vercel CI, conviene comprobar las limitaciones publicadas en el lanzamiento:
git push: no se ha anunciado que sustituya las programaciones, las activaciones manuales ni los eventos especializados de GitHub.La documentación de Vercel ofrece guías para pruebas de extremo a extremo y pruebas de integración que utilizan una base de datos. Requieren más configuración que un simple "tags": ["ci"]: pueden intervenir servicios, contenedores, URLs de despliegue, permisos y certificados de confianza.
Los secretos de CI deben declararse en el espacio previsto por Vercel. Con el modo estricto de Turborepo, una variable de entorno no llega automáticamente a la tarea: también debe figurar en env o passThroughEnv. No incluyas nunca claves en turbo.json ni en vercel.json.
Otra precaución: una tarea con efectos secundarios (escrituras externas, envío de correos, migración de una base de datos compartida) no debe tratarse como una simple prueba guardada en caché. Distingue los controles deterministas de las tareas operativas.
Vercel anuncia que trabaja en una observabilidad más avanzada, ejecución distribuida mediante vc ci antes del push y selección de pruebas más precisa. Estos elementos forman parte de la hoja de ruta; no están todos disponibles en la beta actual.
Varios paquetes, tareas repetitivas, pushes frecuentes y un grafo de Turborepo bien definido: es el entorno en el que la caché y la selección podrían justificar una prueba piloto concreta.
Si dependes de Windows/macOS, publicaciones, validaciones manuales, schedules o un sistema independiente de Vercel, GitHub Actions sigue siendo una solución más completa. Las dos herramientas pueden coexistir.
La decisión razonable no tiene por qué ser «migrar toda la CI». Empieza por un bloque sencillo: lint, comprobación de tipos y pruebas unitarias de un subconjunto del monorepo. Comprueba los checks de GitHub, la estabilidad, los costes y las mejoras medidas. Amplía el uso solo si los resultados lo justifican.
En un proyecto para un cliente, el objetivo sigue siendo entregar correcciones fiables más rápido, no multiplicar las herramientas de infraestructura. Ese equilibrio —mantenibilidad, fiabilidad de los controles, coste y plazo de entrega— es lo que debe guiar la decisión.
Puede encargarse de las comprobaciones de Turborepo vinculadas a los pushes sin un workflow YAML independiente. Sin embargo, la beta no cubre todos los eventos ni todas las plataformas de GitHub Actions. También es posible utilizar una arquitectura híbrida.
No. Se basa en Turborepo y puede utilizarse en un repositorio de un solo paquete o en un monorepo que cuente con los scripts adecuados. Next.js es un caso de uso natural, pero no es un requisito exclusivo.
Como mínimo, Turborepo 2.11.7 y Vercel CLI 64.3.1, un repositorio de GitHub asociado a un proyecto de Vercel y su activación explícita mediante vercel ci enable.
El precio público documentado para Pro es de 0,0035 $ por minuto de CPU; Enterprise ofrece precios personalizados. El consumo incluye la preparación y las tareas que realmente se ejecutan, según los recursos que utilicen.
No. Vercel anuncia mejoras de entre dos y seis veces en sus propios repositorios. El resultado en otro proyecto depende de los scripts, la caché, las dependencias y el pipeline existente. Hay que medirlo.
Sí, Vercel documenta estos casos de uso, aunque la configuración adicional depende del despliegue, los servicios utilizados y los contenedores. La etiqueta ci por sí sola no resuelve todas estas dependencias.
DESARROLLO WEB
Migración de PHP, actualización de CMS o evolución de framework: identifique los puntos de compatibilidad y valide los recorridos esenciales antes de la puesta en línea.
Introduce al menos 2 caracteres para iniciar la búsqueda.