Bazel Docker コンテナのスタートガイド

問題を報告するソースを表示 ナイトリー · 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 を確認してください。