再試行ビルドトリガーの構成
再試行ビルドトリガーは、現在のビルド構成の前のビルドが失敗した場合に、新しいビルドをキューに自動的に追加します。
インフラストラクチャの問題（たとえば、ビルド開始時にビルドエージェントが予期せずシャットダウンした場合など）によりビルドが失敗した場合、このトリガーが設定されていなくても、TeamCity はビルドを再開します。この動作は、デフォルトで 3 回連続して試行される teamcity.buildQueue.restartBuildAttempts 内部プロパティによって制御されます。
トリガー設定
再試行ビルドトリガーでは、次の設定を使用できます。
設定 | 説明 |
|---|---|
待つ秒 | 新しいビルドをキューに追加する前に待機する秒数を指定します。 |
ビルドを再試行する回数 | トリガーが失敗したビルドの再実行を試行する回数を指定します。ビルドが成功するまで無制限に再試行するには、空白のままにします。 |
同じリビジョンで新しいビルドをトリガーします | このオプションを有効にすると、再試行トリガーは同じソースリビジョンを使用して失敗したビルドを再実行します。 このオプションは、ビルドコードに依存しないビルドの問題を特定できます。たとえば、ビルド構成に不安定なテストがある場合や、予期しないエージェントの互換性の問題があった場合などです。 |
新しくトリガーされたビルドをキューの先頭に配置します | このオプションを有効にすると、再試行されたビルドは常にキューの先頭に配置されます。 |
ブランチフィルター | ブランチフィルターを適用して、指定された条件に一致するブランチでのみ失敗したビルドを再実行します。 |
トリガーされたビルドのカスタマイズ
トリガーの設定のビルドのカスタマイズタブでは、このトリガーによって開始されたビルドのカスタムパラメーターを構成できます。カスタムビルドを実行するダイアログと同様に、ビルドパラメーターの値を上書きし、ビルド前にチェックアウトディレクトリをクリーンアップするかどうかを選択できます。
このタブでは、現在のビルド構成で使用されているパラメーターの値をカスタマイズできます。または、新しいパラメーターを追加することもできます。このパラメーターは、このトリガーによって開始されたビルドでのみ使用できます。現在のビルドに他のビルドとのスナップショットの依存関係がある場合、そのようなパラメーターを使用して、依存関係ビルド構成の特定のプロパティをオーバーライドすることもできます。これには reverse.dep.<dependencyBuildID>.<property> 構文を使用します。
トリガー内でビルドパラメーターを再定義してからパラメーターで元のパラメーターを削除すると、その再定義された値がトリガー自体のプレーンテキストパラメーターに変換されることに注意してください。安全な値をカスタマイズするときは、「パスワード」の種類と一緒に保存された場合にのみ隠され、プレーンテキストに変換された場合に読み取り可能になるため、これを考慮することが重要です。
TeamCity を使用すると、同様のタスクを複数の方法で解決できます。場合によっては、異なるビルド構成を作成することが望ましい場合もあります。例: 同じ構成でカスタム実行が多すぎる場合、TeamCity が各ビルドの正確な期間を予測するのが難しい場合があります。多数の異なるパラメーターを使用してビルドをトリガーする必要がある場合は、ビルド構成テンプレートを作成し、それぞれが独自のパラメーターを持つ複数の構成の青写真として使用することをお勧めします。
関連ページ：
TeamCity サーバー起動プロパティの設定
TeamCity サーバーの動作のさまざまな側面は、起動時に渡されるオプションを介してカスタマイズできます。TeamCity 自体に影響を与える内部プロパティ、Java 仮想マシン（JVM）のプロパティ、TeamCity の内部プロパティ：TeamCity には、内部ロジックのさまざまな側面に影響を与える内部構成プロパティがあります。これらは通常、デバッグ、内部定数の変更、実験的な動作の有効化を目的としています。TeamCity サポートチームからの要請がない限り、内部プロパティを変更しないで...
カスタムビルドの実行
ビルド構成とパイプラインの右上隅には、新しいビルドをトリガーする 2 つのボタンが表示されます。実行 — デフォルト設定で新規ビルドを開始します。カスタムビルドを実行する — ビルド開始前にビルド設定を変更できるダイアログを表示します。この記事では、利用可能なカスタマイズオプションについて説明するとともに、カスタムビルドをトリガーするその他の方法についても触れています。カスタムビルドを実行するダイアログ：このダイアログは、以下のいずれかの場合に TeamCity UI に表示されます。カスタムビル...
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は 3 種類のパラメーターをサポートしています。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...
チェーンのビルドでパラメーターを使用する
このトピックでは、TeamCity ビルドパラメーターを使用して、ビルドチェーンの構成間で単純なデータを交換する方法を説明します。入力および出力パラメーター：ビルド構成設定のパラメーターページでは、入力パラメーターと出力パラメーターを切り替えることができます。どちらも手動で作成された名前と値のペアです。主な違いは、意図された使用例とアクセシビリティ設定にあります。入力パラメーター入力パラメーターは、定義する同じ構成で使用されるように設計されています。例: デフォルトのブランチ名を格納し、VCS...
ビルドステップの実行条件
ビルドステップを構成するときに、一般的な実行ポリシーを選択し、TeamCity 2020.1 以降ではパラメーターベースの実行条件を追加できます。実行条件により、ビルドがより柔軟になり、次のような多くの一般的な使用例に対応します。デフォルトのブランチでのみステップを実行する、ブランチでのみステップを実行する、個人ビルドのステップをスキップする、ビルドステップの条件を追加メニューで使用可能な共通オプションをすばやく選択できます。または、その他の状態オプションを選択して、パラメーターベースの実行条件...
カスタムパラメーターの作成と設定
このトピックでは、カスタム TeamCity パラメーターを作成し、その外観と動作を構成する方法について説明します。名前の制限：構成パラメーターの名前には、文字のみが含まれ、ASCII 文字で始まる必要があります。新しいパラメーターを作成する方法：TeamCity UI 内プロジェクトまたは構成設定に移動し、パラメータータブに切り替えます。パラメーターの優先順位と継承ルールについては、この記事を参照してください: パラメーター値。入力パラメータータブに切り替えます。出力パラメーターはビルドチェ...