ビルドキューの操作

キューページ

上部のナビゲーションバーからキューページにアクセスします。このページには、実行を待機しているビルドのリストが表示され、各ビルドについて次の情報が表示されます。

• キュー内の位置。ビルド結果ページへのリンクとしても機能します。

• ソースブランチ名（使用可能な場合）。

• 階層内のリンク可能なパス: すべての親サブプロジェクトとビルド構成。

• 開始時間: 推定待機時間。推定時間値にカーソルを合わせると、次の情報を含むツールチップが表示されます。

  • 予想される開始 / 終了時間。

  • 計画されたエージェントへのリンク。

  • 現在のビルドがビルドチェーンの一部であり、それが依存するビルドがまだ完了していない場合、対応するメモが表示されます。これまで実行されたことのないビルドなど、一部のビルドでは、TeamCity は実行時間を推定できないため、ツールチップにそれぞれのメッセージが表示されます。

• ビルドをトリガーしたイベントの簡単な説明。

• このビルド構成と互換性のあるエージェントの数。エージェントの名前のリンクをクリックしてエージェントページを開くか、下矢印を使用してポップアップメニューに互換性のあるエージェントのリストをすばやく表示できます。

Build Duration Estimates

TeamCity estimates the duration of queued and running builds from finished builds of the same build configuration. These estimates are used to calculate expected start and finish times, show the remaining time for running builds, detect hanging builds, optimize and order the build queue, and select the fastest agent.

When a build configuration runs with different effective settings, TeamCity looks for recent builds with the same settings. Effective settings include custom parameter values specified in the カスタムビルドを実行する dialog, as well as other build configuration settings that can affect the workload.

If TeamCity finds enough matching builds with consistent durations (five builds by default), it uses this matching history for the estimate. Otherwise, it falls back to the recent history of the entire build configuration. As a result, a new or rarely used combination of settings still receives a general estimate, while recurring variants gradually receive estimates based on their own history.

Only finished, non-personal, and non-canceled builds are considered. When TeamCity compares compatible agents, it also uses the history relevant to each agent. Cloud agents started from the same cloud image share this history, so a newly started agent can reuse duration data collected by previous agents from that image.

TeamCity によるビルドキューの最適化

デフォルトでは、TeamCity は次のようにビルドキューを最適化します。

• 同様のビルドがキューに存在する場合、（同じ変更セットにあり、同じカスタムプロパティを持つ）新しいビルドは追加されません。

• 自動的にトリガーされたビルドチェーンに、すでにキューに入れられているビルドチェーンよりも多くの変更がある場合、ビルドチェーンの結果の取得を遅らせない限り、後者は自動的にトリガーされたビルドチェーンに置き換えられます（推定期間に基づく）。

• ビルドチェーンがキューにある間、TeamCity は、キューに入れられたビルドを同等の開始済みビルドに置き換えようとします。

• 15 日を超えてキュー内に留まったビルドは、自動的にキャンセルされます (互換性のあるエージェントがない場合など)。

キュービルドのためのエージェント選択

キュービルドを実行できるアイドル状態のエージェントが複数ある場合、TeamCity は次のように最速のエージェントを選択しようとします。

1. 以前にエージェントでビルドが実行されたことがない場合は、CPU ランクを使用してエージェントを選択します。

2. If builds have previously run on agents, TeamCity compares compatible agents by their estimated build durations using history relevant to each agent. Cloud agents started from the same cloud image share this history. If the estimates are identical, TeamCity uses their CPU ranks.

ビルドキューを並べ替える

TeamCity ユーザーは、キューに入れられたビルドを次のように管理できます。

• 「キュー内のビルドの順序変更」権限 (デフォルトの「プロジェクト開発者」ロールに含まれています) を持つユーザーは、キュー内のビルドをドラッグアンドドロップして順序を変更したり、ビルドをキューの先頭に移動したりできます。

• 通常のビルドと個人ビルドを停止してキューから削除します。プロジェクト管理者は、「個人ビルドを停止 / キューから削除」権限により、他のユーザーがトリガーした個人ビルドも停止できます。

• システム管理者は、ビルド構成に異なる優先順位を割り当てて、ビルドを昇格または降格することができます。

ビルド優先順位の管理

デフォルトでは、ビルドはトリガーされた順序でビルドキューに配置されます。最後にトリガーされたビルドがキューの一番下に追加されます。ビルドの優先度を変更して、定義された優先度と現在キューに入れられているビルドの待機時間に応じた位置でビルドがビルドキューに挿入されるようにすることができます。

優先クラスを作成することで、ビルドの優先順位を制御できます。優先順位クラスは、指定された優先順位を持つビルド構成のセットです (数値が大きいほど優先順位が高くなります。たとえば、priority=2 は priority=1 よりも高くなります)。構成の優先順位が高いほど、ビルドキューに追加されたときに上位に配置されます。

これらの設定にアクセスするには、キューページの右上隅にある優先度をクリックします。このアクションは、システム管理者のみが使用できることに注意してください。

2 つの定義済み優先クラスがあります: 個人的なとデフォルト、両方とも priority=0 付き:

• すべての個人ビルド ( リモート実行またはテスト済みのコミット経由で起動) は、ビルドキューに追加されると、個人的な優先度クラスに割り当てられます。個人ビルドの優先度は変更できます。

• デフォルトクラスには、他のクラスに関連付けられていないすべてのビルドが含まれています。これにより、デフォルトよりも低い優先順位でクラスを作成し、いくつかのビルドをキューの末尾に配置することができます。

新しい優先度クラスを作成するには

1. 新しい優先度クラスを作成するをクリックします。

2. その名前、優先順位（-100..100 の範囲内）、追加の説明を指定します。作成をクリックします。

3. 構成の追加をクリックして、このクラスで優先度を定義するビルド構成を指定します。

この設定は、ビルドがキューに追加される場合にのみ考慮されます。優先度の低いビルドが常に実行されるようにするために、TeamCity は各ビルドがキュー内に留まる時間も考慮します。これにより、最近追加された優先度の高いビルドよりも前に、長時間待機していたビルドを優先度の低い状態で実行することができます。以下のアルゴリズムの詳細な説明を参照してください。

ビルドキューの一時停止と再開

ビルドキューは手動または自動で一時停止できます。この場合、ビルドは引き続きキューに追加されますが、キューが一時停止されなくなるまで、ビルドはエージェントに割り当てられません。

エージェントを有効 / 無効にする権限 (デフォルトでエージェントマネージャーロールに含まれています) を持つユーザーは、ビルドキューを手動で一時停止 / 再開できます (キューを一時停止することは、サーバー上のすべてのエージェントを無効にすることと同じであるため)。このアクションは、キューページの右上隅で使用できます。

TeamCity サーバーのディスク容量が不足すると、ビルドキューは自動的に一時停止されます。十分な容量が確保されると、キューは自動的に再開されます。

キューが一時停止されると、TeamCity の各ページに一時停止の理由に関する情報を含むメッセージが表示されます。

ビルドキューの最大サイズを制限する

キュー内のビルドの最大数を制限することができます。デフォルトでは、制限は 6000 ビルドです。デフォルト値は、teamcity.buildTriggersChecker.queueSizeLimit 内部プロパティを構成することで変更できます。

キューのサイズが制限に達すると、TeamCity は自動ビルドトリガーを一時停止します。キューのサイズが制限を下回ると、再度有効になります。トリガーが一時停止されている間、すべてのユーザーに警告メッセージが表示されます。
ただし、キューが制限に達して自動トリガーが一時停止された場合でも、ビルドを手動でキューに追加することは可能です。