이 버전의 GitHub Enterprise는 다음 날짜에 중단되었습니다. 2023-09-25. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 더 뛰어난 성능, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise Server로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

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을(를) 환경 변수로 설정하고, 아래 명령의 토큰을 위에서 기록한 personal access token로 바꿉니다.

    • 터미널을 사용하는 경우 export 명령을 사용합니다.

      Shell
      export GH_PAT="TOKEN"

    • PowerShell을 사용하는 경우 $env 명령을 사용합니다.

      Shell
      $env:GH_PAT="TOKEN"

  3. gh ado2gh grant-migrator-role 명령을 사용하여 조직을 마이그레이션자 역할을 부여하려는 조직으로 대체하여 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을(를) 환경 변수로 설정하고, 아래 명령의 토큰을 위에서 기록한 personal access token로 바꿉니다.

    • 터미널을 사용하는 경우 export 명령을 사용합니다.

      Shell
      export GH_PAT="TOKEN"

    • PowerShell을 사용하는 경우 $env 명령을 사용합니다.

      Shell
      $env:GH_PAT="TOKEN"

  3. gh bbs2gh grant-migrator-role 명령을 사용하여 조직을 마이그레이션자 역할을 부여하려는 조직으로 대체하여 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을(를) 환경 변수로 설정하고, 아래 명령의 토큰을 위에서 기록한 personal access token로 바꿉니다.

    • 터미널을 사용하는 경우 export 명령을 사용합니다.

      Shell
      export GH_PAT="TOKEN"

    • PowerShell을 사용하는 경우 $env 명령을 사용합니다.

      Shell
      $env:GH_PAT="TOKEN"

  3. gh gei grant-migrator-role 명령을 사용하여 조직을 마이그레이션자 역할을 부여하려는 조직으로 대체하여 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 }
}
쿼리 변수설명
organizationIdGetOrgInfo 쿼리의 조직에 대한 ownerId(또는 조직 ID)입니다.
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 }
}