将存储库从 Azure DevOps 迁移到 GitHub Enterprise Cloud

要查看使用 GitHub CLI 的说明，请使用页面顶部的工具切换器。

步骤 0：准备使用 GitHub GraphQL API

要执行 GraphQL 查询，您需要编写自己的脚本或使用 HTTP 客户端，例如 Insomnia。

要了解有关 GitHub GraphQL API 入门的更多信息，包括如何进行身份验证，请参阅“使用 GraphQL 形成调用”。

您将向迁移的**目标**发送所有 GraphQL 查询。如果您要迁移到具有数据驻留区的 GitHub Enterprise Cloud，请确保将查询发送到 GHE.com 上您企业子域的端点。

步骤 1：获取迁移目标的 ownerId

作为 GitHub Enterprise Cloud 中的组织所有者，请使用 GetOrgInfo 查询返回 ownerId（也称为组织 ID），该 ID 用于标识您希望拥有迁移存储库的组织。您需要 ownerId 来识别您的迁移目标。

GetOrgInfo 查询

query(
  $login: String!
){
  organization (login: $login)
  {
    login
    id
    name
    databaseId
  }
}

查询变量	描述
login	您的组织名称。

GetOrgInfo 响应

{
  "data": {
    "organization": {
      "login": "Octo",
      "id": "MDEyOk9yZ2FuaXphdGlvbjU2MTA=",
      "name": "Octo-org",
      "databaseId": 5610
    }
  }
}

在此示例中，MDEyOk9yZ2FuaXphdGlvbjU2MTA= 是组织 ID 或 ownerId，我们将在下一步中使用它。

步骤 2：确定迁移来源

您可以使用 createMigrationSource 查询设置迁移源。您需要提供从 GetOrgInfo 查询中收集的 ownerId 或组织 ID。

您的迁移源是您的 ADO 组织。

createMigrationSource 变异

mutation createMigrationSource($name: String!, $ownerId: ID!) {
  createMigrationSource(input: {name: $name, url: "https://dev.azure.com", ownerId: $ownerId, type: AZURE_DEVOPS}) {
    migrationSource {
      id
      name
      url
      type
    }
  }
}

查询变量	描述
name	迁移源的名称。此名称仅供您参考，因此您可以使用任何字符串。
ownerId	您在 GitHub Enterprise Cloud 上的组织的组织 ID。

createMigrationSource 响应

{
  "data": {
    "createMigrationSource": {
      "migrationSource": {
        "id": "MS_kgDaACQxYmYxOWU4Yi0wNzZmLTQ3NTMtOTdkZC1hNGUzZmYxN2U2YzA",
        "name": "Azure Devops Source",
        "url": "https://dev.azure.com",
        "type": "AZURE_DEVOPS"
      }
    }
  }
}

在此示例中，MS_kgDaACQxYmYxOWU4Yi0wNzZmLTQ3NTMtOTdkZC1hNGUzZmYxN2U2YzA 是迁移源 ID，我们将在下一步中使用它。

步骤 3：开始您的存储库迁移

开始迁移时，单个存储库及其伴随数据将迁移到您标识的全新 GitHub 存储库中。

如果您想一次从同一源组织迁移多个存储库，则可以排队多个迁移。您可以同时运行最多 5 个存储库迁移。

startRepositoryMigration 变异

mutation startRepositoryMigration (
  $sourceId: ID!,
  $ownerId: ID!,
  $sourceRepositoryUrl: URI!,
  $repositoryName: String!,
  $continueOnError: Boolean!,
  $accessToken: String!,
  $githubPat: String!,
  $targetRepoVisibility: String!
){
  startRepositoryMigration( input: {
    sourceId: $sourceId,
    ownerId: $ownerId,
    repositoryName: $repositoryName,
    continueOnError: $continueOnError,
    accessToken: $accessToken,
    githubPat: $githubPat,
    targetRepoVisibility: $targetRepoVisibility
    sourceRepositoryUrl: $sourceRepositoryUrl,
  }) {
    repositoryMigration {
      id
      migrationSource {
        id
        name
        type
      }
      sourceUrl
    }
  }
}

查询变量	描述
sourceId	createMigrationSource 变异返回的迁移源 id。
ownerId	您在 GitHub Enterprise Cloud 上的组织的组织 ID。
repositoryName	自定义唯一的存储库名称，当前未被 GitHub Enterprise Cloud 上您组织拥有的任何存储库使用。迁移完成后或停止后，将在此存储库中创建错误日志问题。
continueOnError	迁移设置，允许在遇到不会导致迁移失败的错误时继续迁移。必须为 true 或 false。我们强烈建议将 continueOnError 设置为 true，以便您的迁移将继续进行，除非导入程序无法移动 Git 源或导入程序已断开连接且无法重新连接以完成迁移。
githubPat	GitHub Enterprise Cloud 上目标组织的个人访问令牌。
accessToken	源的个人访问令牌。
targetRepoVisibility	新存储库的可见性。必须为 private、public 或 internal。如果未设置，则您的存储库将作为私有存储库迁移。
sourceRepositoryUrl	源存储库的 URL，使用格式 https://dev.azure.com/{organization}/{project}/_git/{repository}。

有关个人访问令牌要求，请参阅“管理来自 Azure DevOps 的迁移的访问权限”。

在下一步中，您将使用 startRepositoryMigration 变异返回的迁移 ID 检查迁移状态。

步骤 4：检查迁移状态

为了检测任何迁移失败并确保您的迁移正常工作，您可以使用 getMigration 查询检查迁移状态。您还可以使用 getMigrations 检查多个迁移的状态。

getMigration 查询将返回一个状态，让您知道迁移是 queued、in progress、failed 还是 completed。如果您的迁移失败，导入程序将提供失败的原因。

getMigration 查询

query (
  $id: ID!
){
  node( id: $id ) {
    ... on Migration {
      id
      sourceUrl
      migrationSource {
        name
      }
      state
      failureReason
    }
  }
}

查询变量	描述
id	startRepositoryMigration 变异 返回的迁移 id。

步骤 5：验证迁移并检查错误日志

要完成迁移，我们建议您检查“迁移日志”问题。此问题是在 GitHub 上的目标存储库中创建的。

最后，我们建议您检查迁移的存储库，以确保其完整性。

gh extension upgrade github/gh-ado2gh

gh extension upgrade github/gh-ado2gh

gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME

gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME

gh ado2gh migrate-repo --ado-org SOURCE --ado-team-project TEAM-PROJECT --ado-repo CURRENT-NAME --github-org DESTINATION --github-repo NEW-NAME

gh ado2gh migrate-repo --ado-org SOURCE --ado-team-project TEAM-PROJECT --ado-repo CURRENT-NAME --github-org DESTINATION --github-repo NEW-NAME

gh ado2gh abort-migration --migration-id MIGRATION-ID

gh ado2gh abort-migration --migration-id MIGRATION-ID