差分ビルド

​

概要

デフォルトでは、すべてのスナップショットのビルドは フルビルド です。クリーンなベースイメージから開始し、すべてのリポジトリをクローンして、すべてのブループリントを毎回最初から実行します。これにより、環境を完全に再現可能にできますが、多数あるブループリントのうち 1 つだけを変更した場合でも時間がかかることがあります。 差分ビルド は、前回成功したビルドのスナップショットを開始点として再利用することで、これを最適化します。実際にブループリントが変更されたワークスペースだけを再ビルドし、変更されていないワークスペースは親ビルドからそのまま引き継ぎます。これにより、特に多数のリポジトリを持つ組織では、ビルド時間を大幅に短縮できます。

​

差分ビルドを有効にする

​

仕組み

差分ビルドを有効にした状態でビルドがトリガーされると、システムは次の手順で処理を行います:

​

1. 親ビルドを見つける

システムは、同じプラットフォームおよびマシン構成のスナップショットイメージを持ち、親として利用できる直近の成功ビルド (status が success または partial) を探します。条件を満たす親がない場合、ビルドは自動的にフルビルドに切り替わります。

​

2. ブループリントを比較する

各ワークスペースの構成は親ビルドと比較されます。システムは、ブループリントの内容、アタッチされたファイル、シークレットなどを含む各ワークスペースの入力のダイジェストを計算し、変更点を確認します。

​

3. ワークスペースのアクションを割り当てる

比較結果に基づいて、各ワークスペースには次の 3 つのアクションのいずれかが割り当てられます。

​

4. ビルドを実行する

このビルドはクリーンなベースではなく、親ビルドのスナップショットイメージを基に開始されます。つまり、次のようになります。

• 継承されたワークスペース では、必要なツール、ランタイム、依存関係はすでにインストールされています。システムは最新のコードを取得し (git pull) 、依存関係を更新するために maintenance コマンドを実行します。
• 再ビルドされるワークスペース は最初からセットアップされ、新たにクローンされたうえで、initialize + maintenance の一連の処理がすべて実行されます。
• 削除されたワークスペース では、対応するディレクトリがクリーンアップされます。

組織ブループリントとEnterpriseブループリントでは、差分ビルド中は initialize をスキップし (それらのツールはすでに親イメージに含まれているため) 、maintenance のみを実行します。

​

代わりにフルビルドが実行される場合

差分ビルドを有効にしていても、以下の状況ではビルドはフルビルドとして実行されます。

• フルビルドを明示的に要求した場合 — Build snapshot ドロップダウンから Full build を選択した場合
• 最新のフルビルドが古すぎる場合 — ブループリントの保存などでトリガーされる自動ビルドは、そのプラットフォームにフルビルドが存在しない場合、または最新のフルビルドが Settings > Environment > Advanced の Full build refresh 間隔 (デフォルトは7日ごと) より古い場合、フルビルドとして実行されます
• 再利用可能な親ビルドが存在しない場合 — 同じプラットフォームおよびマシン構成で、スナップショットイメージを持つ success または partial のビルドが存在しない場合
• 親ビルドに互換性がない場合 — 親ビルド以降にプラットフォーム、マシン構成、ベースイメージ、または Clone repositories on all platforms の設定が変更された場合、あるいは親ビルドに比較対象となるシークレットのベースラインがない場合
• 組織またはenterpriseの設定が変更された場合 — 親ビルド以降に組織またはenterpriseのブループリント、ブループリントファイル、シークレットが変更された場合

個々のリポジトリに限定された変更であれば、ビルドは差分ビルドのまま維持されます。新しいリポジトリ、リポジトリ単位のブループリントやシークレットの変更、親ビルドで失敗したリポジトリは、差分ビルドの中で再ビルドされます。リポジトリの並び替えではフルビルドはトリガーされません。 差分ビルドとして要求したビルドが代わりにフルビルドとして実行された場合、その理由はビルド詳細ページの Build kind ツールチップに表示されます。

​

build の種類を確認する

build が完了すると、それが differential build と full build のどちらとして実行されたかを確認できます。

1. Settings > Environment > Snapshots に移動します
2. 履歴内の build をクリックします
3. Build kind バッジに Differential (青) または Full build (デフォルト) が表示されます

バッジにカーソルを合わせると、各種類の意味を説明するツールチップが表示されます。

• Differential: 「変更されたワークスペースのみが再ビルドされ、変更されていないものは同じ設定で最後に成功した build から引き継がれます」
• Full build: 「すべてのワークスペースが最初からビルドされます」

​

利点

​

フルビルドを手動でトリガーする

差分ビルドが有効になっている場合でも、Build snapshotボタンからフルビルドを強制できます。ドロップダウンで、デフォルトの差分オプションではなくFull buildを選択してください。 継承された状態を破棄し、ブループリントで引き続き環境をゼロから作成できることを確認するため、定期的にフルビルドを実行することを推奨します。また、スナップショット内に滞留したファイル、ツール、依存関係が残っている可能性のあるセットアップを削除または置き換えた後にも実行してください。フルビルドでは、すべてのinitializeステップとmaintenanceステップが再実行されます。

​

よくある質問