¿Qué es una caché remota de compilación?
Última actualización
Una caché de compilación remota es un almacén compartido de resultados de compilación y pruebas, indexado por un hash de las entradas de cada tarea. Cuando cualquier máquina, en CI o en el portátil de un desarrollador, necesita la misma tarea con las mismas entradas, descarga el resultado guardado en lugar de volver a ejecutar la tarea.
Cómo funciona
Herramientas de compilación como Nx, Turborepo, Gradle y Bazel dividen el trabajo en tareas (compilar, analizar con lint, probar, empaquetar). Para cada tarea, la herramienta calcula un hash a partir de los archivos fuente, las dependencias, las variables de entorno y el comando. Antes de ejecutarla, consulta la caché con ese hash. Si hay coincidencia, restaura los archivos de salida y reproduce los registros. Si no la hay, ejecuta la tarea y sube el resultado.
Esto es más granular que una caché de dependencias. Una entrada de actions/cache restaura una carpeta completa para todo el job. Una caché remota omite tareas individuales, de modo que un cambio en un paquete de un monorepo solo recompila ese paquete y sus dependientes.
Como el hash abarca todas las entradas, la corrección depende de declararlas bien. Una tarea que lee un archivo no declarado puede devolver una salida obsoleta.
Ejemplo
Turborepo con una caché remota, usando variables de entorno para las credenciales:
jobs:
build:
runs-on: ubuntu-latest
env:
TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
TURBO_TEAM: ${{ vars.TURBO_TEAM }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npx turbo run build test lint
Nx funciona de la misma manera con su propia configuración de caché. Consulte la guía de CI para monorepos con Nx y Turborepo. compiler.dev es compatible con las cachés remotas de Nx y Turborepo, junto con las cachés locales de dependencias, git y capas de Docker; encontrará los detalles en precios.
Caché remota frente a caché local
- La caché local reside en el disco de una sola máquina. Es gratuita, pero cada runner de CI nuevo empieza vacío.
- La caché remota se comparte entre runners y personas, y por eso resulta útil en CI efímero.
Errores comunes
- Entradas no declaradas. Las variables de entorno o los archivos que afectan a la salida pero no están en el hash provocan aciertos de caché incorrectos.
- Salidas no deterministas. Las marcas de tiempo o los identificadores aleatorios en la salida de compilación hacen que cada ejecución parezca distinta.
- Cachear pruebas que acceden a la red. Un resultado correcto en caché oculta una dependencia que falla.
- Escribir desde pull requests de forks. El envenenamiento de caché es un riesgo real. Conceda acceso de solo lectura al código no confiable.
- Usarla como sustituto de la caché de dependencias. Aun así, necesita instalar las dependencias rápidamente. Consulte caché en GitHub Actions.
Términos relacionados
Preguntas frecuentes
¿Es segura una caché de compilación remota?
Trátela como un destino de despliegue. Limite el acceso de escritura a las ramas de confianza y guarde los tokens en secrets.
¿Funciona con compilaciones de Docker?
Docker tiene su propia caché de capas. Consulte caché de capas de Docker en CI.
¿Cuánto ahorra?
Depende de con qué frecuencia las tareas no cambian entre ejecuciones. Los monorepos con cambios pequeños son los que más se benefician.
Relacionado
- Cachear Cargo y compilaciones de Rust en GitHub ActionsCachee el registro de Cargo, las dependencias git y el directorio target en GitHub Actions con Swatinem/rust-cache o actions/cache, sin cachés inflados.
- Caché de módulos Go y de compilación en GitHub ActionsCachee los módulos Go (GOMODCACHE) y la caché de compilación (GOCACHE) en GitHub Actions con setup-go o actions/cache. Claves, go.sum y aciertos.
- Cachear compilaciones de Gradle en GitHub ActionsCachee las dependencias y la caché de compilación de Gradle en GitHub Actions con gradle/actions/setup-gradle o actions/cache. Claves, PR de solo lectura.
- Cachear dependencias de npm en GitHub ActionsAlmacene en caché las dependencias de npm en GitHub Actions con setup-node o actions/cache. YAML funcional, la clave correcta y por qué no node_modules.