Proyecto Bazel
Help me get started with Tuist. Follow the setup at:
https://tuist.dev/en/docs/guides/get-started/bazel-project
Sigue esta ruta para integrar un espacio de trabajo de Bazel existente en Tuist. Tuist expone una caché basada en la API de ejecución remota a la que Bazel se conecta como caché remota, y un flujo del servicio de eventos de compilación que convierte cada compilación y test en datos visibles en el panel. Para obtener una visión general de lo que Tuist aporta a Bazel, consulta Bazel con Tuist. Si estás migrando desde otro proveedor de Bazel, las comparativas de BuildBuddy y EngFlow explican los cambios.
Cada sección a continuación comienza señalando lo que falta hoy y luego te guía por la funcionalidad que cubre esa carencia.
Requisitos previos#
- Un espacio de trabajo de Bazel (con un
WORKSPACEoMODULE.bazelen su raíz) y Bazel disponible en tuPATH. - La interfaz de línea de comandos de Tuist.
Conectar el espacio de trabajo#
Desde la raíz del espacio de trabajo de Bazel, ejecuta tuist init. Tuist detecta el WORKSPACE / MODULE.bazel y ofrece Integrar un espacio de trabajo de Bazel. Autentícate en el navegador y elige la cuenta que debe ser propietaria del proyecto.
tuist init
Si lo estás ejecutando desde un agente de programación o un script, ejecuta primero tuist auth login (el flujo del navegador espera a que pulses Intro) y luego usa el modo no interactivo:
tuist init --build-system bazel --name <project-handle> --account <account>
Cuando finaliza init, Tuist:
- Escribe un
tuist.tomlen la raíz del espacio de trabajo con el identificador del proyecto. - Escribe un
.bazelrc.tuistjunto 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. - Añade una línea
try-import %workspace%/.bazelrc.tuista tu.bazelrc.
Confirma la línea try-import. Es idéntica en todas las máquinas. Añade .bazelrc.tuist a tu .gitignore. La ruta del asistente de credenciales es por usuario y la región de caché es por ubicación, por lo que no debe compartirse.
Todo lo siguiente se activa automáticamente una vez conectado el espacio de trabajo.
Caché remota#
La caché local en disco propia de Bazel reside en ~/.cache/bazel (o donde indique --disk_cache). Un acierto en la máquina de un desarrollador no llega a los demás, y los contenedores de trabajos de CI comienzan con una caché vacía en cada ejecución.
La API de ejecución remota de Bazel es el protocolo para extender esa misma caché a un extremo compartido. Tuist la soporta. Una vez que .bazelrc.tuist está configurado, Bazel omite las acciones cuyos resultados ya están en la caché compartida y los descarga en su lugar. El trabajo de una máquina beneficia a todas las demás que compilan la misma revisión.
Verifícalo con dos compilaciones limpias contra la misma revisión (de forma local, o una local + una de CI):
bazel clean
bazel build //...
El resumen de la segunda ejecución debería mostrar aciertos de caché. Abre Caché en el panel para ver las tasas de acierto a lo largo del tiempo.
Análisis de compilaciones y tests#
El flujo de eventos de compilación de Bazel y los informes XML por test se emiten en cada invocación. Comparar duraciones a nivel de objetivo a lo largo de una semana, o detectar un test que se ha vuelto inestable en varias ejecuciones de CI, implica recopilar y agregar esos eventos en algún lugar.
El protocolo del servicio de eventos de compilación que Bazel ya emite está diseñado precisamente para eso. El .bazelrc.tuist que escribió tuist init configura el flujo BES hacia Tuist, de modo que los análisis de compilaciones y tests comienzan a llegar en la siguiente bazel build y bazel test. No hay nada más que configurar. Abre Compilaciones y Tests en el panel para ver los datos.
Incorpora al equipo#
Los aciertos de caché y los análisis se multiplican con el número de personas conectadas al proyecto. Invita a tus compañeros a la organización desde la configuración de la cuenta en el panel y configura el inicio de sesión único (Google, Okta, Microsoft) para que la incorporación sea un clic en lugar de un tuist auth login individual.