実行の管理

実行は TeamCity におけるビルド実行を表します。teamcity run コマンドグループを使用すると、ビルドの開始、リアルタイムでの監視、ログとテスト結果の表示、アーティファクトの管理、タグ、コメント、ピンによる実行の整理を行うことができます。

実行の一覧表示

teamcity run list の最近のビルドを表示:

teamcity run list

お気に入りの実行コース

teamcity run list --favorites を使用すると、現在ユーザーがお気に入りのビルドが表示されます。これには、手動でスターを付けたビルドや、TeamCity で重要としてマークしたビルドが含まれます。

teamcity run list --favorites
teamcity run list --favorites --status failure --limit 10

--favorites は、既存の run list のフィルターおよび出力モードと互換性があります。

フィルター

フラグを使用して結果を絞り込みます。

# Builds for a specific job
teamcity run list --job MyProject_Build

# Filter by project
teamcity run list --project MyProject

# Filter by branch
teamcity run list --branch main

# Auto-detect the current git branch
teamcity run list --branch @this

# Filter by status
teamcity run list --status failure

# Show only your favorite builds
teamcity run list --favorites

# Show only your own recent builds
teamcity run list --user @me

# Show only the latest matching run
teamcity run list --user @me --branch @this --limit 1

# Filter by user who triggered the build
teamcity run list --user alice
teamcity run list --user @me

# Combine filters
teamcity run list --job MyProject_Build --status failure --branch main

リビジョンによるフィルタリング

--revision を使用して、特定の VCS コミットを含むすべてのビルドを検索します。

# All builds for a commit
teamcity run list --revision abc1234

# Scoped to a specific job
teamcity run list --revision abc1234 --job MyProject_Build

# Auto-detect the current HEAD commit
teamcity run list --revision @head

時間ベースのフィルタリング

--since と --until を使用して時間でフィルタリングします。期間オフセット（24h、7d、2w、1mo、4w2d5h）または ISO 日付（2026-01-15、2026-01-15T12:00:00Z）を受け入れます。

# Builds from the last 24 hours
teamcity run list --since 24h

# Builds from the last week
teamcity run list --since 7d

# Builds from a specific date onward
teamcity run list --since 2026-01-15

# Builds in a time range
teamcity run list --since 2026-01-15 --until 2026-01-20

結果を制限する

teamcity run list --limit 20

出力オプション

# JSON output (see Scripting and automation for details)
teamcity run list --json
teamcity run list --json=id,status,webUrl

# Plain text for scripting
teamcity run list --plain
teamcity run list --plain --no-header

実行リストフラグ

フラグ	説明
`-j` , `--job`	ジョブ（ビルド構成）ID でフィルタリング
`-p` , `--project`	プロジェクト ID でフィルタリング
`-b` , `--branch`	ブランチ名でフィルタリングします。現在の git ブランチを解決するには、`@this` を使用します。
`--status`	ステータスでフィルタリング: `success`、`failure`、`running`、`queued`、`error`、または `unknown`
`--favorites`	現在のユーザーのお気に入りのビルドを表示します。
`-u` , `--user`	ビルドをトリガーしたユーザーでフィルタリングします。現在のユーザーには `@me` を使用します。
`--revision`	VCS リビジョン（コミット SHA）でフィルタリングします。`@head` を使用して現在の git HEAD を解決します。
`--since`	この時間以降に完了したビルドを表示 (たとえば、`24h`、`7d`、`2026-01-21` )
`--until`	この時間より前に完了したビルドを表示
`-n` , `--limit`	表示する実行の最大数
`--json`	JSON として出力します。使用可能なフィールドを一覧表示するには `--json=` を使用し、特定のフィールドを表示するには `--json=f1,f2` を使用します。
`--plain`	スクリプト用のタブ区切り出力
`--no-header`	ヘッダー行を省略 (`--plain` と併用)
`-w` , `--web`	ブラウザーでリストを開く

実行を始める

teamcity run start で新しいビルドをトリガーします:

teamcity run start MyProject_Build

ブランチとリビジョンの指定

# Build a specific branch
teamcity run start MyProject_Build --branch feature/login

# Build the branch you are currently on
teamcity run start MyProject_Build --branch @this

# Pin to a specific Git commit
teamcity run start MyProject_Build --branch main --revision abc123def

# Pin to the current HEAD
teamcity run start MyProject_Build --branch @this --revision @head

ビルドパラメーター

カスタムパラメーター、システムプロパティ、環境変数を渡します。

teamcity run start MyProject_Build \
  -P version=1.0 \
  -S build.number=123 \
  -E CI=true

ビルドオプション

# Clean all source files before building
teamcity run start MyProject_Build --clean

# Rebuild all dependencies
teamcity run start MyProject_Build --rebuild-deps

