Optimiza la memoria

En esta página, se describe cómo limitar y reducir la memoria que usa Bazel.

Cómo ejecutar Bazel con RAM limitada

En ciertas situaciones, es posible que desees que Bazel use una cantidad mínima de memoria. Puedes configurar el montón 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, Bazel puede arrojar un OutOfMemoryError (OOM) cuando no tenga suficiente memoria. Puedes hacer que Bazel use menos memoria, 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 que una compilación incremental estándar.

También puedes pasar cualquiera de estas marcas de forma individual:

• --discard_analysis_cache reducirá la memoria que se usa durante la ejecución (no el análisis). Las compilaciones incrementales no tendrán que volver a cargar el paquete, pero sí deberán 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_state no almacenará ningún borde en el gráfico de dependencias interno de Bazel, por lo que no se podrá usar para compilaciones incrementales. La siguiente 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_build descartará todos los datos después de la compilación, de modo que las compilaciones incrementales se tengan que compilar desde cero (excepto la caché de acciones en el disco). Por sí solo, no afecta el límite máximo de la compilación actual.

Cambia la flexibilidad de compilación por memoria con Skyfocus (experimental)

Si deseas que Bazel use menos memoria y retenga las velocidades de compilación incrementales, puedes indicarle el conjunto de trabajo de archivos que modificarás, y Bazel solo mantendrá el estado necesario para volver a compilar de forma incremental 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 objetivo que se compila. 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 emitas 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 el monto de reducción de memoria:

Si lo unes 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 liberara 561 MB (45%) de memoria, y las compilaciones incrementales para controlar los cambios en los archivos de 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 perfiles de memoria de nuestra documentación sobre cómo mejorar el rendimiento de las reglas personalizadas.