一般的な定義

ラベルのリスト。デフォルトは [] です

実行時にこのルールで必要なファイル。ファイルまたはルールのターゲットをリストできます。一般 任意のターゲットを許可します。

data 属性内のターゲットのデフォルトの出力と実行ファイル 作成された実行可能ファイルの *.runfiles 領域に表示されるはずです。 またはこのターゲットとランタイム依存関係があります。これにはデータが含まれる場合があります ファイルまたはバイナリが、このターゲットの srcs が実行される。データファイルに依存して使用する方法については、データの依存関係のセクションをご覧ください。

新しいルールで data 属性を処理する場合は、そのルールで 実行時に他の入力を使用する可能性のある入力です。ルール実装関数 また、ターゲットの IP アドレスに runfile を任意の data 属性の出力と runfile から追加する 任意の依存関係属性からのランファイルも指定できます。 依存関係が存在します。

ラベルのリスト。デフォルトは [] です

このターゲットの依存関係。通常は、ルールのターゲットのみを含めます。（ただし、 一部のルールでは、deps にファイルを直接リストすることが許可されます。 避けるべきです）。

通常、言語固有のルールにより、リストされるターゲットは、 特定のプロバイダ

ターゲットが、Cloud KMS を使用して別のリソースに依存することの意味の正確なセマンティクスは、 deps はルールの種類に固有で、ルールに固有の ドキュメントをご覧ください。ソースコードを処理するルールの場合 deps は通常、Java 内のコードで使用されるコード依存関係を指定します。 srcs。

ほとんどの場合、deps 依存関係は、1 つのモジュールで 同じプログラミング言語で記述された別のモジュールで定義されているシンボルと、 個別にコンパイルします。言語をまたぐ依存関係も、多くの言語や たとえば、java_library ターゲットが C++ コードに依存する場合があります。 後者を cc_library ターゲットにリストすることで、 deps 属性。定義を表示 dependencies をご覧ください。

文字列のリスト。構成不可。デフォルトは ["none"] です。

この特定のターゲットに使用されるライセンス タイプの文字列のリスト。 これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。すべきでないこと 使用します。

ラベルのリスト。デフォルトは [] です

このルールによって処理または追加されたファイル。通常はファイルを直接リストしますが、デフォルト出力を含めるようにルール ターゲット（filegroup や genrule など）をリストすることもできます。

言語固有のルールでは、リスト内のファイルに特定のファイル拡張子が必要になることがよくあります。

ラベルのリスト。 構成不可デフォルトは []

以下に加えて、このターゲットを構築できる環境のリスト 環境に依存しています。

これは Bazel の制約システムの一部です。これにより、ユーザーはどの Pod が ターゲット同士の相互依存が可能です。たとえば、外部にデプロイ可能な バイナリは、企業秘密のコードを含むライブラリに依存すべきではありません。詳しくは、 ConstraintSemantics をご覧ください。

文字列。構成不可。デフォルトは None です。

このターゲットに関連付けられている、説明付きの警告メッセージ。 通常これは、ターゲットが古くなったことをユーザーに知らせるために使用されます。 別のルールに置き換わっている、特定のパッケージに限定公開されている なんらかの理由で有害と判断されます名前は、 ウェブページ、バグ番号、移行 CL の例などの参照情報を メッセージを回避するために必要な変更を簡単に確認できます。 交換の減少として使用できる新しい目標がある場合、それは 古いターゲットのすべてのユーザーを移行することをおすすめします

この属性はビルド方法には影響しませんが、 ビルドツールの診断出力に影響することがあります。ビルドツールは deprecation 属性を含むルールが 別のパッケージ内のターゲットに依存します。

パッケージ内の依存関係は、この警告の対象外です。たとえば、非推奨のルールのテストビルドで警告が発生することはありません。

非推奨のターゲットが別の非推奨のターゲットに依存している場合、警告は表示されません。 メッセージが発行されます。

ユーザーが使用をやめると、ターゲットを削除できます。

文字列のリスト。設定不可 デフォルトは [] です

この特定のターゲットに使用される分散方法文字列のリスト。 これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。すべきでないこと 使用します。

ラベルのリスト。 構成不可デフォルトは []

このターゲットの実行プラットフォームに存在する必要がある constraint_values のリスト。場所: ルールタイプによってすでに設定されている制約への追加が可能です。制約は 使用可能な実行プラットフォームのリストを制限します。詳しくは、 説明 ツールチェーンの解決。

文字列の辞書デフォルトは {} です。

