将组织从 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，以及有关有多少个存储库等待迁移的信息。如果您的迁移失败，Importer 将提供失败原因。

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