将组织从 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：验证迁移并检查错误日志