# 마이그레이션자 역할 부여하기

마이그레이션자 역할은 사용자 또는 팀에게 조직을 대신하여 마이그레이션을 실행할 수 있는 기능을 제공합니다.

조직 소유자 이외의 사용자가 마이그레이션을 실행하거나 마이그레이션 로그를 다운로드하도록 허용하려면 사용자 또는 팀에 마이그레이션자 역할을 부여할 수 있습니다.

CLI를 사용하여 마이그레이션자 역할을 부여하려면 다음을 GL2GH extension of the GitHub CLI사용할 수 있습니다.

1. GitHub CLI를 설치합니다.
   * GitHub CLI에 대한 설치 지침은 [GitHub CLI 리포지토리](https://github.com/cli/cli#installation)를 참조하세요.
   * 이미 GitHub CLI 설치한 경우 실행 `gh --version` 하여 버전 2.4.0 이상을 실행하고 있는지 확인합니다. 이전 버전이 있는 경우 업그레이드 지침은 [GitHub CLI 리포지토리](https://github.com/cli/cli#installation) 를 방문하세요.
1. GL2GH extension를 설치합니다.

   ```shell copy
   gh extension install github/gh-gl2gh
   ```

1. GL2GH extension of the GitHub CLI 자주 업데이트됩니다. 최신 버전의 확장을 사용하고 있는지 확인합니다.

    ```shell copy
    gh extension upgrade github/gh-gl2gh
    ```

1. 에서 GitHub범위가 있는 a를 personal access token 만들고 기록합니다 `admin:org` .
1. personal access token을(를) 환경 변수로 설정하고, 아래 명령의 토큰을 위에서 기록한 personal access token로 바꿉니다.

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

      ```shell copy
      export GH_PAT="TOKEN"
      ```

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

      ```shell copy
      $env:GH_PAT="TOKEN"
      ```
1. `gh gl2gh grant-migrator-role` 명령을 사용하여 조직을 마이그레이션자 역할을 부여하려는 조직으로 대체하여 ACTOR를 사용자 또는 팀 이름으로, TYPE을 `USER` 또는 `TEAM`(으)로 대체합니다.

   ```shell copy
   gh gl2gh grant-migrator-role --github-org ORGANIZATION --actor ACTOR --actor-type TYPE
   ```

   >[!NOTE] 마이그레이션자 역할을 GHE.com부여하는 경우 엔터프라이즈 하위 도메인에 대한 대상 API URL도 포함해야 합니다. 예: `--target-api-url https://api.octocorp.ghe.com`