En esta página, se describe cómo limitar y reducir la memoria que usa Bazel.
Ejecuta Bazel con RAM limitada
En ciertas situaciones, es posible que desees que Bazel use la menor cantidad de memoria posible. Puedes establecer el heap máximo a través de la marca de inicio --host_jvm_args, como --host_jvm_args=-Xmx2g.
Intercambia velocidades de compilación incrementales por memoria
Si tus compilaciones son demasiado grandes, es posible que Bazel arroje un error OutOfMemoryError (OOM) cuando no tenga suficiente memoria. Puedes hacer que Bazel use menos memoria, pero a costa de compilaciones incrementales más lentas, si pasas las siguientes marcas de comando: --discard_analysis_cache, --nokeep_state_after_build y --notrack_incremental_state.
Estas marcas minimizarán la memoria que Bazel usa en una compilación, a costa de hacer que las compilaciones futuras sean más lentas de lo que sería una compilación incremental estándar.
También puedes pasar cualquiera de estos parámetros de forma individual:
--discard_analysis_cachereducirá la memoria que se usa durante la ejecución (no el análisis). Las compilaciones incrementales no tendrán que volver a cargar paquetes, pero sí tendrán que volver a realizar el análisis y la ejecución (aunque la caché de acciones en el disco puede evitar la mayoría de las reejecuciones).--notrack_incremental_stateno almacenará ninguna arista en el gráfico de dependencia interno de Bazel, por lo que no se podrá usar para compilaciones incrementales. La próxima compilación descartará esos datos, pero se conservarán hasta entonces para la depuración interna, a menos que se especifique--nokeep_state_after_build.--nokeep_state_after_builddescartará todos los datos después de la compilación, de modo que las compilaciones incrementales deberán compilarse desde cero (excepto la caché de acciones en el disco). Por sí solo, no afecta la marca de agua alta de la compilación actual.
Intercambia flexibilidad de compilación por memoria con Skyfocus (experimental)
Si deseas que Bazel use menos memoria y conserve las velocidades de compilación incrementales, puedes indicarle a Bazel el conjunto de trabajo de archivos que modificarás, y Bazel solo conservará el estado necesario para volver a compilar de forma incremental y correcta los cambios en esos archivos. Esta función se llama Skyfocus.
Para usar Skyfocus, pasa la marca --experimental_enable_skyfocus:
bazel build //pkg:target --experimental_enable_skyfocus
De forma predeterminada, el conjunto de trabajo será el conjunto de archivos junto al destino que se está compilando. En el ejemplo, todos los archivos de //pkg se mantendrán en el conjunto de trabajo, y no se permitirán los cambios en los archivos fuera del conjunto de trabajo hasta que ejecutes bazel clean o reinicies el servidor de Bazel.
Si deseas especificar un conjunto exacto de archivos o directorios, usa la marca --experimental_working_set, como se indica a continuación:
bazel build //pkg:target --experimental_enable_skyfocus
--experimental_working_set=path/to/another/dir,path/to/tests/dir
También puedes pasar --experimental_skyfocus_dump_post_gc_stats para mostrar la cantidad de reducción de memoria:
Al juntar todo, deberías ver algo como lo siguiente:
$ bazel test //pkg:target //tests/... --experimental_enable_skyfocus --experimental_working_set dir1,dir2,dir3/subdir --experimental_skyfocus_dump_post_gc_stats
INFO: --experimental_enable_skyfocus is enabled. Blaze will reclaim memory not needed to build the working set. Run 'blaze dump --skyframe=working_set' to show the working set, after this command.
WARNING: Changes outside of the working set will cause a build error.
INFO: Analyzed 149 targets (4533 packages loaded, 169438 targets configured).
INFO: Found 25 targets and 124 test targets...
INFO: Updated working set successfully.
INFO: Focusing on 334 roots, 3 leafs... (use --experimental_skyfocus_dump_keys to show them)
INFO: Heap: 1237MB -> 676MB (-45.31%)
INFO: Elapsed time: 192.670s ...
INFO: Build completed successfully, 62303 total actions
En este ejemplo, el uso de Skyfocus permitió que Bazel redujera 561 MB (45%) de memoria, y las compilaciones incrementales para controlar los cambios en los archivos en dir1, dir2 y dir3/subdir conservarán sus velocidades rápidas, con la desventaja de que Bazel no puede volver a compilar los archivos modificados fuera de estos directorios.
Generación de perfiles de memoria
Bazel incluye un generador de perfiles de memoria integrado que puede ayudarte a verificar el uso de memoria de tu regla. Obtén más información sobre este proceso en la sección de Memory Profiling de nuestra documentación sobre cómo mejorar el rendimiento de las reglas personalizadas.