このターゲットに対して選択されたプラットフォームの exec_properties に追加される文字列の辞書。platform ルールの exec_properties をご覧ください。

キーがプラットフォーム レベルとターゲット レベルのプロパティの両方に存在する場合、値はターゲットから取得されます。

feature 文字列のリストデフォルトは [] です

機能とは、ターゲットで有効または無効にできる文字列タグです。「 対象物の意味はルール自体によって異なります。

この features 属性は、 パッケージ レベルの features 属性。たとえば パッケージ レベルで機能 ["a", "b"] が有効になっており、ターゲットの features 属性には、["-a", "c"]、つまり ルールが「b」になります。あります。 例をご覧ください。

ラベルのリスト。 構成不可デフォルトは []

代わりにこのターゲットを構築できる環境のリスト 環境に依存しています。

これは、Bazel の制約システムの一部です。詳しくは、 compatible_with をご覧ください。

文字列のリスト。構成不可。デフォルトは [] です。

タグは任意のルールで使用できます。テストと検証のタグ test_suite ルールはテストを分類するのに役立ちます。 テスト以外のターゲットのタグを使用して、以下のプロダクトのサンドボックス化された実行を制御します。 genrule 秒と Starlark 人間による解析や外部ツールによる解析に使用されます。

Bazel は次の場合にサンドボックス コードの動作を変更します。 任意のテストまたは genrule の tags 属性内のキーワード ターゲット、または任意の Starlark の execution_requirements のキー できます。

• no-sandbox キーワードの場合、アクションまたはテストは実行されない サンドボックス化引き続きキャッシュに保存することも、リモートで実行することもできます。no-cache を使用してください。 このいずれかまたは両方を防ぐには、no-remote を設定します。
• no-cache キーワードの場合、アクションまたはテストは実行されない キャッシュ（リモートまたはローカル）
• no-remote-cache キーワードの場合、アクションまたはテストは実行されない リモートでキャッシュされる（ただし、ローカルにキャッシュすることも、リモートで実行することも可能）。 注: このタグでは、ディスク キャッシュはローカル キャッシュと見なされますが、 HTTP キャッシュと gRPC キャッシュはリモートとみなされます ローカル ディスク キャッシュとリモート キャッシュを組み合わせて使用する場合（組み合わせキャッシュ）、 リモート キャッシュとして扱われ、--incompatible_remote_results_ignore_disk でない限り完全に無効になります。 が設定されている場合は、ローカル コンポーネントが使用されます。
• no-remote-exec キーワードの場合、アクションまたはテストは実行されない リモートで実行される（ただし、リモートにキャッシュされる可能性がある）
• no-remote キーワードを使用すると、アクションやテストがリモートで実行されたり、リモートでキャッシュに保存されたりするのを防ぐことができます。これは、両方のノードを使用するのと no-remote-cache と no-remote-exec。
• no-remote-cache-upload キーワードは、spawn のリモート キャッシュの一部のアップロードを無効にします。 リモート実行が無効になることはありません。
• local キーワードにより、アクションまたはテストがリモート キャッシュから排除される。 サンドボックス内で実行することもできます。 genrule とテストの場合、local = True 属性でルールをマークしても同じ効果があります。
• requires-network キーワードを使用すると、外部リソースへのアクセスを サンドボックスから保護します。このタグはサンドボックス化されている場合にのみ 有効になります。
• block-network キーワードにより、外部へのアクセスがブロックされます。 サンドボックスから保護します。ここでは通信のみが 許可されています。このタグは、サンドボックスが有効な場合にのみ効果があります。
• requires-fakeroot は、テストまたはアクションを uid および gid 0（つまり、 できます。これは Linux でのみサポートされています。このタグは --sandbox_fake_username コマンドライン オプション。

テストのタグは通常、テストにおける役割にアノテーションを付けるために使用されます。 デバッグとリリースのプロセスを使用します通常、タグは、ランタイム アノテーション機能がない C++ テストと Python テストに最も役立ちます。タグとサイズ要素を使用すると、コードベースのチェックイン ポリシーに基づいてテストスイートを柔軟に組み立てることができます。

Bazel は、 テストルールの tags 属性:

