ジョブの管理
ジョブは TeamCity のビルド構成を表します。 teamcity job コマンドグループを使用すると、ビルド構成の一覧表示、一時停止と再開、パラメーターの管理を行うことができます。
ジョブの一覧表示
すべてのビルド構成を表示:
teamcity job list
![Listing and filtering jobs]()
プロジェクトでフィルター:
teamcity job list --project MyProject
結果の数を制限します:
teamcity job list --limit 20
JSON として出力:
teamcity job list --json
teamcity job list --json=id,name,projectName,webUrl
ジョブリストのフラグ
フラグ | 説明 |
|---|
-p, --project
| プロジェクト ID でフィルタリング |
-n, --limit
| 表示するジョブの最大数 |
--json
| JSON として出力します。 使用可能なフィールドを一覧表示するには --json= を使用し、特定のフィールドを表示するには --json=f1,f2 を使用します。 |
ジョブ詳細の表示
ビルド構成の詳細を表示します。
teamcity job view MyProject_Build
ブラウザーでジョブページを開きます。
teamcity job view MyProject_Build --web
JSON として出力:
teamcity job view MyProject_Build --json
依存関係ツリー
ジョブのスナップショット依存関係チェーンを視覚化します。 デフォルトでは、ツリーには依存関係（このジョブの後に実行されるもの）と依存関係（このジョブの前に実行する必要があるもの）の両方が表示されます。
teamcity job tree MyProject_DeployStaging
![Viewing job dependency trees]()
1 方向のみ表示:
teamcity job tree MyProject_Build --only dependents
teamcity job tree MyProject_Deploy --only dependencies
ツリーの深さを制限します。
teamcity job tree MyProject_Build --depth 2
ジョブツリーのフラグ
フラグ | 説明 |
|---|
-d, --depth
| ツリーの深さを制限する (0 = 無制限) |
--only
| dependents または dependencies のみを表示
|
ジョブの一時停止と再開
新しいビルドがトリガーされないようにジョブを一時停止します。
teamcity job pause MyProject_Build
一時停止したジョブを再開して新しいビルドを許可します。
teamcity job resume MyProject_Build
ジョブパラメーターの管理
パラメーターの一覧表示
ジョブに定義されているすべてのパラメーターを表示します。
teamcity job param list MyProject_Build
teamcity job param list MyProject_Build --json
パラメーター値の取得
特定のパラメーターの値を取得します。
teamcity job param get MyProject_Build VERSION
teamcity job param get MyProject_Build env.JAVA_HOME
パラメーターの設定
パラメーター値を設定または更新します。
teamcity job param set MyProject_Build VERSION "2.0.0"
パラメーター（パスワードフィールド）をセキュアとしてマークするには、 --secure フラグを使用します。 セキュアパラメーターの値は、Web インターフェースとビルドログでは非表示になります。
teamcity job param set MyProject_Build SECRET_KEY "my-secret-value" --secure
パラメーターの削除
ジョブからパラメーターを削除します。
teamcity job param delete MyProject_Build MY_PARAM
2026 年 9 月 11 日
