Saltar al contenido

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.

Incremente para invalidar todas las cachés existentes

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

  1. Elija su gestor de paquetes. Las rutas de caché y el patrón del lockfile se completan automáticamente.
  2. 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é.
  3. 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

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>