Bazel は、ワークスペースと呼ばれるディレクトリ ツリーに編成されたソースコードからソフトウェアをビルドします。ワークスペース内のソースファイルは、パッケージのネストされた階層に編成されます。各パッケージは、関連するソースファイルのセトと 1 つの BUILD ファイルを含むディレクトリです。BUILD ファイルには、ソースからビルドできるソフトウェア出力を指定します。
ワークスペース
ワークスペースは、ビルドするソフトウェアのソースファイルを含むファイル システム上のディレクトリ ツリーです。各ワークスペースには WORKSPACE という名前のテキスト ファイルがあります。このファイルは空でもかまいません。また、出力のビルドに必要な外部依存関係への参照が含まれていることもあります。
WORKSPACE という名前のファイルを含むディレクトリは、ワークスペースのルートと見なされます。したがって、WORKSPACE ファイルを含むサブディレクトリをルートとするワークスペース内のディレクトリ ツリーは、別のワークスペースを形成するため、Bazel では無視されます。
Bazel では、WORKSPACE ファイルのエイリアスとして WORKSPACE.bazel ファイルもサポートされています。両方のファイルが存在する場合は、WORKSPACE.bazel が使用されます。
リポジトリ
コードはリポジトリに整理されます。WORKSPACE ファイルを含むディレクトリは、メイン リポジトリのルート（@ とも呼ばれます）です。その他の（外部）リポジトリは、ワークスペース ルールを使用して WORKSPACE ファイルで定義されます。
Bazel にバンドルされているワークスペース ルールについては、ビルド百科全書のワークスペース ルールのセクションと、埋め込み Starlark リポジトリ ルールのドキュメントをご覧ください。
外部リポジトリ自体がリポジトリであるため、多くの場合、WORKSPACE ファイルも含まれています。ただし、これらの追加の WORKSPACE ファイルは Bazel によって無視されます。特に、転送依存のリポジトリは自動的に追加されません。
パッケージ
リポジトリ内のコード編成の主要な単位はパッケージです。パッケージは、関連するファイルのコレクションと、出力アーティファクトの生成に使用できる方法の仕様です。
パッケージは、BUILD（または BUILD.bazel）という名前のファイルを含むディレクトリとして定義されます。パッケージには、そのディレクトリ内のすべてのファイルと、その下に存在するすべてのサブディレクトリが含まれます（ただし、それ自体に BUILD ファイルが含まれているものは除きます）。この定義から、ファイルまたはディレクトリが 2 つの異なるパッケージに属することはできません。
たとえば、次のディレクトリ ツリーには、2 つのパッケージ（my/app とサブパッケージ my/app/tests）があります。my/app/data はパッケージではなく、パッケージ my/app に属するディレクトリです。
src/my/app/BUILD
src/my/app/app.cc
src/my/app/data/input.txt
src/my/app/tests/BUILD
src/my/app/tests/test.cc
ターゲット
パッケージは、パッケージの BUILD ファイルで定義されるターゲットのコンテナです。ほとんどのターゲットは、ファイルとルールの 2 つの主な種類のいずれかです。
ファイルはさらに 2 種類に分類されます。通常、ソースファイルは人間の手によって作成され、リポジトリにチェックインされます。生成ファイル（派生ファイルまたは出力ファイルとも呼ばれます）はチェックインされず、ソースファイルから生成されます。
2 つ目のターゲットは、ルールで宣言します。各ルール インスタンスは、一連の入力ファイルと一連の出力ファイルの関係を指定します。ルールへの入力はソースファイルですが、他のルールの出力でもかまいません。
ルールへの入力がソースファイルか生成ファイルかは、ほとんどの場合重要ではありません。重要なのは、そのファイルの内容のみです。このため、複雑なソースファイルをルールによって生成されたファイルに簡単に置き換えることができます。たとえば、高度に構造化されたファイルを手動で維持する負担が大きくなり、そのファイルを派生させるプログラムを作成する場合などです。そのファイルのコンシューマに変更を加える必要はありません。逆に、生成されたファイルは、ローカルでのみ変更されたソースファイルに簡単に置き換えることができます。
ルールへの入力には、他のルールを含めることもできます。このような関係の正確な意味は、多くの場合非常に複雑で、言語やルールに依存しますが、直感的には単純です。C++ ライブラリ ルール A には、入力用の別の C++ ライブラリ ルール B がある場合があります。この依存関係の影響は、コンパイル時に A が B のヘッダー ファイルにアクセスできること、リンク時に A が B のシンボルにアクセスできること、実行時に A が B のランタイム データにアクセスできることです。
すべてのルールの不変条件は、ルールによって生成されたファイルが常にルール自体と同じパッケージに属することです。別のパッケージにファイルを生成することはできません。ただし、ルールの入力が別のパッケージから取得されることは珍しくありません。
パッケージ グループは、特定のルールへのアクセスを制限することを目的としたパッケージのセットです。パッケージ グループは package_group 関数で定義されます。パッケージ グループには、含まれるパッケージのリスト、名前、他のパッケージ グループの 3 つのプロパティがあります。これらのファイルを参照できるのは、ルールの visibility 属性または package 関数の default_visibility 属性からのみです。ファイルは生成または使用されません。詳細については、package_group のドキュメントをご覧ください。