Perforce

使用 Perforce Streams

选择 Stream 选项以使用现有的 Perforce stream。 TeamCity 将使用此流来准备基于流的工作区，并调整其客户端映射。

关于使用此模式的注意事项：

• Stream 字段格式：

  • 支持深层结构规范，即像 //DEPOTNAME/1/2/n 这样的路径。

  • 支持 build parameters。

• 要使用 StreamAtChange 选项，您需要定义 Label / changelist to sync。

• 当使用 代理端签出（agent-side checkout） 模式 时，支持简单的 checkout rules，如 . => sub / directory。 排除检出规则、多重包含规则，或像 aaa=>bbb 这样的规则，只有在启用“创建非流工作区”选项时才支持（参见下面的 下方）。

• 当任务流用于功能分支时，TeamCity可能会遗漏一些任务流中的更改，直到进行了修改提交，这意味着，直到对任务流进行了真正的提交，父流中的合并提交才会被检测到（请参见工单 TW-44765）。

• 请注意，TeamCity 中的 Perforce 支持将检出规则视为区分大小写。 对基于 Perforce 的构建配置启用不区分大小写，可以在 版本控制设置 页面中通过在 编辑检出规则 表格中添加以下注释来实现： ##teamcity 忽略大小写。

在“启用功能分支支持"选项中，您可以指定要监视的分支流，以便查看是否发生了更改，这是在默认分支流的基础上添加的。 阅读更多 关于这个功能的信息。

使用 Perforce 客户端

Client 选项允许您直接指定客户端工作区的名称。 工作区必须已经由 Perforce 客户端应用程序（如 P4V 或 P4Win）创建。 仅使用配置的客户端工作区的映射规则。 客户端名称被忽略。

关于使用此模式的注意事项：

• 当这个选项与 server-side checkout 一起使用时，服务器端的内部 TeamCity 源缓存将被禁用。 这可能会使 clean checkouts 的性能恶化。

• 如果构建配置具有配置参数 teamcity.perforce.agent.reuse.client=true 并使用默认的签出规则，TeamCity 将不会在代理上创建另一个 Perforce 工作区，并会尝试重用现有的 Perforce 客户端，名称在 Perforce VCS 根中指定。

将 Perforce Depot 映射到客户端

Client mapping 选项允许指定仓库到客户端机器的映射。

关于使用此模式的注意事项：

• 客户端映射 字段格式：

  • TeamCity 将根据运行构建的构建代理的 OS / 平台处理文件分隔符。 为了能在所有构建代理中使用特定的行分隔符，请选择 客户端 或 流 选项（在 Perforce 中指定 LineEnd）。 或者，您可以添加一个 代理要求，以便只在特定平台上运行构建。

  • 在映射中使用 team-city-agent 而不是客户名称。
    例如：

    //depot/MPS/... //team-city-agent/... //depot/MPS/lib/tools/... //team-city-agent/tools/...

• 如果在两次构建之间更改了直接客户端映射，那么第二次构建 将会强制进行 清理检出，除非在服务器上设置了 teamcity.perforce.enable-no-clean-checkout 内部属性。

• 当以下情况发生时，更改客户端映射 不会强制 代理端签出进行清理：

  • Perforce 客户端名称已被使用：更改客户端的 Perforce 客户端映射不会导致进行干净的检出。

  • 使用了 Perforce 流：在保持相同的流根的同时更改流名称，不会导致干净的检出。

Perforce 工作区参数

TeamCity 将每个 Perforce VCS 根的连接变量存储在以下参数中：

• % \vcsRoot.extId.port %

• % \vcsRoot.extId.user %

• % \vcsRoot.extId.p4client %

在其中 extId 是 VCS 根的外部 ID，已在其设置中指定。

这样，您可以分别为每个根从脚本中访问它们。

在代理上进行检出时，TeamCity 提供了描述在检出过程中创建的 Perforce 工作区的环境变量
。如果用于检出的 Perforce VCS 根有多个，那么变量是为 第一个 VCS 根创建的。 变量是：

• P4USER—— 和 vcsroot.<VCS_root_ID>.user 构建参数 相同。

• P4PORT — 同 vcsroot.<VCS_root_ID>.port 一样。

• P4CLIENT—— 同 vcsroot。<VCS root ID>。p4client ，这是在构建代理上生成的 P4 工作空间的名称。

这些变量可用于在签出后执行自定义的 p4 命令。

查看 更多详情

Perforce Proxy 设置

为了允许在 代理端检出 时使用 Perforce 代理，您需要在 构建代理 上指定 env.TEAMCITY_P4PORT 环境变量，代理将会把这个值当作 P4PORT 值。