カスタムビルドの実行

一般オプション

エージェント

この設定により、ビルドを実行するエージェントを選択できます。次のオプションが利用可能です。

• 〈 fastest idle agent 〉 (デフォルトオプション) — 選択すると、TeamCity はビルドを実行するエージェントを自動的に選択します。

• リストから特定の TeamCity エージェントを選択します。TeamCity は、指定されたエージェントの現在の状態を表示し、(すでにビルドを実行している場合は) いつアイドル状態になるかを推定します。

• 〈 fastest idle agent in the N pool 〉 — TeamCity は、指定されたプールからエージェント上でビルドを実行します。

• クラウド統合が構成されている場合は、特定のクラウドイメージから生成されたエージェントでビルドを実行できます。このタイプのクラウドエージェントが利用できない場合は、TeamCity は新しいエージェントを起動しようとします。

• <すべての有効な互換性のあるエージェント> — 有効化され、ビルド構成と互換性のあるすべてのエージェントでビルドを同時に実行します。このオプションは次の目的で使用します。

  • エージェントのメンテナンスを目的としてビルドを実行します (たとえば、環境のアップグレード / 更新後にエージェントが正しく機能するかどうかを確認する構成を作成できます)。

  • さまざまなプラットフォームでビルドを実行します (たとえば、構成をセットアップし、インストールされているさまざまな環境と互換性のあるビルドエージェントの数を指定できます)。

ビルドオプション

最も一般的なビルドカスタマイズオプションが含まれています。

• 個人ビルドとして実行する — 個人ビルドを実行できます。まだコミットされていない変更をテストするためにパッチファイルを渡すことができます。

• ビルドをキューの先頭に配置する — この新しいビルドを現在のビルドキューの先頭に配置します。

• ビルド前にチェックアウトディレクトリ内のすべてのファイルを削除します。これは、 TeamCity がビルドチェックアウトディレクトリをクリアするかどうかを指定します。スナップショットの依存関係が設定されている場合、このオプションはスナップショットの依存関係にも適用できます。この場合、ビルドチェーンのすべてのビルドでクリーンなチェックアウトが使用されます。

日付 & 時刻

ビルド実行をクリックした直後に新しいビルドを通常のキューに配置するには、できるだけ早くオプションをそのままにしておきます。

特定の日時にビルドをスケジュールするには、特定の日時にオプションに切り替えます。スケジュールされたビルドは、スケジュールされた日時までビルドキューの最後に残ります。

依存関係

このタブは、ビルドの親構成またはパイプラインがより大きなワークフローの一部であり、上流のビルドが含まれている場合にのみ使用できます。この場合、これらの上流ビルドのうち、どれを新たに再構築するかを指定できます。デフォルトでは、TeamCity は以前に失敗したビルドも含め、すべてのビルドを再構築しようとします。

リスト内の依存関係ビルドは、最初はアルファベット順にソートされたブランチによってグループ化されます。同じブランチのビルドはビルド日によって並べ替えられます。ブランチベースの並べ替えを破棄し、すべての依存関係ビルドを日付のみで並べ替えるには、依存関係を日付で並べ替えるをクリックします。これにより、最新のビルドを最初に表示できます。デフォルトの並べ替えを復元するには、すべてリセットをクリックします。

変更

変更タブを使用すると、このビルドで処理する変更内容を細かく調整できます。

ブランチをビルドする

このオプションを選択すると、カスタムビルド用にブランチを選択できます。

含める変更

VCS ルートにおけるどの変更を今回の新規ビルドに含めるかを選択できます。以下のオプションが含まれます。

• ビルド開始時の最新の変更 — TeamCity には、現時点で利用可能なすべての最新の変更が自動的に含まれます。

• [Date] (リビジョン番号) (名前の変更) — 個々のコミットの一覧です。任意のコミットを選択すると、その変更までのプロジェクトがビルドされます。なお、TeamCity は最新の変更を無視したビルドを自動的に履歴ビルドとしてマークします。

  TeamCity に必要な古いコミットが表示されない場合 (たとえば、対応する VCS ルートが構成またはパイプラインから切り離された場合)、変更ログでそれを見つけて、この変更でビルドを実行するアクションを使用します。

• 手動で指定された改訂 — 変更内容の改訂番号を手動で入力してビルドすることができます。

設定を使用する

プロジェクトがその設定を VCS に保存している場合、このタブでは、この新しいビルドに使用する設定を選択できます。

• TeamCity サーバーで現在定義されている設定

• このビルド用に計算された VCS リビジョンからロードされた設定。

デフォルトの動作は、現在選択されているプロジェクト設定 | バージョン対応設定ページの設定によって異なります (詳細については、このセクションのビルドに適用する設定の定義を参照してください)。特定の変更リビジョンを選択した場合、TeamCity はプロジェクト設定の対応するリビジョンも読み込みます。

設定をサーバーベースの YAML ファイルに保存するパイプラインでは、このオプションは表示されません。

パラメーター

このタブでは、パラメーターの追加、編集、削除が可能です。以下の制限事項が適用されます。

• 変更できるのはパラメーターの値のみで、名前は編集できません。

• 削除アクションは、前回のカスタム実行で追加されたパラメーターに対してのみ表示されます。その他のパラメーターは削除できません。

  

  以前追加したパラメーターは、同じパラメーターで別のカスタム実行を行う必要がある場合に備えて、便宜上このタブに表示され続けます。通常の実行には自動的に追加されません。

• パイプラインの場合、パイプラインの入力パラメーターのみを上書きできます。ジョブパラメーターは、このダイアログからはアクセスできません。

• パラメーター値は 16,000 文字を超えてはなりません。

コメントとタグ

このタブでは、カスタムビルドにコメントやタグを付けることができます。また、このセクションの該当するオプションをオンにすることで、カスタムビルドをお気に入りに追加することもできます。