从 GitHub.com 向 GitHub Enterprise Cloud 迁移代码库

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

步骤 0：准备好使用 GitHub GraphQL API

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

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

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

作为 GitHub Enterprise Cloud 中的组织所有者，使用 GetOrgInfo 查询返回您希望拥有已迁移存储库的组织的 ownerId，也称为组织 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。

您的迁移源是 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
    }
  }
}

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

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

查询变量	说明
sourceId	您的迁移源 id 从 createMigrationSource 突变返回。
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://github.com/{organization}/{repository}。

有关个人访问令牌要求，请参阅“管理 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
    }
  }
}

查询变量	说明
id	id 是 startRepositoryMigration 突变 返回的迁移。

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

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

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

gh extension upgrade github/gh-gei

gh gei generate-script --github-source-org SOURCE --github-target-org DESTINATION --output FILENAME

gh gei generate-script --github-source-org SOURCE --github-target-org DESTINATION --output FILENAME

gh gei migrate-repo --github-source-org SOURCE --source-repo CURRENT-NAME --github-target-org DESTINATION --target-repo NEW-NAME

gh gei migrate-repo --github-source-org SOURCE --source-repo CURRENT-NAME --github-target-org DESTINATION --target-repo NEW-NAME

gh gei abort-migration --migration-id MIGRATION-ID

gh gei abort-migration --migration-id MIGRATION-ID