使用有限 RAM 執行 Bazel

本頁說明如何使用旗標，在 RAM 空間有限的情況下執行 Bazel。

在某些情況下，您可能會希望 Bazel 使用最少的記憶體。您可以透過啟動旗標 --host_jvm_args 設定最大堆積，例如 --host_jvm_args=-Xmx2g。

不過，如果建構作業夠大，Bazel 可能會在記憶體不足時擲回 OutOfMemoryError (OOM)。您可以傳遞下列指令旗標，讓 Bazel 使用較少記憶體，但增量建構作業會變慢：--discard_analysis_cache、--nokeep_state_after_build 和 --notrack_incremental_state。

這些標記會盡量減少 Bazel 在建構作業中使用的記憶體，但會導致日後的建構作業比標準累加建構作業慢。

您也可以個別傳遞這些標記的任一項：

• --discard_analysis_cache 會減少執行期間 (而非分析期間) 使用的記憶體。增量建構作業不必重新載入套件，但必須重新執行分析作業 (不過，磁碟上的動作快取可以避免大部分的重新執行作業)。
• --notrack_incremental_state 不會在 Bazel 的內部依附元件圖表中儲存任何邊緣，因此無法用於累加建構作業。下一個版本會捨棄該資料，但除非指定 --nokeep_state_after_build，否則資料會保留到下一個版本發布為止，以供內部偵錯。
• --nokeep_state_after_build 會在建構後捨棄所有資料，因此遞增建構必須從頭開始建構 (磁碟上的動作快取除外)。單獨使用時，不會影響目前版本的最高水位線。