再試行ビルドトリガーの構成
再試行ビルドトリガーは 、現在のビルド構成の前のビルドが失敗した場合に、新しいビルドをキューに自動的に追加します。
ビルドエージェントがビルドの開始時に予期せずシャットダウンするなど、インフラストラクチャの課題が原因でビルドが失敗した場合、このトリガーが設定されていなくても、TeamCity はビルドを再起動します。 この動作は teamcity.internal.buildQueue.restartBuildAttempts=N 設定によって制御され、 N は再起動試行回数です (デフォルトは 3)。 この設定は、 内部プロパティを使用してグローバルに構成することも、 構成パラメーターに追加して個々のビルドごとに構成することもできます。
トリガー設定
再試行ビルドトリガーでは、次の設定を使用できます。
設定 | 説明 |
|---|---|
待機する秒数 | 新しいビルドをキューに追加する前に待機する秒数を指定します。 |
ビルドを再試行する試行回数 | 失敗したビルドの再実行をトリガーが試行する回数を指定します。 ビルドが成功するまで回数無制限で再試行するには、空白のままにします。 |
同じリビジョンで新しいビルドをトリガーする | このオプションを有効にすると、再試行トリガーは同じソースリビジョンを使用して失敗したビルドを再実行します。 このオプションは、ビルドコードに依存しないビルドの問題を特定するのに役立ちます。たとえば、ビルド構成に不安定なテストがある場合や、予期しないエージェント互換性の課題があった場合などです。 |
新しくトリガーされたビルドをキューの先頭に配置する | このオプションを有効にすると、再試行されたビルドは常にキューの先頭に配置されます。 |
ブランチフィルター | ブランチフィルターを適用して、指定された条件に一致するブランチでのみ失敗したビルドを再実行します。 |
トリガーされたビルドのカスタマイズ
トリガーの設定の ビルドカスタマイズ タブでは、このトリガーによって開始されたビルドのカスタムパラメーターを構成できます。 カスタムビルドを実行するダイアログと同様に、 ビルドパラメーターの値を上書きし、ビルド前に チェックアウトディレクトリをクリーンアップするかどうかを選択できます。
このタブでは、現在の ビルド構成 で使用されている任意の パラメーター の値をカスタマイズできます。 また、新しいパラメーターを追加することもでき、そのパラメーターはこのトリガーによって開始されるビルドでのみ使用できます。 現在のビルドに他のビルドに対する スナップショット依存関係 がある場合、このようなパラメーターを使用して、依存ビルド構成の 特定のプロパティをオーバーライド することもできます: このためには reverse.dep.<dependencyBuildID>.<property> 構文を使用します。
トリガー内でビルドパラメーターを再定義してから パラメーター で元のパラメーターを削除すると、その再定義された値がトリガー自体のプレーンテキストパラメーターに変換されることに注意してください。 安全な値をカスタマイズするときは、 「パスワード」の種類と一緒に保存された場合にのみ隠され、プレーンテキストに変換された場合に読み取り可能になるため、これを考慮することが重要です。
TeamCity では類似したタスクを複数の方法で解決でき、場合によっては別々のビルド構成を作成するほうが依然として望ましいことがあります。 たとえば、同じ構成でカスタム実行が多すぎる場合、TeamCity が各ビルドの正確な所要時間を予測しにくくなることがあります。 多数の異なるパラメーターでビルドをトリガーする必要がある場合は、 ビルド構成テンプレート を作成し、それぞれ独自のパラメーターを持つ複数の構成のブループリントとして使用することをお勧めします。