将存储库从 GitHub.com 迁移到 GitHub Enterprise Cloud

步骤 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）。您需要 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。

您的迁移源是 GitHub.com 上的一个组织。

createMigrationSource 变异

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

createMigrationSource 响应

{
  "data": {
    "createMigrationSource": {
      "migrationSource": {
        "id": "MS_kgDaACQxYmYxOWU4Yi0wNzZmLTQ3NTMtOTdkZC1hNGUzZmYxN2U2YzA",
        "name": "GitHub.com Source",
        "url": "https://github.com",
        "type": "GITHUB_SOURCE"
      }
    }
  }
}

在此示例中，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
    }
  }
}

有关个人访问令牌要求，请参阅“管理 GitHub 产品之间迁移的访问权限”。

在下一步中，您将使用 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
    }
  }
}

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

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

最后，建议您查看迁移的存储库以进行健全性检查。