Nesta página, descrevemos como limitar e reduzir a memória usada pelo Bazel.
Executar o Bazel com RAM limitada
Em determinadas situações, talvez você queira que o Bazel use o mínimo de memória possível. É possível definir o
heap máximo usando a flag de inicialização
--host_jvm_args,
como --host_jvm_args=-Xmx2g.
Trocar velocidades de build incremental por memória
Se os builds forem muito grandes, o Bazel poderá gerar um erro OutOfMemoryError (OOM) quando
não tiver memória suficiente. Para fazer o Bazel usar menos memória, mas com builds incrementais mais lentos, transmita as seguintes flags de comando: --discard_analysis_cache, --nokeep_state_after_build e --notrack_incremental_state.
Essas flags minimizam a memória usada pelo Bazel em um build, mas tornam os builds futuros mais lentos do que um build incremental padrão.
Também é possível transmitir uma destas flags individualmente:
--discard_analysis_cachevai reduzir a memória usada durante a execução (não a análise). Os builds incrementais não precisam refazer o carregamento de pacotes, mas precisam refazer a análise e a execução. No entanto, o cache de ações no disco pode evitar a maioria das reexecuções.- O
--notrack_incremental_statenão armazena nenhuma aresta no gráfico de dependência interno do Bazel, o que o torna inutilizável para builds incrementais. O build seguinte vai descartar esses dados, mas eles serão preservados até lá para depuração interna, a menos que--nokeep_state_after_buildseja especificado. - O
--nokeep_state_after_buildvai descartar todos os dados após o build, para que os builds incrementais precisem ser criados do zero (exceto o cache de ações no disco). Sozinho, ele não afeta a marca d'água do build atual.
Troque a flexibilidade de build por memória com o Skyfocus (experimental)
Se você quiser que o Bazel use menos memória e mantenha as velocidades de build incremental, informe ao Bazel o conjunto de trabalho de arquivos que você vai modificar, e o Bazel só vai manter o estado necessário para reconstruir incrementalmente as mudanças nesses arquivos. Esse recurso é chamado de Skyfocus.
Para usar o Skyfocus, transmita a flag --experimental_enable_skyfocus:
bazel build //pkg:target --experimental_enable_skyfocus
Por padrão, o conjunto de trabalho será o conjunto de arquivos ao lado do destino que está sendo
criado. No exemplo, todos os arquivos em //pkg serão mantidos no conjunto de trabalho, e
as mudanças em arquivos fora do conjunto de trabalho serão proibidas até que você emita
bazel clean ou reinicie o servidor do Bazel.
Se você quiser especificar um conjunto exato de arquivos ou diretórios, use a flag
--experimental_working_set desta forma:
bazel build //pkg:target --experimental_enable_skyfocus
--experimental_working_set=path/to/another/dir,path/to/tests/dir
Você também pode transmitir --experimental_skyfocus_dump_post_gc_stats para mostrar o valor da redução de memória:
Juntando tudo, você vai ver algo assim:
$ 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
Neste exemplo, o uso do Skyfocus permitiu que o Bazel descartasse 561 MB (45%) de memória, e as builds incrementais para processar mudanças em arquivos em dir1, dir2 e dir3/subdir mantêm a velocidade rápida. Em contrapartida, o Bazel não pode recriar arquivos alterados fora desses diretórios.
Criação de perfil de memória
O Bazel vem com um criador de perfil de memória integrado que pode ajudar você a verificar o uso de memória da sua regra. Leia mais sobre esse processo na seção de criação de perfil de memória da nossa documentação sobre como melhorar o desempenho das regras personalizadas.