実行グループ

<ph type="x-smartling-placeholder"></ph> 問題を報告する ソースを表示 夜間 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

実行グループを使用すると、1 つのターゲット内で複数の実行プラットフォームを使用できます。 各実行グループには独自のツールチェーン依存関係がある。 独自のツールチェーンの解決を実行する。

背景

実行グループを使用すると、ルール作成者はアクションのセットを定義できます。定義の際に 実行プラットフォームが異なる場合があります複数の実行プラットフォームを使用すると iOS アプリをリモート コードでコンパイルするなど、 ローカルの Mac ワーカーでリンク/コード署名を行うという方法もあります。

また、アクションのグループを定義できると、アクションの使用を アクションを指定するプロキシとして使用できます。記憶に残る表現は、必ずしも 1 つのアクションのみを参照できます。これは特に 特定のメモリに追加のリソースを割り当て、負荷の高いアクションを処理する たとえば、C++ ビルドでのリンクなど、必要性の低いタスクに過剰な割り当てを行わずに済みます。

実行グループの定義

ルールの作成中、ルール作成者はルールの定義時に 宣言 実行グループのセットですルールの作成者は、実行グループごとに その実行グループの実行プラットフォームを選択するために必要なすべてのもの、 つまり、exec_compatible_with を介した制約と、 toolchain

# foo.bzl
my_rule = rule(
    _impl,
    exec_groups = {
        link: exec_group(
            exec_compatible_with = [ "@platforms//os:linux" ]
            toolchains = ["//foo:toolchain_type"],
        ),
        test: exec_group(
            toolchains = ["//foo_tools:toolchain_type"],
        ),
    },
    attrs = {
        "_compiler": attr.label(cfg = config.exec("link"))
    },
)

上記のコード スニペットでは、ツールの依存関係も指定できます。 実行グループの移行を cfg 属性 param と config 説明します。このモジュールは、単一の文字列を受け取る exec 関数を公開します。 パラメータ。これは、依存関係が存在する実行グループの名前です。 構築しました。

ネイティブ ルールと同様に、Starlark には test 実行グループがデフォルトで存在します。 テストルールです。

実行グループの継承

独自の制約とツールチェーンを定義するだけでなく、 デフォルト実行から継承することを宣言できます。 copy_from_rule = True パラメータを渡します。このように設定すると、 copy_from_rule を true に設定し、exec_compatible_with または toolchains

デフォルトの実行グループのコピーを継承する実行グループ 実行プロパティがデフォルトから変更されます。この ターゲット レベルで設定された制約と実行プロパティが含まれる。 指定されています。言い換えれば、次のような条件です。

# foo.bzl
my_rule = rule(
    _impl,
    exec_groups = {
        copied: exec_group(
            copy_from_rule = True,
            # This will inherit exec_compatible_with and toolchains.
            # Setting them here directly would be an error, however.
        ),
    },
    toolchains = ["//foo_tools:toolchain_type"],
    exec_compatible_with = ["@platforms//os:linux"],
)

# BUILD

my_rule(
    name = "demo",
    exec_compatible_with = [":local_constraint"],
)

構成されたターゲット democopied 実行グループには、すべてが含まれます / - //fool_tools:toolchain_type - @platforms//os:linux - :local_constraint

実行グループへのアクセス

ルールの実装では、特定のデバイスでのアクションの実行を 実行プラットフォームを定義しますこれを行うには、exec_group アクション生成メソッドのパラメータ。具体的には ctx.actions.runctx.actions.run_shell

# foo.bzl
def _impl(ctx):
  ctx.actions.run(
     inputs = [ctx.attr._some_tool, ctx.srcs[0]]
     exec_group = "compile",
     # ...
  )

ルール作成者は、解決済みツールチェーンにもアクセスできます。 実行グループのロールを ターゲットの解決済みツールチェーンにアクセスできます。

# foo.bzl
def _impl(ctx):
  foo_info = ctx.exec_groups["link"].toolchains["//foo:toolchain_type"].fooinfo
  ctx.actions.run(
     inputs = [foo_info, ctx.srcs[0]]
     exec_group = "link",
     # ...
  )

実行グループを使用して実行プロパティを設定する

実行グループは exec_properties 属性で、ターゲット書き込みで特定のルールを 実行マシンに渡されるプロパティの文字列辞書。対象 たとえば、ターゲットにメモリなどのプロパティを設定し、 メモリ割り当てが多いアクションの場合は、exec_properties を作成します。 次のような実行グループ拡張キーでエントリを置き換えます。

# BUILD
my_rule(
    name = 'my_target',
    exec_properties = {
        'mem': '12g',
        'link.mem': '16g'
    }
    
)

exec_group = "link" を含むすべてのアクションに exec プロパティが表示される {"mem": "16g"} として辞書型に変換できます。ご覧のとおり、実行グループレベルの 設定はターゲット単位の設定より優先されます。

ネイティブ ルールの実行グループ

ネイティブ ルールで定義されたアクションには、次の実行グループを使用できます。

  • test: テストランナーのアクション。
  • cpp_link: C++ リンク アクション。

実行プロパティを設定する実行グループを作成する

エグゼクティブ グループを使用して、特定のアクションに異なるエグゼクティブを割り当てたい場合がある 異なるツールチェーンや制約を 適用できます。このような場合は、copy_from_rule を使用して exec グループを作成できます。 parameter:

# foo.bzl

# Creating an exec group with `copy_from_rule=True` is the same as explicitly
# setting the exec group's toolchains and constraints to the same values as the
# rule's respective parameters.
my_rule = rule(
    _impl,
    exec_compatible_with = ["@platforms//os:linux"],
    toolchains = ["//foo:toolchain_type"],
    exec_groups = {
        # The following two groups have the same toolchains and constraints:
        foo: exec_group(copy_from_rule = True),
        "bar": exec_group(
            exec_compatible_with = ["@platforms//os:linux"],
            toolchains = ["//foo:toolchain_type"],
        ),
    },
)

#

実行グループとプラットフォーム実行プロパティ

次のように、任意の実行グループに対して exec_properties を定義できます。 プラットフォーム ターゲット(ターゲットに直接設定される exec_properties とは異なり、 不明な実行グループのプロパティは拒否されます)。その後、ターゲットは デフォルトの実行グループに影響する実行プラットフォームの exec_properties その他の関連する実行グループが含まれます。

たとえば、C++ テストを実行するためにリソースが必要であり、 ただし、コンパイルとリンクには必要ありません。これは次のようにモデル化できます 次のようになります。

constraint_setting(name = "resource")
constraint_value(name = "has_resource", constraint_setting = ":resource")

platform(
    name = "platform_with_resource",
    constraint_values = [":has_resource"],
    exec_properties = {
        "test.resource": "...",
    },
)

cc_test(
    name = "my_test",
    srcs = ["my_test.cc"],
    exec_compatible_with = [":has_resource"],
)

ターゲットに直接定義された exec_properties は、ターゲットに直接定義されたものよりも優先されます。 実行プラットフォームから継承されます。