将代码库从 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 的目标仓库中创建的。

最后，我们建议您审查已迁移的仓库以进行完整性检查。