CLI 用語集

実行

ビルド構成の単一実行。 TeamCity ウェブインターフェースの ビルド に相当します。

ジョブ

ビルドを実行するための一連の手順。 TeamCity ウェブインターフェースの ビルド構成 に相当します。

プロジェクト

名前と説明が関連付けられたビルド構成（ジョブ）のコレクション。 プロジェクトはネストして階層構造を形成できます。

パイプライン

単一の .teamcity.yml ソースを共有するジョブの YAML 定義コレクション。 パイプラインは、Kotlin DSL とウェブ UI に代わる TeamCity の宣言型の代替手段であり、CLI で一覧表示、表示、検証、同期できます。

VCS ルート

バージョン管理リポジトリ（Git、Mercurial、Perforce など）へのポインタ。 ジョブは、ビルド用のソースを取得するために、1 つ以上の VCS ルートに接続します。 CLI は、プロジェクトレベルで VCS ルートを管理します。

接続

TeamCity がジョブに代わって使用する外部サービス (GitHub アプリ、Bitbucket、Docker レジストリ、AWS、…) の保存済み資格情報。 接続はプロジェクトレベルで管理され、個々のジョブに機密情報を埋め込むことを回避します。

バージョン対応設定

プロジェクトの構成 (ジョブ、パラメーター、トリガー) を Kotlin DSL または XML として Git リポジトリと同期する TeamCity の機能です。 CLI は UI を経由することなく、ローカルで DSL をエクスポートおよび検証できます。

ビルドキュー

利用可能なエージェントへの割り当てを待機しているビルドのリストです。 キュー内のビルドは、リソースが利用可能になると、対応するエージェントに配布されます。 キューの順序は手動で変更できます。

ビルドエージェント

ビルドを実行するソフトウェア。 エージェントは別々のマシンにインストールされ、ビルド構成との互換性に基づいてビルドが割り当てられます。

エージェントプール

ビルドエージェントの名前付きグループ。 プロジェクトをプールにリンクして、どのエージェントがビルドを実行するかを制御できます。

クラウドプロファイル

プロジェクトとクラウドプロバイダー（AWS、GCP、Azure、Kubernetes など）間の連携。 プロファイルは、TeamCity がオンデマンドで一時的なビルドエージェントを起動するために使用する、単数または複数のイメージを定義します。

クラウドイメージ

クラウドプロファイル（たとえば、EC2 上の AMI や Kubernetes 上のコンテナーイメージ）から一時的なエージェントを起動するためのテンプレート。 各イメージは、ビルドに容量が必要になったときに TeamCity が起動するエージェントランタイムを指定します。

クラウドインスタンス

クラウドイメージから作成された、単一の実行中の一時的なエージェント。 インスタンスの寿命は短く、TeamCity はビルドでエージェントが必要になるとインスタンスをプロビジョニングし、作業が完了するとダウンさせます。

変更

TeamCity によって検出されたソースコードの変更。 変更は VCS にコミットされているものの、まだビルドに含まれていない場合、保留中とみなされます。

個人ビルド

メインのビルド履歴に影響を与えずにローカルの変更をテストするために開発者が開始するビルド。 TeamCity CLI では、 --local-changes フラグを使用して個人ビルドがトリガーされます。

エイリアス

完全な teamcity コマンドに展開されるカスタムコマンドショートカット。 エイリアスは位置引数とシェル式をサポートします。

スキル

AI コーディングエージェント (Claude Code、Cursor など) に TeamCity CLI の使い方を教える、バンドルされた構成ファイル。 スキルは エージェントスキル仕様(英語)に従います。

用語マッピング