¿CI lenta? Cómo reducir el tiempo del pipeline de CI
Última actualización
Un CI lento es un coste para cada pull request. Si su pipeline de CI es lento, los desarrolladores cambian de tarea mientras esperan, los lotes de cambios crecen y los errores llegan a main porque la gente deja de esperar a que todo esté en verde. Esta guía es el punto de partida para reducir el tiempo de CI: cómo medir el tiempo de build de su CI, qué soluciones aportan más antes y dónde encontrar el detalle de cada una.
¿Por qué es lento mi pipeline de CI?
El tiempo de build de un CI/CD es la suma de cuatro partes, y cada una tiene una solución diferente:
- Tiempo en cola: el job espera a un runner. Se soluciona con más capacidad, otro grupo de runners o menos jobs simultáneos.
- Tiempo de preparación: checkout, instalación del toolchain, instalación de dependencias, descarga de imágenes Docker. Se soluciona con caché e imágenes más pequeñas.
- Tiempo de trabajo: compilación, linting, tests. Se soluciona con paralelismo, sharding, builds incrementales y selección de tests.
- Tiempo final: subida de artefactos, combinación de informes, pasos de despliegue, espera de los checks obligatorios.
Antes de cambiar nada, anote esas cuatro cifras para su workflow más lento. En la interfaz de Actions, cada paso muestra su duración; el resumen de la ejecución muestra el tiempo en cola. Muchos equipos descubren que un solo grupo representa más de la mitad del total. Si quiere convertir eso en dinero, la calculadora del coste de un CI lento multiplica el tiempo de espera por el tamaño del equipo y el coste por hora.
Reducir el tiempo de CI: las soluciones por orden de beneficio
1. Deje de ejecutar trabajo que no necesita
Los filtros por ruta, los grupos de concurrency con cancel-in-progress y omitir los cambios que solo afectan a la documentación no cuestan nada y, a menudo, eliminan entre un 20 y un 40 por ciento de las ejecuciones. En un monorepo, compile solo lo que cambió; consulte la guía de CI para monorepos.
concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: true
on:
pull_request:
paths-ignore: ["docs/**", "**.md"]
2. Cachee las dependencias y la salida de build
Restaurar una caché de paquetes es casi siempre más rápido que descargarlos. Use como clave el hash del lockfile. Los fundamentos están en la guía de caché; los límites (10 GB por repositorio, expulsión de entradas, particularidades de pnpm y Docker) están en límites de caché de GitHub Actions. Para builds de contenedores, consulte caché de capas de Docker.
3. Divida la suite de tests
El sharding ejecuta la suite en varios jobs en paralelo. El tiempo de reloj se reduce aproximadamente en proporción al número de shards, mientras que los minutos facturados aumentan ligeramente. La guía de sharding de tests cubre los principales frameworks y el planificador de sharding de tests le ayuda a elegir el número de shards. Consejos específicos por framework:
Para suites basadas en navegador en general, lea el artículo principal sobre tests e2e lentos.
4. Corrija los tests inestables, porque los reintentos son lentitud oculta
Una suite con un 5 por ciento de inestabilidad se relanza con frecuencia. Cada relanzamiento es tiempo de reloj. Consulte cómo encontrar y contener los tests inestables y, para suites de navegador, tests e2e inestables.
5. Use la combinación adecuada de tests
Una suite formada solo por tests end-to-end es lenta por diseño. La guía tests unitarios frente a tests e2e muestra una pirámide de tests que mantiene la retroalimentación por debajo de diez minutos.
6. Use un runner más grande o más rápido
Si el tiempo de trabajo domina y el job está limitado por la CPU, el hardware es una solución legítima. El runner Linux estándar de GitHub tiene 2 vCPU. Las opciones son los runners grandes de GitHub, máquinas autoalojadas y proveedores externos de runners; la guía de runners más rápidos de GitHub Actions los compara con precios públicos fechados, y autoalojado frente a alojado por GitHub cubre las ventajas operativas de cada opción.
¿Va lento GitHub hoy?
A veces. Los retrasos en la cola y el rendimiento degradado son reales y se informan en githubstatus.com. La guía GitHub Actions lento distingue las incidencias de la plataforma de los problemas de su propio workflow.
Conozca los límites y la factura
Los pipelines lentos y los caros suelen compartir causas. Conozca los límites de tiempo y retrasos, el modelo de precios y las formas de reducir la factura de Actions. Si está valorando un cambio de plataforma, alternativas a GitHub Actions explica por qué la mayoría de los equipos se quedan con Actions y cambian de runner, y Blacksmith frente a GitHub Actions ofrece una visión equilibrada de un proveedor concreto. Use el previsor de minutos de CI para ver qué efecto tienen los pipelines más rápidos en su consumo.
Un plan de 30 minutos
- Elija el workflow obligatorio más lento. Registre los tiempos de cola, preparación, trabajo y final de cinco ejecuciones recientes.
- Añada
concurrencyy filtros por ruta. - Añada o corrija la caché de dependencias; confirme la tasa de aciertos en los logs.
- Divida el job de tests en shards. Empiece con 4 shards y ajuste con el planificador.
- Vuelva a medir. Solo entonces pruebe un runner más grande, y mida con sus propios jobs en lugar de con un benchmark del proveedor.
Dónde encaja compiler.dev
compiler.dev ejecuta sus jobs existentes de GitHub Actions en máquinas más rápidas. Fue una mediana de 1.5× más rápido en 18 stacks medidos (15 más rápidos, 2 iguales, 1 más lento) que el runner de 2 cores de GitHub. Linux de 8 vCPU cuesta $0.008 por minuto y macOS M4 Pro cuesta $0.028 por minuto. Si es necesario, recurre automáticamente a sus propios runners, y su modo de comparación mide sus propios jobs, para que decida con sus datos y no con los nuestros. Utilícelo después de las soluciones gratuitas indicadas arriba, no en su lugar.
Preguntas frecuentes
¿Por qué es tan lento mi pipeline de CI?
Normalmente se debe a una de cuatro causas: el tiempo en cola, la configuración de dependencias, la ejecución de las pruebas en sí o los reintentos por pruebas inestables. Mida cada una por ejecución antes de cambiar nada.
¿Cómo reducir el tiempo de CI sin cambiar de runners?
Cancele las ejecuciones reemplazadas, omita las rutas irrelevantes, almacene en caché las dependencias, divida las pruebas en fragmentos y corrija las pruebas inestables. Estas medidas son gratuitas y suelen eliminar un tercio o más del tiempo.
¿Cuál es un buen tiempo de build en CI?
Muchos equipos buscan menos de diez minutos para la comprobación obligatoria de los PR, porque las personas esperan por ella. Las suites más largas deberían ejecutarse en paralelo o trasladar las comprobaciones más lentas a las ejecuciones de merge o nocturnas.
¿Un runner más rápido siempre acelerará el CI?
No. Ayuda en tareas limitadas por la CPU, como las compilaciones y la ejecución de pruebas. Influye poco en el tiempo dedicado a colas, descargas de red o esperas a servicios externos.
Relacionado
- ¿Docker build lento en CI? Encuentre la causa y solúvala¿Builds de Docker lentos en CI? Revise el tamaño del contexto, .dockerignore, el orden de capas, fallos de caché y BuildKit. Corrija primero lo más costoso.
- ¿Sus pruebas de Cypress son lentas? Cómo acelerar Cypress¿Pruebas de Cypress lentas en CI? Cómo acelerar Cypress con cy.session, intercepts y sin esperas fijas, además de pruebas paralelas en GitHub Actions.
- ¿Jest lento? Acelere los tests de Jest: workers y --shard¿Pruebas Jest lentas? Acelérelas con un transform de TypeScript más rápido, el número de workers adecuado y --shard en CI. Encuentre antes las más lentas.
- ¿Playwright lento en CI? Solucione con workers y sharding¿Pruebas de Playwright lentas en CI? Acelérelas con más workers, storageState reutilizado, navegadores en caché y sharding con --shard. Incluye Python.