Caché de Elixir

Tuist reutiliza las dependencias compiladas localmente y entre ejecuciones de CI. Habilítalo una vez y sigue usando mix compile y mix test.

Configuración#

Sigue Primeros pasos con Elixir una vez. La configuración compartida habilita la caché de dependencias junto con el análisis de compilaciones y tests; no se necesita ninguna configuración adicional de caché.

cache: true selecciona automáticamente las dependencias compatibles de Hex y Git; no necesitas enumerarlas. La compilación nativa/personalizada y las dependencias locales continúan funcionando a través de Mix con normalidad. Los archivos fuente de tu aplicación no se almacenan en caché.

Compila como siempre#

bash

mix compile
mix test

Cuando una dependencia necesita compilarse, Tuist consulta primero la caché local y luego la caché remota compartida. En caso de fallo de caché, la compilación se realiza normalmente y el resultado se guarda para futuras compilaciones. Las dependencias seleccionadas y compatibles que Mix considera actualizadas cuentan como aciertos locales cuando sus salidas compiladas están presentes y son válidas; no es necesario consultar la caché. Si la autenticación o la caché no están disponibles, Mix sigue compilando con normalidad.

Consulta los aciertos de tu caché#

Abre Caché de Mix en el panel de control de tu proyecto para ver las tasas de acierto, las transferencias y las compilaciones recientes. Selecciona la pestaña Caché de Mix de una compilación para ver qué tareas tuvieron aciertos o fallos. Salidas CAS muestra las descargas y subidas remotas reales; los aciertos locales no generan registros de transferencia remota. Reutilizar salidas ya actualizadas contribuye a la tasa de aciertos, pero no genera bytes de transferencia, latencia de restauración ni tiempo estimado ahorrado.

Para probar una restauración, limpia la salida compilada de una dependencia compatible y vuelve a compilar:

bash

mix deps.clean nimble_options --build
mix compile

Reemplaza nimble_options por una dependencia que use tu proyecto y que ya haya poblado la caché. Mantén el mismo entorno de Mix y la misma configuración del compilador.

Personaliza solo cuando sea necesario#

La mayoría de los proyectos pueden mantener cache: true. Usa una lista de palabras clave para las excepciones:

elixir

tuist: [
  project: "your-account/your-project",
  cache: [exclude: [:a_dependency_with_compile_time_side_effects]]
]

Entradas adicionales en tiempo de compilación: declara archivos externos con inputs: ["schemas"] y variables de entorno con env: ["COMPILER_OPTION"].
Solo local: establece remote: false.
Sin subidas remotas: establece upload: false. Los permisos del servidor siguen controlando el acceso.
Deshabilitar la caché: establece cache: false.

Important

La compilación puede ejecutar código Elixir arbitrario. Declara entradas adicionales y excluye dependencias cuyo código dependiente del tiempo o de la red, o cuyos efectos secundarios, deban ejecutarse en cada compilación. Los artefactos en caché pueden incluir secretos, y los escritores de caché son productores de código de confianza: no proporciones credenciales de escritura en caché a trabajos no confiables.

Para la selección de dependencias, la reutilización entre diferentes rutas de checkout, la resolución de problemas y los detalles de implementación, consulta configuración avanzada de la caché de Elixir.