TeamCity 2020.1ヘルプ

コンポジット・ビルド構成

TeamCity provides the composite type of build configuration.

The purpose of the composite build configuration is to aggregate results from several other builds combined by snapshot dependencies and present them in a single place. To some extent, a composite build can be viewed as a build which consists of several parts which can be executed in parallel on different agents. All these parts will have a synchronized snapshot of the source code, and the results can be seen in a single place.

複合構成の作成

ビルド構成を作成するときに、そのタイプとしてコンポジットを指定し、そのスナップショットの依存関係を指定できます。ビルドの結果、現在のコンポジットが生成されるビルド構成

スナップショットに依存するコンポジットビルドと通常のビルドの間には重要な違いがあります。

  • 複合ビルドはエージェントを占有しません。その結果、エージェントを必要とする一部の設定(ビルド手順や要件など)は適用されません。

  • 複合ビルドは、依存関係の数に関係なく、単一のビルドとして機能することがよくあります。
    • 複合ビルドは、ビルドチェーンの最初の依存関係が開始された時点で実行中として表示され、最後の依存関係が終了した場合にのみ終了として表示されます。

    • 複合ビルドが停止またはキューから削除されると、そのすべての依存関係、つまりビルドチェーン全体も同様に停止/削除されます。

    • 実行中のコンポジットビルドの数を制限することは可能ですが、コンポジットビルドの場合はビルドとそのすべての依存関係に影響します。制限が1に設定され、コンポジットビルドが既に実行中の場合現在の依存関係が終了するまで、依存関係はキュー内で待機します。

    • 複合ビルドは、依存関係(たとえば、すべてのテスト)の結果を集約し、単一の場所でチェーンのすべての失敗/ミュートまたは無視されたテストを表示します。これは、コードカバレッジまたはコードインスペクション /コード重複分析の結果にも当てはまります。

    • コンポジットビルドのステータス行は、現在のチェーンの状態、実行中/キュー/完了または失敗した依存関係の数を反映しています。

    • 複合ビルドの進行状況インジケーターは、すべての依存関係を反映しているため、チェーン全体がいつ終了するかを実際に示します。

  • 複合ビルドには独自の成果物はありません。ただし、成果物の依存関係を介して、その部分(依存関係)によって公開された成果物を表示するようにすることができます。

コンポジットビルドアーティファクトのクリーンアップ

コンポジットビルドは、そのパーツによってアーティファクト依存関係を介して公開されたアーティファクトのみを表示します。つまり、コンポジットビルドは独自のアーティファクトを持ちません(内部アーティファクトを除く)。コンポジットビルドのアーティファクトに対して特定のクリーンアップポリシーを適用するには、そのすべての部分に対して同じクリーンアップルールを適用する必要があります。