TeamCity On-Premises 2024.03 Help

实体 ID

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

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

外部 ID

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

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

使用外部 ID

使用外部 ID:

分配外部 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,并将其持久化在文件中。

最后修改日期: 16日 7月 2024年