ビルド構成の依存関係
実際の CI/CD パイプラインでは、多くの場合、複数のスタンドアロンステージが組み合わされます。たとえば、「ビルド」、「テスト」、「ステージングへのデプロイ」構成 (またはジョブ) は、独立して実行することも、順番に実行することもできます。
TeamCity は、これらのスタンドアロンエンティティ間の関係を作成するための複数のオプションを提供します。
- ビルドチェーン
ビルドチェーンは、スナップショットの依存関係を使用して相互接続された、従来の TeamCity 構成の集合です。
スナップショットの依存関係は、右から左への関係です。例: 構成「B」が構成「A」に依存している「A -> B」チェーンでは、「A」が適切なビルドを最初に生成するまで「B」は実行できません。「適切な」ビルドの基準はセットアップによって異なります。詳細については、適切なビルドセクションを参照してください。同時に、「A」は新しい「B」ビルドをトリガーすることなく独立して実行できます。
ミッションクリティカルなシナリオでは、プロジェクトに最近変更がない場合でも、常に最新のアップストリーム構成ビルドを強制するように依存構成を設定できます。
- パイプライン
プロセスの各フェーズを表すジョブを使用してチェーンを構築する簡略化された代替手段です。これは、小規模で複雑でないワークフロー（ルーチン全体で約 10 ～ 15 フェーズ）に推奨されるオプションです。
ビルドチェーンにリンクされたビルド構成と比較すると、パイプラインには次の違いがあります。
リンクできるのは、同じパイプラインに属するジョブのみです。一方、ビルドチェーンを使用すると、完全に別の TeamCity プロジェクトが所有するビルド構成をリンクできます。
手動設定を必要とするスタンドアロンのアーティファクトとスナップショットの依存関係は利用できません。現在のジョブに先行するジョブを選択すると、そのすべてのアーティファクトをインポートするかどうかを即座に選択できます。
パイプラインは、依存関係に関係なくすべてのジョブを実行します。ビルドチェーンにはより多くのカスタマイズオプションがあり、部分的に実行できます。
- ビルドトリガーの終了
ビルドトリガーを終了するは左から右への関係を確立します。例: ビルドチェーンに似た「A -> B」シーケンスを作成できますが、重要な違いが 1 つあります。「B」は独立して実行できますが、新しい「A」ビルドごとに新しい「B」ビルドが自動的にトリガーされます。
完了ビルドトリガーは、ダウンストリームビルドをトリガーするためのシンプルだが柔軟性に欠ける方法を提供し、多くの場合、スナップショット依存関係によって置き換えられたり補完されたりします。
- アーティファクトの依存関係
アーティファクトの依存関係を使用すると、構成は他の構成のビルド中に生成されたファイルをインポートできます。例: 「配信」構成は、「ビルド」構成によって生成されたファイル (Docker イメージ、NuGet パッケージ、HTML ドキュメントページなど) を指定されたリソースにデプロイできます。
アーティファクト依存関係は、構成間の明示的なリンクを作成しません。つまり、両方の構成は互いのビルドをトリガーすることなく独立して実行できます。対応するスナップショット依存関係なしでアーティファクト依存関係を使用する場合、依存ビルドは適切なアーティファクトのソース（上流の構成ビルド）が存在することを保証できません。そのため、ピン留めされたビルドまたはタグ付きビルドを対象とするアーティファクト依存関係を設定することをお勧めします。
このセクションでは、ビルドチェーンとアーティファクトの依存関係に焦点を当てています。その他のオプションの詳細については、以下の記事を参照してください。
関連ページ：
ビルドチェーン
ビルドチェーンは、相互接続されたビルド構成とパイプラインの作成と編集のシーケンスです。チェーンは、完全に実行することも、部分的に実行することもできます。どちらの場合も、トリガーされた構成またはパイプラインによって、その上流の依存オブジェクトが最初に実行されます。例: 下のダイアグラムは、サンプルビルドチェーンを示しています。+------------+ +----------------+ +--------+ | Build core |---->| Build plugin A |--...
スナップショットの依存関係
ビルド (たとえば、ビルド B) のスナップショット依存関係を別のビルド (ビルド A) のソースに設定することで、ビルド B がビルド A の実行と終了の後にのみ開始されることを保証できます。ビルド A は依存関係ビルドと呼ばれ、ビルド B は依存ビルドと呼ばれます。ビルド設定 | 依存関係ページには、構成された依存関係が表示されます。このページのスナップショットの依存関係セクションでは、ビルドチェーンとその構成をプレビューできます。プレビューにはチェーンのビルドが表示されます。自動トリガーが構...
ビルド完了トリガの設定
ビルド終了トリガーは、選択したビルド構成のビルドが終了したときに、現在のビルド構成のビルドを開始します。重要なポイント：ビルドトリガーを終了が構成 A に追加されると、ターゲット構成 B を監視し、B が別のビルドを完了するたびに新しい A ビルドを生成します。ターゲット構成のビルドが成功した場合にのみビルドをトリガーするかどうかを選択できます。完了ビルドトリガーは、同じターゲット構成を指すスナップショット依存関係の恩恵を受けます。ターゲット構成のすべての新しいビルドを追跡する代わりに、ターゲ...
アーティファクトの依存関係
このページでは、あるビルドから別のビルドにファイルを渡すことができる TeamCity アーティファクトの依存関係の構成について詳しく説明します。例: 一般的なデプロイビルド構成は、他の (本番) 構成によって生成されたファイルを公開します。アーティファクトは以下から渡すことができます: 同じビルドチェーン内のターゲット構成の前に実行される構成。ターゲット構成と同じビルドチェーンの一部ではない個別の構成。同じ構成の以前のビルド。Web UI を使用したアーティファクトの依存関係の設定：ビルド構成...
パイプラインの作成と編集
パイプラインは、従来のビルド構成やビルドチェーンに代わる、ユーザー中心で簡素化された代替手段であり、TeamCity 2025.07 以降のバージョンで利用可能です。まだ早期アクセス段階であり、潜在的な問題があるため複雑な設定には推奨されませんが、実験的な機能とはみなされておらず、小規模で要求の少ないプロジェクトであれば本番環境で安全に使用できます。パイプラインとビルド構成とチェーン：パイプラインの作成に進む前に、ビルド構成とパイプラインの違い、それぞれをいつ使用するかを理解することが重要です...
一般的な依存関係の概念
このページでは、例に基づいて、TeamCity で依存関係がどのように機能するかについての一般的な考え方を示します。依存関係の説明については、ビルド構成の依存関係を参照してください。多くの場合、あるビルドの出力を別のビルドで使用するだけでなく、同じソースで複数のビルドを順次または並列に実行すると便利です。典型的な例を考えてみましょう。本番ビルドを取得する前に、Windows と macOS でテストする必要があるクロスプラットフォームプロジェクトがあります。この単純なケースに最適なワークフローは...