VCS トリガーの設定

スナップショットの依存関係の変更に基づいてビルドをトリガーする

ビルドチェーン ( スナップショット依存関係によって相互接続された複数のビルド) がある場合、トリガーはチェーンの最終ビルドで構成する必要があります。これは、下のイメージのパック設定です。

VCS ビルドトリガーには、ビルドチェーンのトリガー動作を変更する別のオプションがあります。このオプションを有効にすると、最終ビルドではなく依存関係で変更が検出された場合でも、ビルドチェーン全体がトリガーされます。

例からビルドチェーンを見てみましょう: pack setup — 依存 — tests — 依存 — compile

pack setup 構成で VCS トリガーを設定すると、通常、TeamCity が pack setup の変更を検出すると、ビルドチェーン全体がトリガーされます。compile の変更は、compile のみをトリガーし、チェーン全体はトリガーしません。compile の VCS 変更でチェーン全体をトリガーする場合は、チェーン、pack setup の最終ビルド構成に、「スナップショット依存関係の変更をトリガー」オプションを有効にした VCS トリガーを追加します。これにより、ビルドの実行順序は変更されませんが、スナップショット依存関係のいずれかに変更があった場合にのみ、ビルドチェーン全体がトリガーされます。この設定では、compile または tests ビルド構成に VCS トリガーは必要ありません。

トリガールールが指定されている場合 ( 以下で説明)、それらはすべての変更 (スナップショット依存関係からの変更を含む) に適用され、ルールに一致する変更のみがビルドチェーンをトリガーします。

詳細は依存関係を構築するページでも参照してください。

チェックインごとのトリガー

このオプションが有効になっていない場合、異なるコミッターによる複数のチェックインが行われる可能性があり、それらが検出されると、TeamCity はこれらすべての変更を含むビルドを 1 つだけキューに追加します。

高速ビルドと十分なビルドエージェントがある場合は、TeamCity に新しいビルドチェックインごとにを起動させて、他の変更が同じビルドに含まれないようにすることができます。
これを行うには、チェックインのたびにビルドを開始するオプションを選択します。同じコミッターからのものである場合は、ビルドに複数のチェックインを含めますオプションを選択すると、TeamCity は保留中の変更の数を検出し、ユーザーごとにグループ化し、単一のユーザーによる変更のみを含むビルドを開始します。

これは、そのような問題が発生した場合に、どの変更がビルドを壊したか、新しいテストの失敗を引き起こしたかを把握できます。

VCS トリガールール

トリガールールが指定されていない場合、ビルド構成で検出された変更があればビルドがトリガーされます。VCS ルート設定を変更し、チェックアウトルールを指定することで、検出される変更を制御できます。

ビルドをトリガーする変更を制限するには、VCS トリガールールを使用します。これらのルールはテキスト領域に手動で追加することも (1 行に 1 つ)、新しいルールを追加ボタンを使用してルールを生成することもできます (必要に応じて、下にスクロールしてボタンを表示します)。

各ルールは、「include」 ( + で始まる) または「exclude」 ( - で始まる) のいずれかです。

トリガーされたビルドのカスタマイズ

トリガーの設定のビルドのカスタマイズタブでは、このトリガーによって開始されたビルドのカスタムパラメーターを構成できます。カスタムビルドを実行するダイアログと同様に、ビルドパラメーターの値を上書きし、ビルド前にチェックアウトディレクトリをクリーンアップするかどうかを選択できます。

このタブでは、現在のビルド構成で使用されているパラメーターの値をカスタマイズできます。または、新しいパラメーターを追加することもできます。このパラメーターは、このトリガーによって開始されたビルドでのみ使用できます。現在のビルドに他のビルドとのスナップショットの依存関係がある場合、そのようなパラメーターを使用して、依存関係ビルド構成の特定のプロパティをオーバーライドすることもできます。これには reverse.dep.<dependencyBuildID>.<property> 構文を使用します。

トリガー内でビルドパラメーターを再定義してからパラメーターで元のパラメーターを削除すると、その再定義された値がトリガー自体のプレーンテキストパラメーターに変換されることに注意してください。安全な値をカスタマイズするときは、「パスワード」の種類と一緒に保存された場合にのみ隠され、プレーンテキストに変換された場合に読み取り可能になるため、これを考慮することが重要です。

TeamCity を使用すると、同様のタスクを複数の方法で解決できます。場合によっては、異なるビルド構成を作成することが望ましい場合もあります。例: 同じ構成でカスタム実行が多すぎる場合、TeamCity が各ビルドの正確な期間を予測するのが難しい場合があります。多数の異なるパラメーターを使用してビルドをトリガーする必要がある場合は、ビルド構成テンプレートを作成し、それぞれが独自のパラメーターを持つ複数の構成の青写真として使用することをお勧めします。