プラットフォーム

問題を報告 ソースを表示 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Bazel は、さまざまなハードウェア、オペレーティング システム、システム構成で、リンカーやコンパイラなど、さまざまなバージョンのビルドツールを使用してコードをビルドしてテストできます。この複雑さを管理するために、Bazel には制約プラットフォームの概念があります。制約とは、ビルド環境や本番環境が異なる可能性があるディメンション(CPU アーキテクチャ、GPU の有無、システムにインストールされているコンパイラのバージョンなど)です。プラットフォームは、これらの制約の選択肢の名前付きコレクションであり、特定の環境で使用可能な特定のリソースを表します。

環境をプラットフォームとしてモデル化すると、Bazel はビルド アクションに適したツールチェーンを自動的に選択できます。プラットフォームを config_setting ルールと組み合わせて使用し、構成可能な属性を作成することもできます。

Bazel は、プラットフォームが果たす可能性がある 3 つのロールを認識します。

  • ホスト - Bazel 自体が実行されるプラットフォーム。
  • 実行 - ビルドツールがビルド アクションを実行して中間出力と最終出力を生成するプラットフォーム。
  • ターゲット - 最終的な出力が配置され、実行されるプラットフォーム。

Bazel は、プラットフォームに関する次のビルドシナリオをサポートしています。

  • 単一プラットフォームのビルド(デフォルト) - ホスト、実行、ターゲット プラットフォームは同じです。たとえば、Intel x64 CPU で実行されている Ubuntu で Linux 実行可能ファイルをビルドします。

  • クロスコンパイル ビルド - ホスト プラットフォームと実行プラットフォームは同じですが、ターゲット プラットフォームは異なります。たとえば、MacBook Pro で実行されている macOS で iOS アプリをビルドします。

  • マルチプラットフォーム ビルド - ホスト、実行、ターゲット プラットフォームがすべて異なります。

制約とプラットフォームの定義

プラットフォームの選択可能な空間は、BUILD ファイル内の constraint_setting ルールと constraint_value ルールを使用して定義されます。constraint_setting は新しいディメンションを作成し、constraint_value は指定されたディメンションの新しい値を作成します。これらを組み合わせて、列挙型とその指定可能な値を効果的に定義します。たとえば、次の BUILD ファイルのスニペットでは、システムの glibc バージョンに 2 つの有効な値の制約を導入しています。

constraint_setting(name = "glibc_version")

constraint_value(
    name = "glibc_2_25",
    constraint_setting = ":glibc_version",
)

constraint_value(
    name = "glibc_2_26",
    constraint_setting = ":glibc_version",
)

制約とその値は、ワークスペース内の異なるパッケージにわたって定義できます。これらはラベルで参照され、通常の公開設定の対象となります。可視性で許可されている場合は、独自の値を定義して、既存の制約設定を拡張できます。

platform ルールでは、特定の制約値を選択できる新しいプラットフォームが導入されます。次の例では、linux_x86 という名前のプラットフォームが作成され、glibc バージョン 2.25 の x86_64 アーキテクチャで Linux オペレーティング システムを実行する環境が記述されています。(Bazel の組み込み制約の詳細については、以下をご覧ください)。

platform(
    name = "linux_x86",
    constraint_values = [
        "@platforms//os:linux",
        "@platforms//cpu:x86_64",
        ":glibc_2_25",
    ],
)

一般に役立つ制約とプラットフォーム

エコシステムの整合性を維持するため、Bazel チームは、最も一般的な CPU アーキテクチャとオペレーティング システムの制約定義を含むリポジトリを維持しています。これらはすべて https://github.com/bazelbuild/platforms にあります。

Bazel には、@platforms//host(別名 @bazel_tools//tools:host_platform)という特別なプラットフォーム定義が付属しています。これは自動検出されたホスト プラットフォームの値で、Bazel が実行されているシステムの自動検出されたプラットフォームを表します。

ビルドのプラットフォームを指定する

次のコマンドライン フラグを使用して、ビルドのホスト プラットフォームとターゲット プラットフォームを指定できます。

  • --host_platform - デフォルトは @bazel_tools//tools:host_platform です。
    • このターゲットは @platforms//host にエイリアスされます。これは、ホスト OS と CPU を検出してプラットフォーム ターゲットを書き込むリポジトリ ルールによってサポートされています。
    • @platforms//host:constraints.bzl もあります。これは、他の BUILD ファイルと Starlark ファイルで使用できる HOST_CONSTRAINTS という配列を公開します。
  • --platforms - デフォルトはホスト プラットフォームです
    • つまり、他のフラグが設定されていない場合、@platforms//host がターゲット プラットフォームになります。
    • --platforms ではなく --host_platform が設定されている場合、--host_platform の値はホスト プラットフォームとターゲット プラットフォームの両方です。

