将组织从 GitHub.com 迁移到 GitHub Enterprise Cloud

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

步骤 0：准备使用 GitHub GraphQL API

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

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

您将向迁移的**目标**发送所有 GraphQL 查询。如果您要迁移到具有数据驻留的 GitHub Enterprise Cloud，请确保将查询发送到您企业 GHE.com 子域的端点。

步骤 1：获取迁移目标的企业 ID

作为 GitHub.com 中的企业所有者，使用以下查询返回您希望拥有已迁移组织的企业帐户的 ID。您需要企业 ID 来识别迁移目标。

query(
  $slug: String!
){
  enterprise (slug: $slug)
  {
    slug
    id
  }
}

查询变量	描述
slug	您企业帐户的 slug，您可以通过查看企业 URL 来识别，例如 https://github.com/enterprises/SLUG 或 https://SLUG.ghe.com。

步骤 2：开始组织迁移

开始迁移时，单个组织及其伴随数据会迁移到您标识的目的地企业中的一个全新的组织中。

mutation startOrganizationMigration (
  $sourceOrgUrl: URI!,
  $targetOrgName: String!,
  $targetEnterpriseId: ID!,
  $sourceAccessToken: String!,
	$targetAccessToken: String!
){
  startOrganizationMigration( input: {
    sourceOrgUrl: $sourceOrgUrl,
    targetOrgName: $targetOrgName,
    targetEnterpriseId: $targetEnterpriseId,
    sourceAccessToken: $sourceAccessToken,
		targetAccessToken: $targetAccessToken
  }) {
    orgMigration {
      id
    }
  }
}

查询变量	描述
sourceOrgUrl	源组织的 URL，例如 https://github.com/octo-org。
targetOrgName	您希望新组织具有的名称。在您的目标平台上不能与其他组织共享。
targetEnterpriseId	您要在其中创建新组织的企业的 ID，由步骤 2 返回。
sourceAccessToken	源组织的个人访问令牌（传统）。有关要求，请参阅“管理 GitHub 产品之间迁移的访问权限”。
targetAccessToken	目标企业的个人访问令牌（传统）。

在下一步中，您将使用从 startOrganizationMigration 突变返回的迁移 ID 来检查迁移状态。

步骤 3：检查迁移状态

为了检测任何迁移失败并确保您的迁移正常工作，您可以查询您创建的`OrganizationMigration`，使用`getMigration`查询查看迁移状态。

查询将返回一个状态，让您知道迁移是`queued`（排队）、`in progress`（进行中）、`failed`（失败）还是`completed`（已完成），以及有关有多少存储库正在等待迁移的信息。如果您的迁移失败，导入器将提供失败原因。

query (
  $id: ID!
){
  node( id: $id ) {
    ... on OrganizationMigration {
      id
			sourceOrgUrl
			targetOrgName
      state
      failure_reason
      remaining_repositories_count
      total_repositories_count
    }
  }
}

查询变量	描述
id	您的迁移的`id`。

gh extension upgrade github/gh-gei

gh gei migrate-org --github-source-org SOURCE --github-target-org DESTINATION --github-target-enterprise ENTERPRISE

gh gei migrate-org --github-source-org SOURCE --github-target-org DESTINATION --github-target-enterprise ENTERPRISE

步骤 4：验证您的迁移并检查错误日志