Caché de GitHub Actions · artefactos · Turborepo

Tu caché de CI, en tu propia cuenta de Cloudflare

actions/cache y upload-artifact de serie cachean a través de CacheFlow sin cambios en los workflows, y Turborepo con un solo paso de configuración. Añade una política de consumidores de confianza y tus jobs de release restaurarán solo lo que produjo un build de confianza.

Una caché tuya, en la que confías y que puedes ver por dentro

Es tuya

Tu cuenta, tus bytes

CacheFlow se ejecuta en tu cuenta de Cloudflare, así que los bytes de la caché y de los artefactos nunca quedan en manos de terceros y los recursos aparecen en tu propia factura de Cloudflare.

  • Bytes de artefactos en R2, sin tarifas de salida
  • Propiedad de las claves en D1, una ruta de lectura rápida en KV, sesiones en curso en Durable Objects
  • Un solo despliegue sirve la caché de Actions, los artefactos de Actions y la caché remota de Turborepo

Confía en ella

Restaura solo lo que guardó un build de confianza

Las entradas guardadas con un token OIDC de GitHub, como hacen las acciones de CacheFlow, registran el evento, la ref, el commit y el workflow que las originaron. Añade una política de consumidores de confianza y tus jobs de release restaurarán solo entradas que un push, una ejecución programada o una ejecución manual guardó en tu rama protegida.

  • Solo credenciales de corta duración: OIDC de GitHub para las acciones de CacheFlow y el token de runtime del propio GitHub para los jobs con acciones de serie
  • Cada rama escribe solo en su propio ámbito y lee a través de su rama base y de la rama por defecto
  • En los jobs con OIDC, los guardados procedentes de eventos que personas externas pueden disparar en una rama protegida, como pull_request_target, quedan en cuarentena; los jobs con acciones de serie siguen el permiso de caché que concede el propio GitHub

Mírala por dentro

Conoce tu tasa de aciertos

Cada restauración, fallo y guardado de la caché de Actions y de los artefactos se registra con sus bytes, al igual que las descargas y subidas de Turborepo, incluido si una restauración coincidió con su clave exacta o recurrió a un prefijo.

  • Las claves de la caché de Actions y los nombres de artefactos se registran solo como hash con clave, nunca tal como se escribieron
  • Las sesiones almacenan en búfer las escrituras de los jobs de matriz en paralelo y las confirman de forma atómica
  • Las sesiones obsoletas se limpian cuando los builds terminan o agotan su tiempo

Empieza desde donde ya estás

Cuatro formas de entrar, desde cero cambios hasta el control total. La mayoría de los equipos empieza por la primera y nunca toca un workflow.

  1. Cero cambios

    Conserva los workflows que ya tienes

    Apunta tus runners a CacheFlow una sola vez. A partir de ahí, actions/cache, setup-node, Swatinem/rust-cache y upload-artifact de serie cachean a través de él, sin tocar nada. En los runners alojados en GitHub, el mismo workflow recurre a la caché de GitHub.

    # runner environment: set once, per runner pool
    ACTIONS_RESULTS_URL=https://cache.cacheflow.sh/
    
    # your workflows: unchanged
    - uses: actions/cache@v4
    - uses: Swatinem/rust-cache@v2
    - uses: actions/upload-artifact@v4
  2. Un paso

    Deja de recompilar lo que Turborepo ya compiló

    Añade setup-cacheflow y cada tarea cuyas entradas no hayan cambiado reproduce sus salidas en lugar de volver a ejecutarse, entre jobs, ramas y repositorios.

    Ver el workflow completo ↓
  3. Nivel release

    Publica solo lo que produjo un build de confianza

    Guarda las cachés de release y despliegue con las acciones de CacheFlow. Cada entrada registra el evento, la ref, el commit y el workflow que la originaron. Añade una política de consumidores de confianza y tus jobs de release restaurarán solo entradas que un push, una ejecución programada o una ejecución manual guardó en tu rama protegida.

    # the job needs permissions: { contents: read, id-token: write }
    - uses: CaptainEmpower/cacheflow/.github/actions/cache/save@v1
      with:
        path: dist
        key: release-${{ github.sha }}
        cache-url: ${{ vars.CACHEFLOW_CACHE_URL }}
    
    # Rust: the rust-cache fork, same attestation
    - uses: CaptainEmpower/rust-cache@v2-cacheflow
      with:
        cache-provider: cacheflow
  4. Cualquier herramienta

    Cachea lo que sea desde la línea de comandos

    La cacheflow CLI y el Python SDK guardan y restauran cualquier artefacto de cualquier herramienta de build. Las sesiones almacenan en búfer las escrituras de los jobs de matriz en paralelo y las confirman de forma atómica, así ningún job sobrescribe a otro.

    # In a GitHub Actions step after setup-cacheflow, which exports
    # CACHEFLOW_CACHE_URL, CACHEFLOW_TOKEN, CACHEFLOW_TENANT,
    # CACHEFLOW_REPOSITORY and CACHEFLOW_BRANCH (export them yourself
    # elsewhere). GITHUB_SHA is set by Actions.
    cacheflow cache namespace ci-build   # idempotent
    SESSION=$(cacheflow session start --namespace ci-build)
    cacheflow cache put ci-build "dist-$GITHUB_SHA" dist.tar.gz \
      --session "$SESSION"
    cacheflow session commit --namespace ci-build \
      --session "$SESSION" --status success
    cacheflow cache get ci-build "dist-$GITHUB_SHA" --out dist.tar.gz

