将组织从 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	源组织的 personal access token。 有关要求，请参阅“管理 GitHub 产品之间迁移的访问权限”。
targetAccessToken	目标企业的 personal access token。

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

步骤 3：检查迁移状态

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

查询将返回状态，告知迁移是 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：验证迁移并检查错误日志