# Rebuild only failed dependencies
teamcity run start MyProject_Build --rebuild-failed-deps

# Reuse existing builds as snapshot dependencies (pin by build ID)
teamcity run start MyProject_Build --reuse-deps 6946,6917

# Add to the top of the queue
teamcity run start MyProject_Build --top

# Run on a specific agent
teamcity run start MyProject_Build --agent 5

タグとコメント

teamcity run start MyProject_Build --tag release --tag v2.0 --comment "Release build"

開始して視聴する

ビルドを開始した後、ビルドを追跡するために --watch を追加します。

teamcity run start MyProject_Build --branch main --watch

タイムアウトを設定したり、ポーリング間隔を調整したりすることもできます。

teamcity run start MyProject_Build --watch --timeout 30m
teamcity run start MyProject_Build --watch --interval 10

パーソナルビルド

コミットされていないローカルの変更を個人ビルドに含めます。

# Auto-detect changes from Git working directory
teamcity run start MyProject_Build --local-changes

# From a patch file
teamcity run start MyProject_Build --local-changes changes.patch

# From stdin
git diff | teamcity run start MyProject_Build --local-changes -

デフォルトでは、CLI は個人ビルドを開始する前にブランチをリモートにプッシュします。これをスキップするには、--no-push を使用してください。

teamcity run start MyProject_Build --local-changes --no-push

リハーサル

実際にビルドを開始せずに、何がトリガーされるかをプレビューします。

teamcity run start MyProject_Build --dry-run

実行開始フラグ

フラグ	説明
`-b` , `--branch`	ビルドするにはブランチを使用します。現在の git を解決するには `@this` を使用します。
`--revision`	ビルドを特定の Git コミット SHA に固定します。現在の HEAD を解決するには `@head` を使用します。短い SHA はローカルリポジトリから展開されます。
`-P` , `--param`	ビルドパラメーターを `key=value` として (繰り返すことができる)
`-S` , `--system`	システムプロパティは `key=value` です (繰り返すことができる)
`-E` , `--env`	環境変数として `key=value` (繰り返すことができる)
`-m` , `--comment`	コメントを作成する
`-t` , `--tag`	ビルドタグ (繰り返すことができる)
`--personal`	個人ビルドとして実行する
`-l` , `--local-changes`	ローカルの変更を含めます。`git` （デフォルト）、`-` （標準入力）、ファイルパスを受け入れます。
`--no-push`	ブランチからリモートへの自動プッシュをスキップします
`--clean`	ビルド前にソースファイルをクリーンアップする
`--rebuild-deps`	すべての依存関係を再構築します
`--rebuild-failed-deps`	再構築に失敗した、または不完全な依存関係のみ
`--reuse-deps`	既存のビルドをスナップショットの依存関係として再利用します。コンマ区切りのビルド ID リストを受け入れるか、複数回指定できます。TeamCity は、各ビルドがどの依存関係スロットを埋めるかをビルド構成に基づいて解決します。
`--top`	ビルドキューの先頭に追加
`--agent`	特定のエージェントで実行 (ID による)
`--watch`	開始後にビルドの様子を参照してください
`-i` , `--interval`	視聴時のリフレッシュ間隔（秒）（デフォルト）: 3)
`--timeout`	視聴中のタイムアウト（例: `30m`、`1h`）。`--watch` を暗示します。
`--dry-run`	開始せずにプレビューする
`--json`	JSON 形式で出力
`-w` , `--web`	ブラウザーで実行を開く

閲覧実行の詳細

teamcity run view 12345
teamcity run view 12345 --web
teamcity run view 12345 --json

スナップショット依存関係ツリー

teamcity run tree を使用した実行におけるスナップショット依存関係チェーンを視覚化します。

teamcity run tree 12345

ツリーの深さを制限する:

teamcity run tree 12345 --depth 2

JSON として出力:

teamcity run tree 12345 --json

木の旗を走らせる

フラグ	説明
`-d` , `--depth`	ツリーの深さを制限する (0 = 無制限)
`--json`	JSON 形式で出力

実行を見る

実行中のビルドをリアルタイム更新で監視する:

teamcity run watch 12345

視聴しながらビルドログをストリーミング配信する:

teamcity run watch 12345 --logs

Watching a build with live log streaming

カスタムリフレッシュ間隔またはタイムアウトを設定します。

teamcity run watch 12345 --interval 10
teamcity run watch 12345 --timeout 30m

状態変化と最終結果のみを表示する最小限の出力には、--quiet を使用してください。

teamcity run watch 12345 --quiet

--json を使用してビルドの補完を待ち、最終結果を JSON 形式で出力します（スクリプト作成に便利です）。

teamcity run watch 12345 --json

フラグを監視する実行

