通过

完成迁移的先决条件

  • 项目

使用 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 连接同步标识和组

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

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

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

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

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

注意

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

下载 Azure DevOps 数据迁移工具

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

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

必须具备以下项：

  • SQL Server 中的 TF标准版XECROLE 角色。
  • 连接到 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 。

后续步骤

验证并准备迁移