TeamCity On-Premises 2025.03 Help

实体 ID

一个 ID 是赋予 TeamCity 实体(项目构建配置模板VCS 根 等等)的标识符。

每个实体都有两个标识符:

外部 ID

所谓的 外部标识符 是在 TeamCity 网络用户界面中配置的(例如,项目 ID)并且在整个服务器上,同类型的所有对象中必须是唯一的。 构建配置和模板共享相同的 ID 空间。

ID 只能包含字母数字和下划线 (_) — 最多 80 个字符 — 并且应该以拉丁字母开头。

使用外部 ID

使用外部 ID:

分配外部 ID

默认情况下,TeamCity 会自动为对象建议一个 ID,它会将其名称转换以匹配 ID 的要求,并以父项目的 ID 作为前缀。 ID 可以手动修改。

建议保留自动生成的 ID,除非有特殊考量才需要修改它们。

如果您考虑在几个 TeamCity 服务器安装之间移动项目,确保所有 ID 全球唯一是一个好习惯。

要重置 ID 以匹配所有项目、VCS 根、构建配置和模板的默认方案,请在父 项目管理 页面上使用 批量编辑 ID 操作。 要在 ID 被修改后或更改现有对象名称后使用自动生成的 ID,您可以使用 重新生成 ID 操作重新生成 ID。

当您复制一个项目时,TeamCity会自动为所有子元素分配新的ID。 ID 可以在 复制 对话框中预览和修改。 当您移动一个对象时,其 ID 会被保留,您可能需要使用 重新生成 ID 操作使 ID 反映新的位置。

通用唯一 ID

TeamCity 项目、构建配置和 VCS 根都有一个 UUID ,这是一个自动生成的,全球唯一的 ID。 UUID 存储在位于 <TeamCity Data Directory>/配置 目录中的相应实体 XML 配置文件中。 这些 UUID 绝对不能手动编辑。 当通过将文件放置到数据目录来创建新的实体时,它不应具有任何 uuid 属性。 TeamCity会自动生成UUID,并将其持久化在文件中。

最后修改日期: 2025年 3月 21日