エンティティ ID
ID は、TeamCity エンティティ (プロジェクト、 ビルド構成、 テンプレート、 VCS ルートなど) に付与される識別子です。
各エンティティには 2 つの識別子があります。
外部 ID
いわゆる 外部識別子 は、TeamCity ウェブ UI (プロジェクト ID など) で設定され、サーバー全体で同じ種類のすべてのオブジェクト間で一意である必要があります。 ビルド構成とテンプレートは同じ ID スペースを共有します。
ID はラテン文字で始まり、ラテン文字、数字、アンダースコアのみで構成する必要があります。
外部 ID の使用
外部 ID が使用されます。
ウェブインターフェースの URL (NuGet フィードを含む) 内、たとえば
https://teamcity.jetbrains.com/project.html?projectId=TeamCityPluginsByJetBrains；TeamCity でのアクションを自動化するために使用される REST API とビルドスクリプト内 (たとえば、直接 URL または Ivy 経由でアーティファクトをダウンロードする場合)；
<TeamCity データディレクトリ>/設定にあるプロジェクトとビルド構成の設定を保存する構成ファイル内 ;<TeamCity データディレクトリ>/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 データディレクトリ>/設定 ディレクトリにある対応するエンティティ XML 構成ファイルに保存されます。 これらの UUID は手動で編集しないでください。 データディレクトリにファイルを配置して新しいエンティティを作成する場合、そのエンティティには uuid 属性があってはなりません。 TeamCity は UUID を自動的に生成し、UUID はファイル内に保持されます。