クライアントとサーバーの実装

Bazel システムは、長時間実行されるサーバー プロセスとして実装されています。これにより、BUILD ファイル、依存関係グラフ、その他のメタデータを 1 つのビルドから次のビルドにキャッシュするなど、バッチ指向の実装では不可能な多くの最適化を実行できます。これにより、増分ビルドの速度が向上し、buildquery などのさまざまなコマンドで、読み込まれたパッケージの同じキャッシュを共有できるため、クエリが非常に高速になります。

bazel を実行すると、クライアントが実行されます。クライアントは、出力ベースに基づいてサーバーを検索します。出力ベースはデフォルトで、ベース ワークスペース ディレクトリのパスとユーザー ID によって決まります。そのため、複数のワークスペースでビルドする場合は、複数の出力ベースが存在し、複数の Bazel サーバー プロセスが存在することになります。 同じワークステーション上の複数のユーザーは、出力ベースが異なる(ユーザー ID が異なる)ため、同じワークスペースで同時にビルドできます。

実行中のサーバー インスタンスが見つからない場合、クライアントは新しいインスタンスを起動します。これは、出力ベースがすでに存在するかどうかを確認することで行われます。出力ベースが存在する場合は、blaze アーカイブがすでに展開されていることを意味します。出力ベースが存在しない場合、クライアントはアーカイブのファイルを解凍し、mtime を 9 年後の日付に設定します。インストールが完了すると、クライアントは解凍されたファイルの mtime が遠い日付と等しいことを確認し、インストールが改ざんされていないことを確認します。

サーバー プロセスは、一定期間操作がないと停止します(デフォルトでは 3 時間。起動オプション --max_idle_secs を使用して変更できます)。ほとんどの場合、サーバーが実行されていることはユーザーにはわかりませんが、覚えておくと役立つことがあります。たとえば、さまざまなディレクトリで多くの自動ビルドを実行するスクリプトを実行している場合は、アイドル状態のサーバーが大量に蓄積されないようにすることが重要です。これを行うには、使用が完了したら明示的にシャットダウンするか、短いタイムアウト期間を指定します。

Bazel サーバー プロセスの名前は、ps x または ps -e f の出力に bazel(dirname) として表示されます。ここで、dirname は、ワークスペース ディレクトリのルートを囲む ディレクトリのベース名です。次に例を示します。

ps -e f
16143 ?        Sl     3:00 bazel(src-johndoe2) -server -Djava.library.path=...

これにより、特定のワークスペースに属するサーバー プロセスを簡単に確認できます。(psの他のオプションによっては、Bazel サーバー プロセスに javaという名前が付けられることがあります)。Bazel サーバーは、 シャットダウン コマンドを使用して停止できます。

bazel を実行すると、クライアントはまずサーバーが適切なバージョンであることを確認します。そうでない場合は、サーバーが停止し、新しいサーバーが起動します。これにより、長時間実行されるサーバー プロセスを使用しても、適切なバージョン管理が妨げられることはありません。