開始使用 Bazel Docker 容器

回報問題 查看原始碼 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

本頁面將詳細說明 Bazel 容器的內容、如何在 Bazel 容器中使用 Bazel 建構 abseil-cpp 專案,以及如何在主機上使用 Bazel 容器和目錄掛載功能,直接建構這個專案。

在主體機器中使用目錄掛接功能建立 Abseil 專案

您可以參考本節的操作說明,使用 Bazel 容器建構,並在主機環境中檢出來源。您執行的每個建構指令都會啟動容器。建構結果會在主機環境中快取,以便在不同版本之間重複使用。

將專案複製到主機電腦中的目錄。

git clone --depth 1 --branch 20220623.1 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 \
  gcr.io/bazel-public/bazel:latest \
  --output_user_root=/tmp/build_output \
  build //absl/...

新增 --config=asan|tsan|msan 建構標記,以便選取 AddressSanitizer (asan)、ThreadSanitizer (tsan) 或 MemorySanitizer (msan),藉此使用消毒劑建構專案。

docker run \
  -e USER="$(id -u)" \
  -u="$(id -u)" \
  -v /src/workspace:/src/workspace \
  -v /tmp/build_output:/tmp/build_output \
  -w /src/workspace \
  gcr.io/bazel-public/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 gcr.io/bazel-public/bazel:latest

每個容器 ID 均不得重複。在下列操作說明中,容器為 5a99103747c6。

複製專案。

ubuntu@5a99103747c6:~$ git clone --depth 1 --branch 20220623.1 https://github.com/abseil/abseil-cpp.git && cd abseil-cpp/

執行一般版本。

ubuntu@5a99103747c6:~/abseil-cpp$ bazel build //absl/...

新增 --config=asan|tsan|msan 建構標記,以便選取 AddressSanitizer (asan)、ThreadSanitizer (tsan) 或 MemorySanitizer (msan),藉此使用消毒劑建構專案。

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

探索 Bazel 容器

如果您尚未啟動 Bazel 容器中的互動式殼層,請先完成這項操作。

docker run -it --entrypoint=/bin/bash gcr.io/bazel-public/bazel:latest
ubuntu@5a99103747c6:~$

探索容器內容。

ubuntu@5a99103747c6:~$ gcc --version
gcc (Ubuntu 9.4.0-1ubuntu1~20.04.1) 9.4.0
Copyright (C) 2019 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
ubuntu@5a99103747c6:~$ java -version
openjdk version "1.8.0_362"
OpenJDK Runtime Environment (build 1.8.0_362-8u372-ga~us1-0ubuntu1~20.04-b09)
OpenJDK 64-Bit Server VM (build 25.362-b09, mixed mode)
ubuntu@5a99103747c6:~$ python -V
Python 3.8.10
ubuntu@5a99103747c6:~$ bazel version
WARNING: Invoking Bazel in batch mode since it is not invoked from within a workspace (below a directory having a WORKSPACE file).
Extracting Bazel installation...
Build label: 6.2.1
Build target: bazel-out/k8-opt/bin/src/main/java/com/google/devtools/build/lib/bazel/BazelServer_deploy.jar
Build time: Fri Jun 2 16:59:58 2023 (1685725198)
Build timestamp: 1685725198
Build timestamp as int: 1685725198

探索 Bazel Dockerfile

如要查看 Bazel Docker 映像檔的建構方式,請前往 bazelbuild/continuous-integration/bazel/oci 查看 Dockerfile。