スナップショットの依存関係

適切なビルド

スナップショット依存関係に関して、適切なビルドとは、ビルドチェーン内のキューに入れられた依存関係ビルドの代わりに使用できるビルドです。つまり、ビルドチェーンの一部であるキューに入れられたビルドは削除でき、それに依存するビルドは、キューに入れられた、実行中の、すでに完了した別の「適切な」ビルドに依存させることができます。この動作は、対応するスナップショット依存関係の「適切なものがあれば、新しいビルドを実行しないでください」オプションが有効になっている場合にのみ機能します。

ビルドが「適切」であるとみなされるには、次のすべての条件を満たしている必要があります。

• 同じブランチまたはデフォルトのブランチに属している必要があります。

• 処理中のキュービルドチェーン全体として同じ情報源のスナップショットを使用する必要があります。ビルド構成の VCS 設定が同じ場合、これは同じ情報源の改訂を意味します。VCS 設定が異なる場合 (VCS ルートまたはチェックアウトルール)、これはある時点で同時に取得されたリビジョンを意味します。

• 成功する必要があります (「適切なビルドから成功したビルドのみを使用する」スナップショット依存関係オプションが有効になっている場合)。

• それは個人的なビルドではなく、通常のビルドである必要があります。

• reverse.dep. パラメーター（関連機能要求: TW-23700(英語)）を介して設定されたパラメーターを含め、カスタマイズされたパラメーターがあってはなりません。

• 元のビルドは、依存関係ビルド構成の「再ビルド」アクションによってトリガーされてはなりません。

• 有効なリビジョン計算を妨げる VCS 設定があってはなりません。詳細については、こちらを参照してください。

• 「適切なものがあれば、新しいビルドを実行しないでください」オプションが無効になっている現在のビルド構成スナップショットに依存する他のビルド構成スナップショットはありません。

• 実行中のビルドは「ハング」していません。

• ビルド構成の設定は、ビルド以降変更されていません（つまり、ビルドは現在のビルド構成設定で実行されました）。これには、ビルド構成のすべての親プロジェクトのパラメーターへの変更も含まれません。隠されたビルドのアーティファクトの .teamcity/settings/digest.txt ファイルを比較することで、複数のビルド間で設定が変更されたかどうかを確認できます。

• スナップショットの依存関係に加えてアーティファクトの依存関係も存在する場合、適切なビルドにはアーティファクトが含まれている必要があります。それ以外の場合は、公開されたアーティファクトを含まないビルドと、クリーンアップ中にアーティファクトが削除されたビルドのどちらも同様に適しています。

• すべての依存関係ビルド (現在のビルドが依存するビルド) は「適切」であり、適切にマージされます。

アップストリームチェーンビルドでの並列テスト

常に新しいビルドを実行するの動作 ( スナップショット依存関係の 適切なものがあれば、新しいビルドを実行しないでください設定が無効) は、メイン構成ビルドにのみ影響します。並列テスト機能の使用時に動的に生成される仮想ビルド構成では、以前の結果が再利用される可能性があります。新しいリポジトリコミットが検出されなかった場合、以前に失敗したテストバッチのみが新しいビルドを実行し、成功したバッチは再利用されます。

下の図では、「Composite Conf」構成は「Maven App」構成に依存しています。後者は、2 つの並列バッチでテストを実行します。メインの「Maven app」ビルド #18 は新たにトリガーされますが、動的に生成された「Maven app 1」構成は、以前の成功したビルド (#12) を再利用することに注意してください。

TeamCity にすべての仮想構成ビルドを強制的に再実行させることができます。この場合、新しいリポジトリコミットが見つからなくても、個々のテストバッチはすべて新たに実行されます。

これを行うには、並列テスト機能を含む構成に teamcity.internal.splitBuild.dependency.takeStartedBuildWithSameRevisions=false パラメーターを追加します。

この動作をサーバー上のすべての構成に適用するには、このパラメーターを内部プロパティリストに追加します。