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

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

步骤 0：准备使用 GitHub GraphQL API

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

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

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

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

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

查询变量	描述
slug	企业帐户的 slug，您可以在企业 URL 中找到它，例如 https://github.com/enterprises/SLUG。

步骤 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	您希望新组织的名称。必须在 GitHub.com 上唯一。
targetEnterpriseId	您要创建新组织的企业的 ID，由步骤 2 返回。
sourceAccessToken	源组织的个人访问令牌（经典）。有关要求，请参阅“管理 GitHub 产品之间迁移的访问权限”。
targetAccessToken	目的地企业的个人访问令牌（经典）。

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

步骤 3：检查迁移状态

为了检测任何迁移失败并确保您的迁移正常工作，您可以查询您创建的 OrganizationMigration(s) 以使用 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：验证您的迁移并检查错误日志