Caché remota de Turborepo en un solo paso

setup-cacheflow emite una credencial OIDC de corta duración y exporta TURBO_API, TURBO_TOKEN y TURBO_TEAM. Sin secretos almacenados:

permissions:
  contents: read
  id-token: write

jobs:
  build:
    runs-on: ${{ vars.CI_RUNNER_LARGE || vars.CI_RUNNER_DEFAULT }}
    steps:
      - uses: actions/checkout@v4
      # exports TURBO_API, TURBO_TOKEN and TURBO_TEAM
      - uses: CaptainEmpower/cacheflow/.github/actions/setup-cacheflow@v1
        with:
          api-url: ${{ vars.CACHEFLOW_TURBO_API }}
          install-cli: 'false'
      - run: pnpm install --frozen-lockfile
      - run: pnpm turbo run build

Lo primero que preguntan los equipos

¿Tenemos que cambiar nuestros workflows?
No para la caché y los artefactos de Actions. Apunta una sola vez el entorno de tus runners a CacheFlow, y actions/cache, setup-node, Swatinem/rust-cache y upload-artifact de serie lo usan sin cambios. En los runners alojados en GitHub, los mismos workflows siguen usando la caché de GitHub. La caché remota de Turborepo requiere un paso setup-cacheflow por workflow.
¿Dónde se guardan nuestros datos?
En tu cuenta de Cloudflare: los bytes en R2, la propiedad de las claves en D1, una ruta de lectura en KV y las sesiones en curso en Durable Objects. La telemetría registra las claves de la caché de Actions y los nombres de artefactos solo como hash con clave. También estamos preparando un plan gestionado, operado por CacheFlow para ti.
¿Cuánto cuesta?
Los recursos de Cloudflare que usa CacheFlow se facturan a tu propia cuenta de Cloudflare, y R2 no cobra tarifas de salida. Compartiremos los precios de CacheFlow en sí con los equipos de acceso anticipado.
¿Es más rápido que la caché de GitHub?
No afirmamos nada sobre la velocidad. Los bytes llegan desde Cloudflare R2 a través de internet, y no hemos medido ninguna ventaja en la velocidad de restauración. Si necesitas una caché junto al runner, puede que la caché de un proveedor de runners te convenga más.
¿Cómo se autentican los jobs?
Los jobs que usan las acciones de CacheFlow o setup-cacheflow intercambian un token OIDC de GitHub de corta duración. Los jobs que usan directamente las acciones de serie emplean el token de runtime que GitHub ya da a cada job. En ambos casos, no se almacena ningún secreto de larga duración en tus pipelines. Otros sistemas de CI y los portátiles de los desarrolladores usan un token emitido por tu operador.
¿Podemos volver atrás?
Sí. CacheFlow habla los protocolos que tus herramientas ya usan: los servicios de caché y de artefactos de Actions y la caché remota de Turborepo. Quita la configuración de los runners o el paso setup-cacheflow, y tus workflows vuelven a la caché que usaban antes.

Consigue acceso anticipado

Únete a la lista de espera y te avisaremos cuando tu equipo pueda empezar.