通过

完成迁移的先决条件

  • 项目

使用 Azure DevOps 数据迁移工具迁移到 Azure DevOps Services 的第二个阶段时，必须完成将数据传输到云的先决条件。 如果组织已满足这些先决条件，则可以完全跳过此阶段。

按连续阶段突出显示先决条件阶段的图表。

更新 Azure DevOps Server

Azure DevOps 的数据迁移工具在给定时间支持两个最新版本的 Azure DevOps Server。 版本包括更新和主要版本。

Azure DevOps Server 的新 RTW 版本发布后，可能需要 2-3 周的时间才能上线该版本的迁移支持。 在新的 RTW Azure DevOps Server 发布后不久选择升级时，请考虑这种可能性。

数据迁移工具不支持从 Azure DevOps Server 候选发布 (RC) 迁移。 如果计划使用此服务将集合数据库迁移到 Azure DevOps Services，请务必不要将生产数据库升级到 RC 版本。 如果升级，则必须等待并升级到 Web (RTW) 版本（如果可用）。 或者，从以前的 Azure DevOps Server 版本还原数据库的备份副本以迁移。 无法降级到以前的 Azure DevOps 版本，只能使用该版本的数据库备份进行还原。

新 Azure DevOps Server 版本的正常发布节奏每三到四个月一次。 这意味着，对用于迁移到 Azure DevOps Services 的给定版本的 Azure DevOps Server 的支持应持续 6 到 8 个月。 重要的是要确保你的计划考虑到此支持窗口，以避免不得不突然升级以进行迁移。

实现 Microsoft Entra ID

确保团队具有用于对 Azure DevOps Services 组织中成员进行身份验证的功能Microsoft Entra ID 租户。 在 Azure DevOps Services 中，用户身份验证依赖于 Microsoft Entra ID 租户，例如 Azure DevOps Server 用户身份验证依赖于 Active Directory。 在测试运行阶段（链接）中，验证标识映射日志文件，以确认本地 Active Directory 组织与 Microsoft Entra ID 组织的一致性。 迁移服务不使用此文件。 此操作可确保个人历史记录可见性、安全权限保留和对个人设置的访问权限。

提示

  • 建议使用与其他 Microsoft 云服务相同的 Microsoft Entra ID 租户。 如果公司已有Microsoft Entra ID，请跳过此步骤。
  • 虽然 Microsoft 帐户 (MSA) 可用于 Azure DevOps Services 的身份验证，但在 Azure DevOps Server 的数据库迁移期间无法对其进行映射。

使用 Microsoft Entra ID Connect 同步标识和组

将本地 Active Directory 与 Microsoft Entra ID 同步，以便团队成员可以使用相同的凭据进行身份验证。 此外，Azure DevOps Services 管理员可以使用 Active Directory 组在组织内设置权限。

若要设置同步，请执行以下步骤：

  1. 利用 Microsoft Entra ID Connect 技术。
  2. 为了配置 Microsoft Entra ID Connect 与本地环境，请与 IT 部门、DevOps 合作伙伴、Microsoft 高级支持或 Microsoft 咨询服务协作。

有关设置 Microsoft Entra ID Connect 的详细信息，请参阅 Microsoft Entra Connect Sync。

此外，了解如何通过访问此页面将 Azure DevOps Services 配置为使用 Microsoft Entra ID。 尽管本文中的步骤与 Team Foundation Server 数据库迁移不完全一致，但它可用作有价值的参考信息。 数据迁移工具会在迁移过程开始时，在创建 Azure DevOps Services 组织的过程中，建立与 Microsoft Entra ID 租户的链接。

注意

DirSync 是Microsoft Entra ID Connect 的前置技术。 如果使用 DirSync，请升级到 Microsoft Entra ID Connect。

下载 Azure DevOps 数据迁移工具

整个迁移到 Azure DevOps Services 的大部分工作都由数据迁移工具处理。 该工具可用于以下高级步骤：

  1. 验证团队项目集合。
  2. 生成用于自定义迁移的文件。
  3. 将 Azure DevOps Server 数据库队列迁移到 Azure DevOps Services。

准备好以下物品：

  • SQL Server 中的 TFSEXECROLE 角色。
  • 连接到 Azure DevOps Server 配置和集合数据库的权限。
  • Azure DevOps Services 组织和 Microsoft Entra ID 租户之间已建立的链接。

下载该工具

  1. 下载最新版本的 数据迁移工具。
  2. 将 zip 文件复制到 Azure DevOps Server 应用程序层之一。
  3. 解压缩文件。 如果可以连接到 Azure DevOps Server 实例的配置数据库，那么也可以从未安装 Azure DevOps Server 的其他计算机运行该工具。 1.打开服务器上的命令提示符窗口，并转到存储数据迁移工具的目录。
  4. 查看该工具的帮助内容：
    1. 若要查看顶级帮助和指南，请运行以下命令：
      Migrator /help
    2. 查看验证命令的帮助文本：Migrator validate /help 首次验证集合时，请保持简单。 命令应具有以下结构：Migrator validate /collection:{collection URL} /tenantDomainName:{name} /region:{region}
  5. 将 {name} 替换为 Microsoft Entra 租户的名称。 例如，若要针对 DefaultCollection 和 fabrikam 租户运行，命令如下所示：Migrator validate /collection:[^1^][4] (http://localhost:8080/DefaultCollection) /tenantDomainName:fabrikam.OnMicrosoft.com /region:{region} 如果需要从 Azure DevOps Server 以外的计算机运行该工具，请使用 /connectionString 参数。

后续步骤

验证并准备迁移