ビルドキューの管理

ビルドキューには、利用可能なエージェントへの割り当てを待機しているビルドが保持されます。 teamcity queue コマンドグループを使用すると、キュー内のビルドをインスペクションしたり、優先度を制御したり、手動承認が必要なビルドを承認したり、キューからビルドを削除したりできます。

キューに入っているビルドの一覧表示

現在キューにあるすべてのビルドを表示します。

teamcity queue list

作業でフィルタリング:

teamcity queue list --job MyProject_Build

結果を制限し、JSON として出力します。

teamcity queue list --limit 20
teamcity queue list --json
teamcity queue list --json=id,state,buildType.name,triggered.user.name,webUrl

  

フラグ	説明
`-j`, `--job`	ジョブ（ビルド構成）ID でフィルタリング
`-n`, `--limit`	表示するキュー実行の最大数
`--json`	JSON として出力します。使用可能なフィールドを一覧表示するには `--json=` を使用し、特定のフィールドを表示するには `--json=f1,f2` を使用します。

キューに入れられたビルドをキューの先頭に移動し、最高の優先度を設定します。

teamcity queue top 12345

これは、重要なビルドをキュー内の他のビルドの前に実行する必要がある場合に便利です。

一部のビルド構成は、実行前に手動で承認する必要があります。キューに登録されたビルドを承認するには、以下の手順に従ってください。

teamcity queue approve 12345

キューからビルドを削除します。

teamcity queue remove 12345

確認プロンプトをスキップするには、 --yes を使用します。

teamcity queue remove 12345 --yes

2026 年 9 月 11 日