Generador de claves de caché para GitHub Actions
Elija su gestor de paquetes y obtenga un paso actions/cache con las rutas correctas, una clave basada en el lockfile y un respaldo restore-keys para que las instalaciones sigan siendo rápidas y las cachés nunca queden obsoletas.
Workflow step
- uses: actions/cache@v4
with:
path: |
~/.npm
key: ${{ runner.os }}-npm-v1-${{ hashFiles('**/package-lock.json') }}
restore-keys: |
${{ runner.os }}-npm-v1-
Exact key: ${{ runner.os }}-npm-v1-${{ hashFiles('**/package-lock.json') }}. Fallback prefix: ${{ runner.os }}-npm-v1-
Todo se ejecuta en su navegador; lo que escriba no se envía a ningún lugar.
Cómo usarla
- Elija su gestor de paquetes. Las rutas de caché y el patrón del lockfile se completan automáticamente.
- Decida si la clave incluye el sistema operativo y la arquitectura de CPU, y añada una sal de versión que pueda incrementar para invalidar la caché.
- Copie el YAML en su workflow antes del paso de instalación.
Preguntas frecuentes
¿Qué hace que una clave de caché sea buena?
Un prefijo que identifica el sistema operativo, la herramienta y una sal, seguido de un hash del lockfile. Cuando el lockfile cambia, la clave también cambia y se obtiene una caché nueva.
¿Para qué sirven las restore-keys?
Si no hay una coincidencia exacta, GitHub restaura la caché más reciente cuya clave comience por una restore key. Así, la instalación solo descarga lo que ha cambiado.
¿Cómo invalido una caché defectuosa?
Cambie la sal de versión de la clave, por ejemplo de v1 a v2. Las entradas antiguas caducan tras 7 días sin uso.
¿Cuál es el tamaño máximo de la caché?
De forma predeterminada, un repositorio dispone de 10 GB de caché en total, y las entradas menos usadas recientemente se eliminan cuando se llena.
Guías relacionadas
- 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.
Inserte esta calculadora en su sitio
Puede insertarla gratis en blogs y documentación. Pegue este HTML donde quiera que aparezca:
<iframe src="https://compiler.dev/embed/actions-cache-key-builder" title="GitHub Actions cache key builder" width="100%" height="560" style="border:1px solid #e5e7eb;border-radius:12px" loading="lazy"></iframe>
<p style="font-size:12px">Calculator by <a href="https://compiler.dev/tools/actions-cache-key-builder">compiler.dev</a></p>Herramientas relacionadas
- Verificador de YAML de flujos de trabajo de GitHub ActionsPegue un workflow de GitHub Actions y detecte runs-on ausente, acciones sin fijar, riesgos de pull_request_target, permisos y needs incorrectos.
- Previsor de minutos de CIPrevea los minutos de CI y el coste de GitHub Actions al mes según PR al día, pushes por PR, jobs por ejecución y minutos por job. Según plan y runner.
- Planificador de sharding de testsPegue las duraciones de los tests y divídalas en shards equilibrados. Vea los tests de cada shard, el tiempo total esperado y la mejora de velocidad.
- Generador de configuración de DependabotGenere un dependabot.yml para npm, pip, Docker, GitHub Actions, Go, Cargo y más, con programación, agrupación, etiquetas y revisores.