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