项目导入

在选择备份文件后，您需要指定将导入哪些项目。

TeamCity 将分析选定的项目，以查看它们是否将被导入、合并或跳过。

• 如果该项目对于目标服务器是新的，则该项目将被 已导入。 所有的实体（包括构建配置，模板，构建等等）及其数据将在目标服务器上创建。

• 如果相同的项目已存在于目标服务器上（如果源项目和目标项目具有相同的 UUID和 外部 ID ），则该项目将被 已合并。
  在合并过程中，现有实体将保持不变，仅导入目标服务器的新实体及其相关数据。
  现有实体的数据不会被导入或合并：不会向现有实体添加新数据（例如，不会向现有的 VCS 根添加更改），现有文件也不会被更改（例如，如果两个服务器上存在相同的模板但设置不同，则目标文件将被保留）。
  这意味着，例如，您无法将缺失的构建导入到现有的构建配置中。 如果您需要向现有实体添加缺失的数据，例如，将新的构建导入到已导入的构建配置中，您应当使用用户界面删除此构建配置，并重新导入其项目。

• 如果发生 冲突 ，则该项目将被 跳过的 ：要么项目的 UUID是新的，但其 外部 ID已存在于目标中；要么源项目和目标项目具有相同的 UUID但不同的 外部 ID。

您可以选择导入范围：在项目设置、构建和更改历史以及用户帐户中进行选择，或者导入所有内容。 由于导入的项目也可以使用其父项目的设置，因此 TeamCity 也将为父项目导入所有的 vcs 根、模板、Meta-Runner (元运行器)和其他与项目相关的设置。 如果同一项目已经存在于目标服务器上，已存在的对象不会被覆盖。

对于每个导入或合并的项目，只要它们对目标服务器来说是新的，配置文件将被导入到目标服务器的 Data Directory。 现有文件将不会被更改。

以下文件已导入：

• 该项目的配置 xml 文件，包括其构建配置、模板和 VCS Roots，以及其子项目。

• 来自 <TeamCity Data Directory>/plugins 目录的所有文件。

• 为新添加的构建配置创建构建编号文件。

当选择用户进行导入时，TeamCity 将分析用户名以确定用户是 已导入 还是 已合并。

TeamCity 用户必须拥有唯一的用户名。

• 对于目标服务器来说用户名是新的用户帐户将被 已导入。 这些用户会在目标服务器上以一个单独的组的形式出现，标记为 已导入 <导入日期时间>。 所有相关的数据（个人构建、更改、测试静音和调查）将在目标服务器上创建。 用户帐户设置 （角色、权限、VCS 名称、通知设置等：系统范围的设置以及与导入项目相关的设置）在导入期间将被保留。

• 源服务器和目标服务器上具有相同用户名的用户帐户可以被 已合并。 在合并过程中，现有数据将保持不变，仅添加目标服务器的新数据：所有与用户相关的新数据（个人构建、更改、测试静音和调查）以及 用户帐户设置 （角色、权限、VCS 名称、通知设置等：系统范围的设置以及与导入项目相关的设置）将被添加到目标服务器上的用户。
  （！）如果源服务器和目标服务器上相同的用户名属于不同的用户，合并可能会导致问题：在导入过程中，用户信息仍会被合并。
  注释 这可能会导致目标服务器上的用户权限范围在导入后发生变化，例如：

  • 如果用户在源系统中拥有系统管理员角色，那么在导入后，该角色将被添加到目标系统的用户中。

  • 如果用户在源上有多个项目的多个角色，只有在导入范围内的项目的新角色将被添加到目标中。

  项目导入 | 导入范围 | 用户 部分将显示冲突的数量，您可以查看并决定是否要合并它们。

  TeamCity 将在两个服务器上显示具有相同用户名和不同电子邮件的用户，以及具有相同用户名和相同电子邮件的用户数量。 电子邮件验证 可以被启用 于服务器，且具有相同用户名和电子邮件的用户将基于他们的电子邮件验证进行比较。 您可以查看冲突信息，并选择是否合并找到的用户。 如果在源 TeamCity 服务器或目标 TeamCity 服务器上，或者两者都存在已验证电子邮件的用户，那么选项将处于活动状态。

用户组的导入工作方式相同：会导入新的组，而现有的组可以合并。

如果发生 冲突 （源和目标上都存在群组，但群组角色不同），在导入后，目标服务器上的群组可能会获取额外的角色。 因此，此组在目标上的成员也将获得额外的角色和权限。

项目导入 页面 | 导入范围 部分 | 组 将显示发现了多少冲突组。 您可以查看所有具有相同群组键的群组，并决定是否要合并它们。 请注意， "All Users" 组 总是会被列为冲突，因为它是所有 TeamCity 服务器上的默认组。

如果备份文件中的实体与目标服务器上的某些实体存在冲突，TeamCity 不会导入这些实体。 在导入之前，TeamCity 会分析备份文件并在 导入范围 配置页面上显示所有检测到的冲突。

在继续导入之前， 强烈建议您解决所有冲突 是必要的，因为未解决的冲突可能会导致导入后出现不可预测的行为，例如：

• 如果例如，某些 VCS Root 被跳过，但依赖于它的 Build Configuration 被导入，可能会显示出关键错误。

• 导入的构建配置可能会引用错误的模板，如果源服务器和目标服务器的模板之间存在未解决的 external IDs 冲突。

如果在导入之前没有解决冲突，您可以在导入结果日志下的 冲突文件 目录中找到冲突文件。