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

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