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）を適宜選択し、サニタイザーを使用してプロジェクトをビルドします。

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 コンテナとコンテナ内のソースを使用してビルドできます。開発ワークフローの開始時にコンテナを起動し、コンテナ内の worskpace に変更を加えた場合、ビルド結果がキャッシュに保存されます。

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）を適宜選択し、サニタイザーを使用してプロジェクトをビルドします。

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