实体 ID
一个 ID 是赋予 TeamCity 实体(项目、构建配置、模板、VCS 根 等等)的标识符。
每个实体都有两个标识符:
Universally Unique ID,或者 UUID
外部 ID
所谓的 外部标识符 是在 TeamCity 网络用户界面中配置的(例如,项目 ID)并且在整个服务器上,同类型的所有对象中必须是唯一的。 构建配置和模板共享相同的 ID 空间。
ID 只能包含字母数字和下划线 ( _
) — 最多 80 个字符 — 并且应该以拉丁字母开头。
使用外部 ID
使用外部 ID:
在网络界面的URL中(包括 NuGet 供稿),例如,
https://teamcity.jetbrains.com/project.html?projectId=TeamCityPluginsByJetBrains
;在 REST API 和用于自动化 TeamCity 操作的构建脚本中(例如,通过直接 URL 或 Ivy 下载工件);
在配置文件中存储
<TeamCity 数据目录>/config
下的项目和构建配置的设置。在
<TeamCity 数据目录>/system
下的文件和目录名中(例如,构建工件存储)。
分配外部 ID
默认情况下,TeamCity 会自动为对象建议一个 ID,它会将其名称转换以匹配 ID 的要求,并以父项目的 ID 作为前缀。 ID 可以手动修改。
建议保留自动生成的 ID,除非有特殊考量才需要修改它们。
如果您考虑在几个 TeamCity 服务器安装之间移动项目,确保所有 ID 全球唯一是一个好习惯。
要将所有项目、VCS 根、构建配置和模板的 ID 重置为匹配默认方案,请在父级 项目的 管理页面上使用 批量编辑 ID操作。 要使用修改后的自动生成ID,或者在更改现有对象名称后,您可以使用 重新生成ID 操作来重新生成ID。
当您复制一个项目时,TeamCity会自动为所有子元素分配新的ID。 ID 可以在 复制 对话框中预览和修改。 当您移动对象时,其 ID 会被保留,您可能希望使用 Regenerate ID 操作使 ID 反映新的位置。
通用唯一 ID
TeamCity 项目、构建配置和 VCS 根都有一个 UUID ,这是一个自动生成的,全球唯一的 ID。 UUID 存储在位于 <TeamCity 数据目录>/config
目录中的相应实体 XML 配置文件中。 这些 UUID 绝对不能手动编辑。 当通过将文件放置到数据目录来创建新的实体时,它不应具有任何 uuid
属性。 TeamCity会自动生成UUID,并将其持久化在文件中。