Ubuntu への Bazel のインストール

このページでは、Ubuntu に Bazel をインストールするオプションについて説明します。また、バックアップ オプションとして必要な場合(管理者アクセス権がない場合など)は、Bazel 完了スクリプトとバイナリ インストーラへのリンクも記載しています。

サポートされている Ubuntu Linux プラットフォーム:

  • 22.04(LTS)
  • 20.04(LTS)
  • 18.04(LTS)

Bazel は他の Ubuntu リリースと Debian「stretch」以降と互換性があるはずですが、テストされていないため、動作が保証されるわけではありません。

次のいずれかの方法で Ubuntu に Bazel をインストールします。

注: Arm ベースのシステムの場合、APT リポジトリには arm64 リリースが含まれておらず、バイナリ インストーラは使用できません。Bazelisk を使用するか、ソースからコンパイルします。

Bazel には、2 つの完了スクリプトが付属しています。Bazel をインストールすると、次のことができます。

Bazel の apt リポジトリを使用する

ステップ 1: Bazel 配布 URI をパッケージ ソースとして追加する

注: この手順は 1 回限りの設定です。

sudo apt install apt-transport-https curl gnupg -y
curl -fsSL https://bazel.build/bazel-release.pub.gpg | gpg --dearmor >bazel-archive-keyring.gpg
sudo mv bazel-archive-keyring.gpg /usr/share/keyrings
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/bazel-archive-keyring.gpg] https://storage.googleapis.com/bazel-apt stable jdk1.8" | sudo tee /etc/apt/sources.list.d/bazel.list

コンポーネント名「jdk1.8」は、以前の理由でのみ維持され、サポートされている JDK バージョンや含まれている JDK バージョンとは関係ありません。Bazel リリースは Java バージョンに依存しません。「jdk1.8」コンポーネント名を変更すると、リポジトリの既存のユーザーが使用できなくなります。

ステップ 2: Bazel をインストールして更新する

sudo apt update && sudo apt install bazel

インストールが完了したら、通常のシステム アップデートの一環として Bazel の新しいバージョンにアップグレードできます。

sudo apt update && sudo apt full-upgrade

bazel パッケージは常に Bazel の最新の安定版をインストールします。最新バージョンに加えて、特定の古いバージョンの Bazel をインストールすることもできます。

sudo apt install bazel-1.0.0

これにより、Bazel 1.0.0 が /usr/bin/bazel-1.0.0 としてシステムにインストールされます。これは、プロジェクトのビルドに特定のバージョンの Bazel が必要な場合に便利です。たとえば、.bazelversion ファイルを使用して、ビルドする Bazel バージョンを明示的に指定する場合などです。

必要に応じて、シンボリック リンクを作成して bazel を特定のバージョンに設定することもできます。

sudo ln -s /usr/bin/bazel-1.0.0 /usr/bin/bazel
bazel --version  # 1.0.0

ステップ 3: JDK をインストールする(省略可)

Bazel には、ランタイムとして限定公開のバンドル JRE が含まれているため、特定のバージョンの Java をインストールする必要はありません。

ただし、Bazel を使用して Java コードをビルドする場合は、JDK をインストールする必要があります。

sudo apt install default-jdk

バイナリ インストーラを使用する

通常は apt リポジトリを使用する必要がありますが、マシンに管理者権限がない、またはカスタム リポジトリを追加できない場合は、バイナリ インストーラが便利です。

バイナリ インストーラは Bazel の GitHub リリースページからダウンロードできます。

インストーラには Bazel バイナリが含まれており、$HOME/bin フォルダに展開されます。Bazel を機能させるには、追加のライブラリを手動でインストールする必要があります。

ステップ 1: 必要なパッケージをインストールする

Bazel が動作するには、C++ コンパイラと unzip / zip が必要です。

sudo apt install g++ unzip zip

Bazel を使用して Java コードをビルドする場合は、JDK をインストールします。

sudo apt-get install default-jdk

ステップ 2: インストーラを実行する

次に、GitHub の Bazel リリース ページから、bazel-version-installer-linux-x86_64.sh という名前の Bazel バイナリ インストーラをダウンロードします。

次のように実行します。

chmod +x bazel-version-installer-linux-x86_64.sh
./bazel-version-installer-linux-x86_64.sh --user

--user フラグは、Bazel をシステムの $HOME/bin ディレクトリにインストールし、.bazelrc パスを $HOME/.bazelrc に設定します。追加のインストール オプションを表示するには、--help コマンドを使用します。

ステップ 3: 環境を設定する

上記のように --user フラグを指定して Bazel インストーラを実行した場合、Bazel 実行可能ファイルは $HOME/bin ディレクトリにインストールされます。このディレクトリを次のようにして、デフォルトのパスに追加することをおすすめします。

export PATH="$PATH:$HOME/bin"

このコマンドを ~/.bashrc ファイルまたは ~/.zshrc ファイルに追加して、永続化することもできます。

Bazel Docker コンテナの使用

gcr.io/bazel-public/bazel で、Bazel バージョンごとに Bazel がインストールされた Docker コンテナを公開しています。 Docker コンテナは次のように使用できます。

$ docker pull gcr.io/bazel-public/bazel:<bazel version>

Docker コンテナは、こちらの手順でビルドされます。