• exclusive は、強制的にテストを実行します。 「排他的」他のテストが実行されていないことを確認します。 できます。このようなテストは、すべてのビルド後に順番に実行されます アクティビティと非独占的なテストが完了しました。リモート実行は、 Bazel はテストで何を制御するかは制御できないため、このようなテストでは リモートマシン上で実行されています
• exclusive-if-local は、強制的にテストを実行します。 「排他的」ローカルで実行する場合はモードになりますが、ローカルで実行している場合はテストを並行して実行します。 実行することもできます。
• manual キーワードを使用すると、build、test、coverage コマンドに対してビルドまたは実行するトップレベル ターゲットのセットを計算するときに、ターゲット パターンのワイルドカード（...、:*、:all など）と、テストを明示的にリストしない test_suite ルールの展開からターゲットが除外されます。残念ながら、 他のコンテキストでは、ターゲット ワイルドカードやテストスイートの拡張に query コマンドを使用します。なお、manual は、ターゲットを 継続的なビルド/テストシステムで自動的にビルド/実行されない。たとえば、 特定のターゲットが必要なため、bazel test ... からターゲットを除外することが推奨されます。 Bazel フラグだが、適切に構成された presubmit または継続的テストに含まれている 実行されます
• external キーワードを指定すると、強制的にテストが無条件に行われます 実行（--cache_test_results に関係なく） あります。

ラベルのリスト。デフォルトは [] です

リスト constraint_values 必須フィールドです。 互換性。これは、 選択します。ターゲット プラットフォームがリストされている制約をすべて満たしていない場合、 ターゲットは互換性がないと見なされます。互換性のないターゲットは ターゲット パターンが拡張されたときにビルドとテストではスキップされます （例: //...、:all）。Deployment で明示的に 互換性のないターゲットが原因で Bazel がエラーを出力し、 失敗します。

互換性のないターゲットに推移的に依存するターゲット自体 互換性がないと見なされますまた、ビルドとテストでもスキップされます。

空のリスト（デフォルト）は、ターゲットに互換性があることを示します。 すべてのプラットフォームに対応します

Workspace ルール以外のすべてのルールでサポートされています。 属性です。 一部のルールでは、この属性は効果がありません。たとえば、 target_compatible_with: cc_toolchain は役に立ちません。

詳しくは、 プラットフォーム 互換性のないターゲットのスキップに関する詳細をご覧ください。

ブール値設定不可デフォルトは False です （テストスイートとテストスイート ターゲットを除く）

True の場合、このターゲットに依存できるのは、testonly ターゲット（テストなど）のみです。

同様に、testonly 以外のルールの場合、 testonly のルールに依存します。

テスト（*_test 個のルール） およびテストスイート（test_suite ルール） デフォルトは testonly です。

この属性は、ターゲットを バイナリに含まれているファイルです。

testonly は実行時ではなくビルド時に適用され、伝播するため 依存関係ツリーで拡散している場合は、慎重に適用する必要があります。対象 偽のスタブやフェイクなど、 単体テストや統合テストにも役立つ 本番環境にリリースされるのと同じバイナリが関係する testonly とマークすべきではありません。これとは逆に、 リンクさえも危険です 通常の動作をオーバーライドする場合は、必ず testonly とマークしてください。

ラベルのリスト。 構成不可デフォルトは []

このターゲットの [Make 変数] が、 許可します。これらのターゲットは、特定のリソースへの TemplateVariableInfo、または Bazel に組み込まれているツールチェーン タイプの特別なターゲット。これらの 含める:

• @bazel_tools//tools/cpp:current_cc_toolchain
• @bazel_tools//tools/jdk:current_java_runtime

これは、Terraform の概念は ツールチェーンの解決 これは、プラットフォームに依存する設定のルール実装で使用されます。これは使用できません。 特定の cc_toolchain または java_toolchain を決定する属性を 使用されます。

ラベルのリスト。 構成不可 デフォルトは default_visibility で、 package（指定した場合）、または "//visibility:private"

ターゲットの visibility 属性は、ターゲットを他のパッケージで使用できるかどうかを制御します。公開設定のドキュメントをご覧ください。

文字列のリスト。条件 $(location) と [変数を作成] で置換する Bourne Shell のトークン化:デフォルトは [] です

Bazel がターゲットに渡すコマンドライン引数 bazel test で実行されます。

これらの引数は、bazel test コマンドラインで指定された --test_arg 値の前に渡されます。

文字列の辞書適用される $(location) と 「変数を作成」デフォルトは []

テストの実行時に設定する追加の環境変数を指定します。 bazel test。

この属性は、cc_test などのネイティブ ルールにのみ適用されます。 py_test、sh_test。適用対象外 Starlark が定義したテストルール。独自の Starlark ルールの場合は、環境変数に「env」と その属性を使用して TestEnvironment 。

文字列のリスト。デフォルトは [] です。

