您可以從指令碼呼叫 Bazel,以執行建構、測試或查詢依附元件圖表。Bazel 是專為啟用有效的指令碼而設計,但本節列出一些細節,以利指令碼更完善運作。
選擇輸出基礎
--output_base
選項可控管 Bazel 程序應將建構作業的輸出內容寫入的位置,以及 Bazel 在內部使用的各種工作檔案,其中一個檔案是鎖定,可防止多個 Bazel 程序同時變更輸出基礎。
為指令碼選擇正確的輸出基本目錄取決於多項因素。如果需要將建構輸出內容存放在特定位置,就會決定您需要使用的輸出基礎。如果您向 Bazel 發出「只讀」呼叫 (例如 bazel query
),鎖定因素就會更重要。請特別注意,如果需要同時執行多個指令碼執行個體,您需要為每個指令碼提供不同的 (或隨機) 輸出基礎。
如果您使用預設輸出基底值,就會與使用者互動式 Bazel 指令使用的鎖定機制競爭。如果使用者發出長時間執行的指令 (例如建構),您的指令碼必須等待這些指令完成後才能繼續執行。
伺服器模式註意事項
根據預設,Bazel 會使用長時間執行的伺服器程序做為最佳化。在指令碼中執行 Bazel 時,別忘了在伺服器完成後呼叫 shutdown
,或是指定 --max_idle_secs=5
,讓閒置伺服器立即關閉。
我會收到哪個結束代碼?
Bazel 會嘗試將因考量中原始碼而導致的失敗,與導致 Bazel 無法正常執行的外部錯誤區分開。Bazel 執行作業可能會導致下列結束代碼:
所有指令的通用結束代碼:
0
- 成功2
- 指令列問題、錯誤或非法的旗標或指令組合,或不正確的環境變數。您必須修改指令列。8
- 建構中斷,但我們已實際終止服務。9
- 保留伺服器鎖定,且通過了--noblock_for_lock
。32
- 外部環境失敗,但不是在本機上。33
- Bazel 記憶體不足,因此當機。您必須修改指令列。34
- 僅供 Google 內部使用。35
- 保留供 Google 內部使用。36
- 當地環境問題,疑似永久存在。37
- 無法處理的例外狀況 / 內部 Bazel 錯誤。38
- 保留供 Google 內部使用。39
:系統會從遠端快取中移除 Bazel 所需的 Blob。41-44
- 保留供 Google 內部使用。45
:將結果發布至建構事件服務時發生錯誤。47
- 保留供 Google 內部使用。
指令 bazel build
、bazel test
的傳回碼:
1
- 建構失敗。3
- 建構作業成功,但部分測試失敗或逾時。4
- 建構作業成功,但即使要求測試,也找不到任何測試。
針對 bazel run
:
1
- 建構失敗。- 如果建構成功,但執行的子程序會傳回非零的結束代碼,則也會是指令的結束代碼。
bazel query
:
3
- 部分成功,但在輸入的 BUILD 檔案集中發生 1 個以上的錯誤,因此作業結果不一定可靠。原因可能是指令列上的--keep_going
選項。7
- 指令失敗。
未來的 Bazel 版本可能會新增其他結束碼,將一般失敗結束碼 1
替換為具有特定意義的其他非零值。不過,所有非零的離開值一律都會構成錯誤。
讀取 .bazelrc 檔案
根據預設,Bazel 會從基礎工作區目錄或使用者的主目錄讀取 .bazelrc
檔案。是否要使用這個選項取決於指令碼的需要。如果指令碼需要完全密封 (例如在進行發布版本時),您應使用 --bazelrc=/dev/null
選項停用讀取 .bazelrc 檔案的功能。如果您想以使用者的偏好設定執行建構作業,建議採用預設行為。
指令記錄
您也可以使用下列指令,在指令記錄檔中找到 Bazel 輸出:
bazel info command_log
指令記錄檔案包含最新 Bazel 指令的 stdout 和 stderr 交錯串流。請注意,執行 bazel info
會覆寫這個檔案的內容,因為這會成為最新的 Bazel 指令。但是,除非您變更 --output_base
或 --output_user_root
選項的設定,否則指令記錄檔的位置不會改變。
剖析輸出內容
Bazel 輸出內容很容易剖析,以因應多種用途。對指令碼而言,兩個選項可能很實用:--noshow_progress
會隱藏進度訊息,而 --show_result n
則控制是否列印「建構最新」訊息;系統可能會剖析這些訊息,以探索成功建構的目標和輸出檔案的位置。如果您依賴這些訊息,請務必指定非常大的 n 值。
分析效能疑難排解
請參閱「效能分析」一節。