Skip to main content

3단계. GitHub Enterprise Importer 설치 및 구성

ADO2GH extension of the GitHub CLI를 설치하고 마이그레이션을 위한 환경을 구성합니다.

1단계: ADO2GH extension of the GitHub CLI

설치

GitHub Enterprise Importer는 GitHub CLI용 확장 기능 모음입니다. 첫 번째 마이그레이션인 경우 GitHub CLI 및 ADO2GH extension를 설치해야 합니다.

  1. GitHub CLI을(를) 설치하세요.

    • GitHub CLI에 대한 설치 지침은 GitHub CLI 리포지토리를 참조하세요.
    • GitHub CLI가 이미 설치되어 있는 경우 실행 gh --version 하여 버전 2.4.0 이상을 실행하고 있는지 확인합니다. 이전 버전이 있는 경우 GitHub CLI 리포지토리를 방문하여 업그레이드 지침을 확인하세요.
  2. ADO2GH extension을(를) 설치합니다.

    Shell
    gh extension install github/gh-ado2gh
    
  3. ADO2GH extension of the GitHub CLI은(는) 매주 업데이트됩니다. 확장 프로그램을 업데이트하십시오

    Shell
    gh extension upgrade github/gh-ado2gh
    

ADO2GH extension에 대한 도움이 필요할 때마다 명령과 함께 --help 플래그를 사용할 수 있습니다. 예를 들어, gh ado2gh --help은(는) 사용 가능한 모든 명령을 나열하고 gh ado2gh migrate-repo --help은(는) migrate-repo 명령에 사용할 수 있는 모든 옵션을 나열합니다.

2단계: 환경 변수 설정

ADO2GH extension을(를) 사용하여 GitHub Enterprise Cloud(으)로 마이그레이션하기 전에, 원본 및 대상 조직에 액세스할 수 있는 personal access token을(를) 만든 다음 personal access token을(를) 환경 변수로 설정해야 합니다.

  1. GitHub와 Azure DevOps 모두에 사용할 personal access token을 준비했는지 확인합니다. 단계 2: 액세스 관리을(를) 참조하세요.

  2. 아래 명령에서 TOKEN을 이전에 생성한 personal access token로 바꿔 personal access token용 환경 변수를 설정합니다. 대상 조직에는 GH_PAT을(를) 사용하고 원본 조직에는 ADO_PAT을(를) 사용하세요.

    • Terminal을 사용하는 경우 export 명령을 사용하세요.

      Shell
      export GH_PAT="TOKEN"
      export ADO_PAT="TOKEN"
      
    • PowerShell을 사용하는 경우 $env 명령을 사용하세요.

      Shell
      $env:GH_PAT="TOKEN"
      $env:ADO_PAT="TOKEN"
      
  3. 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud로 마이그레이션하는 경우, 편리하게 엔터프라이즈에 대한 베이스 API URL의 환경 변수를 설정합니다.

    엔터프라이즈의 하위 도메인으로 SUBDOMAIN를 대체하십시오. 예를 들어 엔터프라이즈의 하위 도메인이 acme면 값은 TARGET_API_URL 다음과 같습니다 https://api.acme.ghe.com.

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

      Shell
      export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
      
    • PowerShell을 사용하는 경우 $env 명령을 사용합니다.

      Shell
      $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
      

    이 변수는 GitHub CLI에서 실행하는 명령에 --target-api-url 옵션과 함께 사용합니다.

다음 단계:

다음 단계에서는 GitHub Enterprise Cloud를 사용하여 마이그레이션을 준비합니다. 4단계. Azure DevOps에서 GitHub로 마이그레이션 준비을(를) 참조하세요.