为 GitHub Enterprise Importer 授予迁移者角色

本文内容

若要允许非组织所有者的某人运行迁移，可以向个人或团队授予迁移者角色。

谁可以使用此功能

Organization owners can grant the migrator role.

Tool navigation

关于迁移者角色

为了使组织所有者不再需要完成迁移，GitHub.com 包含使用 GitHub Enterprise Importer 的不同角色。 通过授予迁移者角色，可以指定其他团队或个人来处理迁移。

可以将迁移者角色授予单个用户或团队。 强烈建议将迁移者角色分配给团队。 然后，可以通过调整团队成员身份来进一步自定义可运行迁移的人员。 有关更改团队成员身份的详细信息，请参阅“添加组织成员到团队”或“从团队中删除组织成员”。

只能为 GitHub.com 上的组织授予迁移者角色。 如果要在 GitHub.com 上的两个组织之间迁移存储库，则可以将迁移者角色授予两个组织的同一个人或团队，但必须分别授予。

注意：不能为企业帐户授予迁移者角色。 因此，只有当你是目标企业的所有者时，你才能运行组织迁移。 但是，可以将迁移者角色授予源组织的企业所有者。

授予迁移者角色后，请确保迁移者使用的 personal access token 满足运行迁移的所有要求。 有关这些要求的详细信息，请参阅“管理 GitHub Enterprise Importer 的访问权限”。

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

使用 ADO2GH extension

授予迁移者角色

  1. 在 GitHub.com 上，创建并记录满足授予迁移者角色的所有要求的 personal access token。 有关要求的完整列表，请参阅“管理 GitHub Enterprise Importer 的访问权限”。

  2. 将 personal access token 设置为环境变量，将以下命令中的 TOKEN 替换为你在上面记录的 personal access token。

    • 如果使用终端，请使用 export 命令。

      Shell
      export GH_PAT="TOKEN"

    • 如果使用 PowerShell，请使用 $env 命令。

      Shell
      $env:GH_PAT="TOKEN"

  3. 使用 gh ado2gh grant-migrator-role 命令，将 ORGANIZATION 替换为你要为其授予迁移者角色的组织，将 ACTOR 替换为用户或团队名称，并将 TYPE 替换为 USER 或 TEAM。

    Shell
    gh ado2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE

使用 BBS2GH extension

授予迁移者角色

  1. 在 GitHub.com 上，创建并记录满足授予迁移者角色的所有要求的 personal access token。 有关要求的完整列表，请参阅“管理 GitHub Enterprise Importer 的访问权限”。

  2. 将 personal access token 设置为环境变量，将以下命令中的 TOKEN 替换为你在上面记录的 personal access token。

    • 如果使用终端，请使用 export 命令。

      Shell
      export GH_PAT="TOKEN"

    • 如果使用 PowerShell，请使用 $env 命令。

      Shell
      $env:GH_PAT="TOKEN"

  3. 使用 gh bbs2gh grant-migrator-role 命令，将 ORGANIZATION 替换为你要为其授予迁移者角色的组织，将 ACTOR 替换为用户或团队名称，并将 TYPE 替换为 USER 或 TEAM。

    Shell
    gh bbs2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE

使用 GEI extension

授予迁移者角色

注意：GitHub CLI 不支持为 GitHub Enterprise Server 上的组织授予迁移者角色，因此必须是源组织的组织所有者才能从 GitHub Enterprise Server 迁移存储库。

  1. 在 GitHub.com 上，创建并记录满足授予迁移者角色的所有要求的 personal access token。 有关要求的完整列表，请参阅“管理 GitHub Enterprise Importer 的访问权限”。

  2. 将 personal access token 设置为环境变量，将以下命令中的 TOKEN 替换为你在上面记录的 personal access token。

    • 如果使用终端，请使用 export 命令。

      Shell
      export GH_PAT="TOKEN"

    • 如果使用 PowerShell，请使用 $env 命令。

      Shell
      $env:GH_PAT="TOKEN"

  3. 使用 gh gei grant-migrator-role 命令，将 ORGANIZATION 替换为你要为其授予迁移者角色的组织，将 ACTOR 替换为用户或团队名称，并将 TYPE 替换为 USER 或 TEAM。

    Shell
    gh gei grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE

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

使用 GraphQL API 授予迁移者角色

可以使用 grantMigratorRole GraphQL 突变来分配迁移者角色，并使用 revokeMigratorRole 突变来撤销迁移者角色。

必须使用满足所有访问要求的 personal access token (PAT)。 有关详细信息，请参阅“管理 GitHub Enterprise Importer 的访问权限”。

grantMigratorRole 突变

此 GraphQL 突变设置迁移角色。

mutation grantMigratorRole (
  $organizationId: ID!,
  $actor: String!,
  $actor_type: ActorType!
) {
  grantMigratorRole( input: {
    organizationId: $organizationId,
    actor: $actor,
    actorType: $actor_type
  })
   { success }
}
查询变量说明
organizationId组织的 ownerId 或组织 ID（来自 GetOrgInfo 查询）。
actor要将迁移角色分配到的团队或用户名。
actor_type指定迁移者是 USER 还是 TEAM。

revokeMigratorRole 突变

此突变将删除迁移者角色。

mutation revokeMigratorRole (
  $organizationId: ID!,
  $actor: String!,
  $actor_type: ActorType!
) {
  revokeMigratorRole( input: {
    organizationId: $organizationId,
    actor: $actor,
    actorType: $actor_type
  })
   { success }
}