エンティティ ID
ID は、TeamCity エンティティ ( プロジェクト、ビルド構成、テンプレート、VCS ルートなど) に付与される識別子です。
各エンティティには 2 つの識別子があります。
普遍的にユニークな ID または UUID
外部 ID
いわゆる外部識別子は、TeamCity Web UI (プロジェクト ID など) で構成され、サーバー全体の同じタイプのすべてのオブジェクト内で一意である必要があります。ビルド構成とテンプレートは同じ ID スペースを共有します。
ID はラテン文字で始まり、ラテン文字、数字、アンダースコアのみで構成する必要があります。
外部 ID を使用する
外部 ID が使用されます。
Web インターフェース（NuGet フィードを含む）の URL、たとえば
https://teamcity.jetbrains.com/project.html?projectId=TeamCityPluginsByJetBrains(英語);REST API で、TeamCity を使用したアクションを自動化するために使用されるスクリプトをビルドします（たとえば、直接 URL または Ivy を介してアーティファクトをダウンロードします）。
<TeamCity Data Directory>/configにあるプロジェクトとビルド構成の設定を保存する構成ファイル内 ;<TeamCity Data Directory>/systemのファイル名とディレクトリ名 (例: ビルドアーティファクトストレージ)。
外部 ID の割り当て
デフォルトでは、TeamCity は ID の要件に一致するように名前を変換し、それに親プロジェクトの ID を前に付けることによって、オブジェクトの ID を自動的に提示します。ID は手動で変更できます。
それらを変更するための特別な考慮事項がない限り、自動的に生成された ID をそのままにすることをお勧めします。
複数の TeamCity サーバーインストール間でプロジェクトを移動することを検討している場合は、すべての ID がグローバルに一意であることを確認することをお勧めします。
すべてのプロジェクト、VCS ルート、ビルド構成、テンプレートのデフォルトスキームと一致するように ID をリセットするには、親プロジェクトの管理ページで一括編集 ID アクションを使用します。自動生成された ID を変更した後、または既存のオブジェクト名を変更した後で使用するには、ID を再生成アクションを使用して ID を再生成できます。
プロジェクトをコピーすると、TeamCity はすべての子要素に新しい ID を自動的に割り当てます。ID は、コピーダイアログでプレビューおよび変更できます。オブジェクトを移動すると、その ID は保持されます。ID を再生成アクションを使用して、ID に新しい配置を反映させることができます。
普遍的にユニークな ID
TeamCity プロジェクト、ビルド構成、VCS ルートには、自動的に生成されるグローバルに一意の ID である UUID があります。UUID は、 <TeamCity Data Directory> /config ディレクトリにある対応するエンティティ XML 構成ファイルに保存されます。これらの UUID は手動で編集しないでください。データディレクトリにファイルを配置して新しいエンティティを作成する場合、そのエンティティには uuid 属性があってはなりません。TeamCity は UUID を自動的に生成し、ファイル内に保持されます。
関連ページ：
プロジェクト管理者ガイド
このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...
ビルドの管理
このセクションには、TeamCity の既存のビルド構成の管理に関連する記事が含まれています。その内容については、サイドバーを参照してください。それらを作成および構成する方法については、このセクションに進んでください。2025 年 4 月 07 日リスクグループテストを最初に実行するビルドの主なアクション
ビルド構成テンプレート
構成テンプレートを作成するを使用すると、ビルド構成設定の重複を排除できます。類似した (必ずしも同一ではない) ビルド構成が複数あり、各構成を編集せずに 1 か所で共通設定を変更できるようにするには、それらの設定を含むビルド構成テンプレートを作成します。テンプレート設定を変更すると、このテンプレートに関連付けられているすべてのビルド構成に影響します。プロジェクトとそのサブプロジェクト内のすべてのビルド構成に対して、プロジェクト内のデフォルトテンプレートを定義することができます。詳細については、以...
VCS ルートの設定
VCS ルートは、TeamCity ←→ VCS リポジトリ通信の基礎です。この不可欠な要素は、リポジトリのチェックアウト、コードソースのタグ付け、ビルドステータスの VCS への返信など、さまざまな操作を実行するために必要な VCS プロバイダーへの接続を定義します。VCS ルートには次の情報が保存されます。TeamCity がリモートファイルをプルおよびプッシュするために使用する URL を取得してプッシュします。ブランチ情報: TeamCity が追跡する必要があるリポジトリブランチのリスト...
TeamCity データディレクトリ
TeamCity データディレクトリは、TeamCity サーバーが構成、ビルド結果、現在の操作ファイルを保存するために使用するファイルシステム上のディレクトリです。このディレクトリは、すべての構成設定の 1 次ストレージであり、TeamCity のインストールに不可欠なデータを保持します。ビルド履歴、ユーザーとそのデータ、その他のデータはデータベースに保存されます。ディレクトリとデータベースに保存されるデータの説明については、バックアップに関する注意事項を参照してください。このドキュメントや他...
ビルド状態
プロジェクトページのビルド構成の拡大表示に、ビルド状態アイコンが各ビルドの横に表示されます。構築国：正常に実行ビルドは正常に実行されています。成功指定されたすべてのビルド構成でビルドが正常に終了しました。実行中および失敗ビルドが失敗しています。失敗少なくとも 1 つの指定されたビルド構成でビルドが失敗しました。キャンセルビルドは取り消されました。キャンセル / 中止ビルド実行中のビルドを停止すると、ビルドステータスがキャンセル済みとして表示されます。実行中のビルドは、