将仓库从 Azure DevOps 迁移到 GitHub Enterprise Cloud

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

步骤 0：准备使用 GitHub GraphQL API

要进行 GraphQL 查询，您需要编写自己的脚本或使用像 Insomnia 这样的 HTTP 客户端。

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

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

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

GetOrgInfo 查询

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

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

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
    }
  }
}

查询变量	描述
名称	您的迁移源的名称。此名称仅供您自己参考，因此您可以使用任何字符串。
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}/_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	您的迁移的 id，startRepositoryMigration 变异 返回。

步骤 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