パイプラインの管理

パイプラインは、TeamCity で CI/CD ワークフローを定義するための YAML ベースの構成システムです。各パイプラインはプロジェクトに属し、VCS ルートを参照し、1 つ以上のジョブを含みます。 teamcity pipeline コマンドグループを使用すると、パイプライン YAML の一覧表示、インスペクション、作成、管理を行うことができます。

Listing pipelines

サーバー上のすべてのパイプラインを表示する:

teamcity pipeline list

プロジェクトでフィルター:

teamcity pipeline list --project MyProject
teamcity pipeline list --project MyProject --json

pipeline list フラグ

フラグ	説明
`-p`, `--project`	プロジェクト ID でフィルタリング
`-n`, `--limit`	表示するパイプラインの最大数 (デフォルト 30)
`--json`	JSON として出力します。使用可能なフィールドを一覧表示するには `--json=` を使用し、特定のフィールドを表示するには `--json=f1,f2` を使用します。

パイプライン詳細の表示

teamcity pipeline view CLI_CiCd
teamcity pipeline view CLI_CiCd --json

このビューには、パイプライン名、親プロジェクト、ヘッドビルドタイプ、すべてのジョブとその YAML キーと表示名が表示されます。

パイプライン YAML の検証

プッシュする前に、 .teamcity.yml ファイルをサーバーの JSON スキーマに対して検証してください。

teamcity pipeline validate
teamcity pipeline validate path/to/pipeline.yml

スキーマはサーバーから取得され、24 時間ローカルにキャッシュされます。再取得を強制するには --refresh-schema を、ローカルのスキーマファイルを使用するには --schema を使用してください。

validate フラグ

フラグ	説明
`--schema`	ローカル JSON スキーマファイルへのパス
`--refresh-schema`	サーバーからスキーマを強制的に再取得します

パイプラインスキーマの確認

TeamCity が .teamcity.yml の検証に使用するインスタンスごとの JSON スキーマを出力します：

teamcity pipeline schema

Inspecting and saving the pipeline JSON schema

スキーマには、接続先サーバーで利用できるランナー、パラメーター、コンストラクトが反映されるため、TeamCity のバージョン間で変化することがあります。 CLI はこれをローカルで 24 時間キャッシングします。キャッシングをバイパスしてサーバーから再取得するには、 --refresh を渡します：

teamcity pipeline schema --refresh

サーバーが TeamCity 2026.1 より前(スキーマエンドポイントなし)の場合、コマンドは埋め込みのフォールバックスキーマを出力し、stderr に警告を書き込みます。

パイプラインの作成

YAML ファイルから新しいパイプラインを作成する:

teamcity pipeline create my-pipeline --project CLI
teamcity pipeline create my-pipeline --project CLI --vcs-root MyVcsRoot
teamcity pipeline create my-pipeline --project CLI --file pipeline.yml

  

--vcs-root を省略すると、対話型のプロンプトが表示され、プロジェクトで使用可能な VCS ルートが一覧表示されます。

create フラグ

フラグ	説明
`-p`, `--project`	親プロジェクト ID (必須)
`--vcs-root`	VCS ルート ID。利用可能なルートを検出するには、 `teamcity project vcs list` を使用してください。
`-f`, `--file`	パイプライン YAML ファイルへのパス (デフォルト `.teamcity.yml`)

パイプライン YAML のダウンロード

サーバーに保存されるパイプラインの YAML ソースをダウンロードしてください。

teamcity pipeline pull CLI_CiCd
teamcity pipeline pull CLI_CiCd -o .teamcity.yml

出力はデフォルトで標準出力に送られるため、パイプ処理に適しています。ファイルに書き込むには、 -o を使用してください。

パイプライン YAML のアップロード

更新された YAML をサーバーに保存されたパイプラインにプッシュする:

teamcity pipeline push CLI_CiCd
teamcity pipeline push CLI_CiCd pipeline.yml

ファイルが指定されていない場合、CLI は現在のディレクトリから .teamcity.yml を読み取ります。

パイプラインの削除

teamcity pipeline delete CLI_MyPipeline
teamcity pipeline delete CLI_MyPipeline --yes

--yes が渡されない限り、確認プロンプトが表示されます。

シークレットの管理

パイプラインのシークレットには credentialsJSON: トークンを使用します。パイプラインのプロジェクトでトークンを作成し、YAML ファイルでそのトークンを参照してください。

# Create the pipeline first
teamcity pipeline create my-pipeline --project CLI

# Store a secret in the pipeline's project
teamcity project token put CLI_MyPipeline "my-api-key"
# Output: credentialsJSON:2d3c2507-4840-...

  

パイプラインの YAML ファイルでトークンを参照してください。

secrets:
  env.API_KEY: credentialsJSON:2d3c2507-4840-...

次にプッシュする:

teamcity pipeline push CLI_MyPipeline

他のコマンドでのパイプライン

プロジェクトツリー

teamcity project tree は、 ⬡ でマークされたジョブの横にパイプラインを表示します。

teamcity project tree CLI

CLI CLI
├── CI CLI_CiCd ⬡ pipeline · 6 jobs
└── Build CLI_Build

   

パイプラインによって生成されたサブプロジェクトと仮想ビルドタイプは自動的に非表示になります。

実行表示

パイプラインの実行状況を表示すると、CLI にはパイプライン名が表示され、すべてのジョブが一覧表示されます。

teamcity run view 5800

✓ CI ⬡ 5800  #727 · main
Triggered by vcs · 3h ago · Took 8m 17s

Pipeline Jobs:
  lint                 Lint (build 5801)
  test_linux           Test Linux (build 5803)
  goreleaser           GoReleaser (build 5806)

   

実行ツリー

teamcity run tree はパイプラインの実行を検出し、一般的な依存関係ツリーではなく、ステータス概要を含むフラットなジョブリストを表示します。

teamcity run tree 6708

ジョブリスト

teamcity job list はデフォルトでパイプラインヘッドのビルドタイプを非表示にします。表示するには --all を使用してください。

teamcity job list --project CLI         # hides pipeline heads
teamcity job list --project CLI --all   # shows everything

パイプラインの実行

パイプラインは、パイプラインヘッドのビルドタイプ ID を使用して、標準の run start コマンドによってトリガーされます。

teamcity run start CLI_CiCd
teamcity run start CLI_CiCd --watch

2026 年 9 月 11 日