プロジェクトから継承する追加の環境変数を bazel test がテストを実行したときの外部環境。

この属性は、cc_test、py_test、sh_test などのネイティブ ルールにのみ適用されます。Starlark で定義されたテストルールには適用されません。

文字列 "enormous"、"large"、"medium"、または "small";構成不可、 デフォルトは "medium" です

テスト ターゲットの「重さ」、つまり実行に必要な時間/リソースを指定します。

単体テストは「小規模」、統合テストは「中」、エンドツーエンド テストは「大規模」と見なされますまたは 「enormous」です。Bazel はこのサイズを使用してデフォルトのタイムアウトを決定します。デフォルトのタイムアウトは timeout 属性。タイムアウトは、個々のテストではなく、BUILD ターゲットのすべてのテストに適用されます。テストをローカルで実行する場合、さらに size が次の目的で使用されます。 Bazel は --local_{ram,cpu}_resources を尊重しようとしますが、 大量のテストを同時に実行してローカルマシンに負荷をかけます。

テストサイズは、以下のデフォルトのタイムアウトと想定されるピーク ローカル リソースに対応します。 用途:

環境変数 TEST_SIZE は、 値を指定する必要があります。

文字列 "short"、"moderate"、"long"、または "eternal";構成不可、デフォルトは テストの size 属性から

テストが完了するまでに予想される時間。

テストのサイズ属性はリソースの見積もりを制御しますが、テストのサイズ属性はリソースの見積もりを 個別に設定できます。明示的に指定しない場合、 タイムアウトはテストサイズに基づきます。テスト タイムアウトは --test_timeout フラグでオーバーライドできます。次に例を示します。 特定の状況下で動作することは 遅くなりますテストのタイムアウト値 次の期間に対応します。

上記以外の時間では、テストのタイムアウトは --test_timeout bazel フラグ。例:手動で実行する場合の 予測します。--test_timeout 値 秒単位です。たとえば、--test_timeout=120 はテストを設定します。 2 分にタイムアウトします

環境変数 TEST_TIMEOUT は、テストの生成時にテストのタイムアウト（秒単位）に設定されます。

ブール値設定不可 デフォルトは False です

テストを「不安定」としてマークします。

設定すると、テストが 3 回まで実行され、失敗した場合にのみ不合格としてマークされます 失敗します。デフォルトでは、この属性は False に設定され、テストは 1 回だけ実行されます。なお、この属性は、通常は使用しないことをおすすめします。 テストは、アサーションが維持されていれば、確実に合格する必要があります。

50 以下の正の整数。デフォルトは -1 です。

並列シャードの数を指定します 使用できます。

設定した場合、この値は、インプレッションの数を決めるために使用される テスト実行に使用する並列シャードを指定します一部のテストでは このパラメータは、シャーディングの有効化に あります。--test_sharding_strategy もご覧ください。

テスト シャーディングが有効になっている場合、テストのスポーン時に環境変数 TEST_TOTAL_SHARDS がこの値に設定されます。

シャーディングを行うには、テストランナーがテストのシャーディング プロトコルをサポートしている必要があります。 そうでない場合は、すべてのシャードですべてのテストが実行される可能性が高いため、 意図したものではありません。

詳しくは、 テストのシャーディング をご覧ください。

ブール値設定不可 デフォルトは False です

テストをサンドボックス化せずにローカルで強制的に実行します。

True に設定すると、「local」を指定するのと同じ結果になります。タグとして (tags=["local"]).

文字列のリスト。$(location) と 「変数を作成」の置換、Bourne シェルのトークン化の対象。構成不可。デフォルトは []。

Bazel の実行時にターゲットに渡すコマンドライン引数 run コマンドで指定するか、テストとして指定します。これらの引数は、 bazel run で指定されたものよりも前に渡されます。 bazel test コマンドライン。

注: ターゲットの実行時に引数は渡されません。 Bazel 以外（たとえば、Terraform でバイナリを手動で実行する、 bazel-bin/）。

文字列の辞書適用される $(location) と 「変数を作成」デフォルトは {}

ターゲットの作成時に設定する追加の環境変数を指定します。 bazel run が実行します。

この属性はネイティブ ルール（cc_binary、py_binary、 および sh_binary。Starlark で定義されている実行可能ファイルには適用されません。

注: Bazel の外部でターゲットを実行する場合（bazel-bin/ でバイナリを手動で実行する場合など）は、環境変数は設定されません。

文字列のリスト。デフォルトは [] です。

このバイナリが生成する出力ファイルのライセンス。 これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。すべきでないこと 使用します。