Primeiros passos com o contêiner do Docker do Bazel

Esta página fornece detalhes sobre o conteúdo do contêiner do Bazel, como criar o projeto abseil-cpp usando o Bazel dentro do contêiner do Bazel e como criar esse projeto diretamente na máquina host usando o contêiner do Bazel com montagem de diretório.

Criar um projeto Abseil na máquina host com montagem de diretório

As instruções desta seção permitem que você crie usando o contêiner do Bazel com as origens extraídas no ambiente do host. Um contêiner é iniciado para cada comando de build executado. Os resultados do build são armazenados em cache no ambiente do host para que possam ser reutilizados em builds.

Clone o projeto para um diretório na máquina host.

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

Crie uma pasta que terá resultados armazenados em cache para serem compartilhados entre as builds.

mkdir -p /tmp/build_output/

Use o contêiner do Bazel para criar o projeto e disponibilizar as saídas do build na pasta de saída da máquina host.

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/...

Crie o projeto com limpadores adicionando a flag de build --config=asan|tsan|msan para selecionar AddressSanitizer (asan), ThreadSanitizer (tsan) ou MemorySanitizer (msan) de acordo.

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

Criar o projeto Abseil dentro do contêiner

As instruções desta seção permitem que você crie usando o contêiner do Bazel com as origens dentro do contêiner. Ao iniciar um contêiner no início do fluxo de trabalho de desenvolvimento e fazer alterações no espaço de trabalho dentro do contêiner, os resultados de build serão armazenados em cache.

Inicie um shell no contêiner do Bazel:

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

Cada ID de contêiner é único. Nas instruções abaixo, o contêiner era 5a99103747c6.

Clone o projeto.

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

Faça um build regular.

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

Crie o projeto com limpadores adicionando a flag de build --config=asan|tsan|msan para selecionar AddressSanitizer (asan), ThreadSanitizer (tsan) ou MemorySanitizer (msan).

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

Conheça o contêiner do Bazel

Se ainda não fez isso, inicie um shell interativo dentro do contêiner do Bazel.

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

Confira o conteúdo do contêiner.

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