Caché de Bazel

Tuist expone una caché de la API de ejecución remota a la que Bazel se conecta como caché remota. Cuando los resultados de una acción ya están en la caché, Bazel omite la acción y obtiene el resultado de la caché de Tuist, ahorrando tiempo de compilación para todo tu equipo y en entornos de CI.

Configuración#

Desde la raíz del espacio de trabajo de Bazel, ejecuta:

Esto crea un archivo .bazelrc.tuist junto a tu .bazelrc, configurado para la región de caché de Tuist más cercana y autenticado mediante un asistente de credenciales por espacio de trabajo. También añade una línea try-import al archivo .bazelrc de tu repositorio:

Pasa --no-add-bazelrc-import si quieres gestionar la importación tú mismo.

Añade .bazelrc.tuist a tu .gitignore y ejecuta la configuración en cada máquina en lugar de confirmar el archivo. El archivo generado apunta a una ruta absoluta del asistente de credenciales dentro del directorio de configuración de Tuist del usuario actual y a la región de caché más cercana a la máquina que lo generó, por lo que ninguno de estos valores es válido para un compañero de equipo o un ejecutor de integración continua. Confirma la línea try-import en .bazelrc, que es igual en todas las máquinas.

La configuración no modifica un .bazelrc existente cuando no puede encontrar un marcador de espacio de trabajo de Bazel, cuando el archivo es un enlace simbólico o cuando ya configura una caché remota o el servicio Build Event Service. De este modo, volver a ejecutarla es idempotente.

Ejecuta un comando normal de Bazel para verificar la integración:

La actividad de la caché aparece entonces en la página Bazel Cache del proyecto en el panel de Tuist, que muestra la transferencia de caché, descargas y subidas, latencia de lectura y escritura, rendimiento y la tasa de aciertos de la caché de acciones. La sección Overview del proyecto incluye un resumen de esa misma tasa de aciertos de la caché de acciones junto con la duración de la compilación.

Para ver cómo un comando utilizó la caché, ábrelo desde Invocations. La página de invocación separa las consultas a la caché de acciones de las solicitudes de objetos de contenido, de modo que puedes distinguir una caché de acciones fría de una descarga lenta de artefactos.

Análisis de compilaciones#

De forma predeterminada, tuist bazel setup también configura el servicio Build Event Service de Bazel para que los comandos completados aparezcan en el panel Invocations. Consulta Análisis de compilaciones de Bazel para saber qué muestra el panel y cómo adjuntar metadatos personalizados.

Si solo quieres la caché remota y prefieres no enviar el flujo de eventos de compilación, exclúyelo con:

Integración continua#

Autentica la CI con uno de los métodos de la Guía de autenticación, luego ejecuta tuist bazel setup una vez como parte del paso de checkout para que .bazelrc.tuist refleje la región correcta para el ejecutor. Consulta la Guía de integración continua para ver ejemplos específicos de cada proveedor.

Retención de datos#

Tuist conserva las observaciones de la caché remota durante 90 días. Consulta retención de datos para conocer la política completa.