通过


完成迁移先决条件

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

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

更新Azure DevOps Server

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

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

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

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

实现Microsoft Entra ID

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

Tip

  • 建议使用与其他Microsoft Cloud服务相同的Microsoft Entra ID租户。 如果公司已有Microsoft Entra ID,请跳过此步骤。
  • 虽然 Microsoft 帐户 (MSA) 可用于 Azure DevOps 服务的身份验证,但它们无法在 Azure DevOps Server 数据库迁移期间进行映射。
  • 如果Microsoft Entra租户启用了 Restrict 组织创建策略,则使用 Azure DevOps 迁移工具执行的任何数据导入操作都失败,除非将导入用户显式添加到允许列表。 若要确保成功导入::
    • 暂时将导入用户添加到允许列表。
    • 添加到允许列表的用户必须与用于迁移的 import.json 文件中指定的 AccountOwner 匹配。
    • 有关配置允许列表的详细信息,请参阅 “限制组织创建”。

使用 Microsoft Entra ID Connect 同步身份和组

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

若要设置同步,请执行以下步骤:

  1. 利用 Microsoft Entra ID Connect 技术。
  2. 若要配置Microsoft Entra ID连接到本地环境,请与 IT 部门、DevOps 合作伙伴、Microsoft顶级支持或Microsoft咨询服务协作。

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

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

Note

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

下载Azure DevOps数据迁移工具

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

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

准备好以下物品:

  • SQL Server 中的 TFSEXECROLE 角色。
  • 连接到Azure DevOps Server配置和集合数据库的权限。
  • 您的Azure DevOps服务组织与您的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 参数。

后续步骤