開始使用 Bazel Docker 容器

本頁面將詳細說明 Bazel 容器內容、如何在 Bazel 容器內使用 Bazel 建構 abseil-cpp 專案，以及如何使用搭配目錄掛接的 Bazel 容器，直接從主體建構這項專案。

使用目錄掛接功能，從主體機器建構 Abseil 專案

本節的操作說明可讓您使用 Bazel 容器，搭配在主機環境中簽出的來源進行建構。您執行的每個建構指令都會啟動容器。系統會將建構結果快取在您的主機環境中，以便在各建構之間重複使用。

將專案複製到主體機器中的目錄。

git clone https://github.com/abseil/abseil-cpp.git /src/workspace

建立儲存快取結果的資料夾，以便跨建構作業共用。

mkdir -p /tmp/build_output/

使用 Bazel 容器建構專案，並在主體的輸出資料夾中提供建構輸出內容。

docker run \
  -e USER="$(id -u)" \
  -u="$(id -u)" \
  -v /src/workspace:/src/workspace \
  -v /tmp/build_output:/tmp/build_output \
  -w /src/workspace \
  l.gcr.io/google/bazel:latest \
  --output_user_root=/tmp/build_output \
  build //absl/...

新增 --config=asan|tsan|msan 建構旗標，據此選取 AddressSanitizer (asan)、ThreadSanitizer (tsan) 或 MemorySanitizer (msan)，藉此使用 Sanitizer 建構專案。

docker run \
  -e USER="$(id -u)" \
  -u="$(id -u)" \
  -v /src/workspace:/src/workspace \
  -v /tmp/build_output:/tmp/build_output \
  -w /src/workspace \
  l.gcr.io/google/bazel:latest \
  --output_user_root=/tmp/build_output \
  build --config={asan | tsan | msan} -- //absl/... -//absl/types:variant_test

在容器內建構 Abseil 專案

本節的操作說明可讓您使用容器內部的來源，使用 Bazel 容器進行建構。在開發工作流程開始時啟動容器，並在容器中的錯誤發生時變更，系統將快取建構結果。

在 Bazel 容器中啟動殼層：

docker run --interactive --entrypoint=/bin/bash l.gcr.io/google/bazel:latest

每個容器 ID 都不得重複。在下方操作說明中，容器為 5a99103747c6。

複製專案。

root@5a99103747c6:~# git clone https://github.com/abseil/abseil-cpp.git && cd abseil-cpp/

執行一般版本。

root@5a99103747c6:~/abseil-cpp# bazel build //absl/...

新增 --config=asan|tsan|msan 建構標記，即可據此選取 AddressSanitizer (asan)、ThreadSanitizer (tsan) 或 MemorySanitizer (msan)，藉此使用 Sanitizer 建構專案。

root@5a99103747c6:~/abseil-cpp# bazel build --config=--config={asan | tsan | msan} -- //absl/... -//absl/types:variant_test

探索 Bazel 容器

如果您尚未在 Bazel 容器中啟動互動式殼層，請先執行。

docker run -it --entrypoint=/bin/bash l.gcr.io/google/bazel:latest
root@5a99103747c6:/#

探索容器內容。

root@5a99103747c6:/# clang --version
clang version 8.0.0 (trunk 340178)
Target: x86_64-unknown-linux-gnu
Thread model: posix
InstalledDir: /usr/local/bin
root@5a99103747c6:/# java -version
openjdk version "1.8.0_181"
OpenJDK Runtime Environment (build 1.8.0_181-8u181-b13-0ubuntu0.16.04.1-b13)
OpenJDK 64-Bit Server VM (build 25.181-b13, mixed mode)
root@5a99103747c6:/# python -V
Python 2.7.12
root@5a99103747c6:/# python3 -V
Python 3.6.6
root@5a99103747c6:/# bazel version
Extracting Bazel installation...
Build label: 0.17.1
Build target: bazel-out/k8-opt/bin/src/main/java/com/google/devtools/build/lib/bazel/BazelServer_deploy.jar
Build time: Fri Sep 14 10:39:25 2018 (1536921565)
Build timestamp: 1536921565
Build timestamp as int: 1536921565