フラグ	説明
`-i` , `--interval`	リフレッシュ間隔（秒）
`--logs`	ストリームビルドログを見ながら
`--quiet`	最小限の出力 — 状態変化と結果のみ
`--json`	完了を待って結果を JSON 形式で出力します
`--timeout`	この時間経過後は視聴を停止してください (たとえば、`30m`、`1h`)

ビルドログの表示

実行時のログ出力を表示する:

teamcity run log 12345

特定のジョブの最新の実行ログを表示します。

teamcity run log --job MyProject_Build

障害診断情報を表示します。ビルドの問題、完全なスタックトレースを含む失敗したテスト、各障害が新規のものか既存のものかを表示します。

teamcity run log 12345 --failed

ページャーをバイパスして、生のテキストを出力する:

teamcity run log 12345 --raw

ビルドが完了するまで、ログをリアルタイムでストリーミング配信します。

teamcity run log 12345 --follow

直近 50 件のログメッセージを表示します。

teamcity run log 12345 --tail 50

ログを JSON 形式で出力します。

teamcity run log 12345 --json

ブラウザーでビルドログを開いてください。

teamcity run log 12345 --web

実行をキャンセルする

実行中またはキューに入っているビルドをキャンセルします。

teamcity run cancel 12345
teamcity run cancel 12345 --comment "Canceling for hotfix"

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

teamcity run cancel 12345 --yes

実行を再開する

同じ設定で実行を再開する:

teamcity run restart 12345
teamcity run restart 12345 --watch
teamcity run restart 12345 --timeout 30m
teamcity run restart 12345 --web

アーティファクト

遺物の一覧

ダウンロードせずに実行結果のアーティファクトを一覧表示する:

teamcity run artifacts 12345
teamcity run artifacts --job MyProject_Build
teamcity run artifacts 12345 --path html_reports/coverage
teamcity run artifacts 12345 --json

アーティファクトのダウンロード

完了した実行結果からアーティファクトをダウンロードする:

teamcity run download 12345
teamcity run download 12345 --path build/assets
teamcity run download 12345 -o ./artifacts
teamcity run download 12345 --artifact "*.jar"
teamcity run download 12345 --path build/assets -a "*.js"
teamcity run download 12345 --timeout 30m

--timeout フラグは、ダウンロード操作全体の最大時間を設定します（デフォルト: 10m）。大きなアーティファクトセットの場合は、--timeout 1h などのより長い値を使用してください。

テスト結果

実行したテスト結果を表示します。

teamcity run tests 12345
teamcity run tests --job MyProject_Build

失敗したテストのみを表示し、ミュートされた失敗は除外します。

teamcity run tests 12345 --failed

ミュートされた失敗テストのみを表示する:

teamcity run tests 12345 --muted

結果の数を制限します:

teamcity run tests 12345 --limit 50
teamcity run tests 12345 --json

VCS の変更

実行に含まれる VCS コミットを表示します。

teamcity run changes 12345

コミットのみを表示する（ファイル一覧は表示しない）:

teamcity run changes 12345 --no-files
teamcity run changes 12345 --json

実行結果の比較

2 つの実行結果を並べて比較し、ステータス、実行時間、エージェント、パラメーター、テスト結果、問題、VCS の変更点など、両者の間で何が変わったかをハイライトします。

teamcity run diff 12345 12346

実行 ID が 1 つだけ指定された場合、CLI はそれを同じジョブの前回の完了実行と比較します。これは「前回から何が変わったか？」を確認するのに便利です。

teamcity run diff 12345

ビルドログの差分比較

--log を渡すと、2 つのビルドログが色分けされた統合差分として比較されます。タイムスタンプ、一時パス、ノイズの多い Git の進捗状況行は正規化され、差分は実際のコンテンツに焦点を当てます。

teamcity run diff 12345 12346 --log
teamcity run diff 12345 12346 --log -U5            # 5 lines of context

出力はページャー（$PAGER、デフォルトは less）にパイプされます。よりリッチなレンダリングのために、色を削除して外部の差分ビューアーにパイプします。

teamcity run diff 12345 12346 --log --no-color | delta
teamcity run diff 12345 12346 --log --no-color | diff-so-fancy

その他の形態

両方の実行ファイルをブラウザーで開いてください。

teamcity run diff 12345 12346 --web

スクリプトの機械可読出力:

teamcity run diff 12345 12346 --json

ピンニングラン

実行を固定して、保持ポリシーによってクリーンアップされないようにする:

teamcity run pin 12345
teamcity run pin 12345 --comment "Release candidate"

ピンを取り外します。

teamcity run unpin 12345

タグ付け実行

実行結果にタグを追加して、分類やフィルタリングを行います。

teamcity run tag 12345 release
teamcity run tag 12345 release v2.0 production

タグの除去:

teamcity run untag 12345 release
teamcity run untag 12345 release v2.0

TeamCity オンプレミス 2026.1 ヘルプ