互換性のないターゲットのスキップ

特定のターゲット プラットフォーム用にビルドする場合は、そのプラットフォームで動作しないターゲットをスキップすることがよくあります。たとえば、//... を使用して Linux マシンでビルドすると、Windows デバイス ドライバでコンパイラ エラーが大量に発生する可能性があります。target_compatible_with 属性を使用して、コードのターゲット プラットフォームの制約を Bazel に伝えます。

この属性の最も簡単な使用方法は、ターゲットを 1 つのプラットフォームに制限することです。すべての制約を満たさないプラットフォームにはターゲットは構築されません。次の例では、win_driver_lib.cc を 64 ビット Windows に制限しています。

cc_library(
    name = "win_driver_lib",
    srcs = ["win_driver_lib.cc"],
    target_compatible_with = [
        "@platforms//cpu:x86_64",
        "@platforms//os:windows",
    ],
)

:win_driver_lib は 64 ビット Windows でのビルドにのみ対応しており、それ以外には対応していません。互換性がない場合は、その互換性が他の要素にも影響します。互換性のないターゲットに間接的に依存するターゲットは、それ自体が互換性がないものと見なされます。

ターゲットがスキップされるのはいつですか?

ターゲットが互換性がないと考えられる場合はスキップされ、ターゲット パターンの拡張の一部としてビルドに含まれます。たとえば、次の 2 つの呼び出しでは、ターゲット パターンの拡張で見つかった互換性のないターゲットはスキップされます。

$ bazel build --platforms=//:myplatform //...
$ bazel build --platforms=//:myplatform //:all

同様に、コマンドラインで --expand_test_suites を使用して test_suite が指定されている場合、test_suite 内の互換性のないテストはスキップされます。つまり、コマンドライン上の test_suite ターゲットは、:all... のように動作します。--noexpand_test_suites を使用すると拡張が防止され、互換性のないテストを含む test_suite ターゲットも互換性がなくなります。

コマンドラインで互換性のないターゲットを明示的に指定すると、エラー メッセージが表示され、ビルドが失敗します。

$ bazel build --platforms=//:myplatform //:target_incompatible_with_myplatform
...
ERROR: Target //:target_incompatible_with_myplatform is incompatible and cannot be built, but was explicitly requested.
...
FAILED: Build did NOT complete successfully

--skip_incompatible_explicit_targets が有効になっている場合、互換性のない明示的なターゲットはサイレントでスキップされます。

表現力の高い制約

制約をより柔軟に表現するには、どのプラットフォームも満たさない @platforms//:incompatible constraint_value を使用します。

より複雑な制限を表現するには、@platforms//:incompatible と組み合わせて select() を使用します。たとえば、基本的な OR ロジックを実装するために使用します。次のライブラリは、macOS と Linux と互換性がありますが、他のプラットフォームとは互換性がありません。

cc_library(
    name = "unixish_lib",
    srcs = ["unixish_lib.cc"],
    target_compatible_with = select({
        "@platforms//os:osx": [],
        "@platforms//os:linux": [],
        "//conditions:default": ["@platforms//:incompatible"],
    }),
)

上記は次のように解釈できます。

  1. macOS をターゲットに設定する場合、ターゲットに制約はありません。
  2. Linux をターゲットとする場合は、ターゲットに制約はありません。
  3. それ以外の場合、ターゲットには @platforms//:incompatible 制約があります。@platforms//:incompatible はどのプラットフォームの一部でもないため、ターゲットは互換性がないものと見なされます。

制約を読みやすくするには、skylibselects.with_or() を使用します。

逆の互換性も同様の方法で表現できます。次の例は、ARM を除くすべてのプラットフォームと互換性のあるライブラリを示しています。

cc_library(
    name = "non_arm_lib",
    srcs = ["non_arm_lib.cc"],
    target_compatible_with = select({
        "@platforms//cpu:arm": ["@platforms//:incompatible"],
        "//conditions:default": [],
    }),
)

bazel cquery を使用して互換性のないターゲットを検出する

bazel cqueryStarlark 出力形式IncompatiblePlatformProvider を使用すると、互換性のないターゲットと互換性のあるターゲットを区別できます。

これを使用して、互換性のないターゲットを除外できます。次の例では、互換性のあるターゲットのラベルのみが出力されます。互換性のないターゲットは印刷されません。

$ cat example.cquery

def format(target):
  if "IncompatiblePlatformProvider" not in providers(target):
    return target.label
  return ""


$ bazel cquery //... --output=starlark --starlark:file=example.cquery

既知の問題

互換性のないターゲットは公開制限を無視します。