GitHub Enterprise Importer에 대한 마이그레이션 로그 액세스

마이그레이션을 실행한 후에는 마이그레이션 로그를 검토하여 예상대로 마이그레이션하지 않은 데이터를 검사해야 합니다.

이 문서의 내용

마이그레이션 로그 정보

GitHub Enterprise Importer을(를) 사용하여 마이그레이션을 실행할 때마다 마이그레이션 로그가 만들어집니다. 모든 마이그레이션 후에 마이그레이션 로그를 검사하여 마이그레이션 경고를 검토합니다.

마이그레이션 로그는 마이그레이션의 일부로 완료된 단계를 나열하고 추가 정보를 포함합니다.

  • 예상대로 마이그레이션되지 않은 데이터(예: 문제, 끌어오기 요청 또는 주석)를 나타내는 마이그레이션 경고
  • 마이그레이션을 실행한 사람
  • 마이그레이션의 소스
  • 마이그레이션에 걸린 시간

여러 가지 방법으로 리포지토리 마이그레이션을 위해 마이그레이션 로그에 액세스할 수 있습니다.

  • GitHub에서 마이그레이션된 리포지토리의 "마이그레이션 로그" 문제를 확인합니다. 이 문제를 사용하여 팀과 경고에 대해 논의하고 결정을 기록할 수 있습니다.
  • GitHub CLI을(를) 사용하여 로그 파일을 다운로드합니다.

조직 마이그레이션을 실행하는 경우 GitHub Enterprise Importer은(는) 대상 조직에 gei-migration-results(이)라는 리포지토리를 추가로 만듭니다. 이 리포지토리는 조직 수준 데이터의 마이그레이션에 대한 정보를 포함하고 마이그레이션된 각 리포지토리에 대한 "마이그레이션 로그" 문제의 정보를 복제합니다.

마이그레이션 로그에서 경고를 해석하는 방법에 대한 자세한 내용은 GitHub Enterprise Importer를 사용하여 마이그레이션 문제 해결을(를) 참조하세요.

GitHub에서 리포지토리 마이그레이션 록 온 보기

리포지토리에 대한 읽기 권한이 있는 사람은 GitHub의 리포지토리에 대한 마이그레이션 로그에 액세스할 수 있습니다.

  1. 대상 조직의 마이그레이션된 리포지토리로 이동합니다.

  2. 리포지토리 이름 아래에서 이슈 아이콘을 클릭합니다.

    리포지토리의 기본 페이지 스크린샷. 가로 탐색 모음에서 "문제" 레이블이 지정된 탭이 진한 주황색으로 표시됩니다.

  3. "마이그레이션 로그"라는 제목의 문제를 클릭합니다.

GitHub CLI을(를) 사용하여 리포지토리 마이그레이션 로그 다운로드

조직 소유자와 마이그레이션자 역할이 있는 조직 구성원은 GitHub CLI을(를) 사용하여 마이그레이션 로그를 다운로드할 수 있습니다.

download-logs 명령을 사용하여 개별 리포지토리에 대한 최신 마이그레이션 로그를 다운로드할 수 있습니다. 정확한 명령은 마이그레이션 소스에 따라 달라집니다.

마이그레이션 로그는 마이그레이션이 완료된 후 24시간 동안 다운로드할 수 있습니다.

ADO2GH extension을(를) 사용하여 리포지토리 마이그레이션 로그 다운로드

마이그레이션 원본이 Azure DevOps인 경우 gh ado2gh download-logs 명령을 사용하여 개별 리포지토리에 대한 최신 마이그레이션 로그를 다운로드할 수 있습니다. 대상을 대상 조직, 리포지토리 이름으로 바꾸고 FILENAME을 다운로드한 파일의 파일 이름으로 바꿉니다.

Shell
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • 대상 조직에 대한 액세스 권한이 있는 personal access token에 대한 GH_PAT 환경 변수가 아직 설정되어 있지 않은 경우 --github-target-pat TOKEN을(를) 추가하여 TOKEN을(를) personal access token로 바꿉니다. personal access token 요구 사항은 Azure DevOps에서 마이그레이션에 대한 액세스 관리을(를) 참조하세요.
  • GHE.com로 마이그레이션하는 경우 --target-api-url TARGET-API-URL을(를) 추가합니다. 여기서 TARGET-API-URL은 엔터프라이즈 하위 도메인의 기본 API URL입니다. 예: https://api.octocorp.ghe.com

BBS2GH extension을(를) 사용하여 리포지토리 마이그레이션 로그 다운로드

마이그레이션 소스가 Bitbucket Server인 경우 gh bbs2gh download-logs 명령을 사용하여 개별 리포지토리에 대한 최신 마이그레이션 로그를 다운로드할 수 있습니다. 대상을 대상 조직, 리포지토리 이름으로 바꾸고 FILENAME을 다운로드한 파일의 파일 이름으로 바꿉니다.

Shell
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • 대상 조직에 대한 액세스 권한이 있는 personal access token에 대한 GH_PAT 환경 변수가 아직 설정되어 있지 않은 경우 --github-target-pat TOKEN을(를) 추가하여 TOKEN을(를) personal access token로 바꿉니다. personal access token 요구 사항은 Bitbucket 서버에서 마이그레이션에 대한 액세스 관리을(를) 참조하세요.
  • GHE.com로 마이그레이션하는 경우 --target-api-url TARGET-API-URL을(를) 추가합니다. 여기서 TARGET-API-URL은 엔터프라이즈 하위 도메인의 기본 API URL입니다. 예: https://api.octocorp.ghe.com

GEI extension을(를) 사용하여 리포지토리 마이그레이션 로그 다운로드

마이그레이션 소스가 GitHub 제품인 경우 gh gei download-logs 명령을 사용하여 개별 리포지토리에 대한 최신 마이그레이션 로그를 다운로드할 수 있습니다. 대상을 대상 조직, 리포지토리 이름으로 바꾸고 FILENAME을 다운로드한 파일의 파일 이름으로 바꿉니다.

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • 대상 조직에 대한 액세스 권한이 있는 personal access token에 대한 GH_PAT 환경 변수가 아직 설정되어 있지 않은 경우 --github-target-pat TOKEN을(를) 추가하여 TOKEN을(를) personal access token로 바꿉니다. personal access token 요구 사항은 GitHub 제품 간의 마이그레이션에 대한 액세스 관리을(를) 참조하세요.
  • GHE.com로 마이그레이션하는 경우 --target-api-url TARGET-API-URL을(를) 추가합니다. 여기서 TARGET-API-URL은 엔터프라이즈 하위 도메인의 기본 API URL입니다. 예: https://api.octocorp.ghe.com

마이그레이션 스크립트에 대한 모든 리포지토리 마이그레이션 로그 다운로드

마이그레이션된 모든 리포지토리에 대한 마이그레이션 로그에 액세스할 수 있도록 하려면 리포지토리 마이그레이션에 대한 마이그레이션 스크립트를 생성할 때 --download-migration-logs 플래그를 사용할 수 있습니다. 이 플래그를 사용하면 스크립트에 마이그레이션된 각 리포지토리에 대한 download-logs 명령이 스크립트에 포함됩니다. 자세한 내용은 GitHub Enterprise Importer 정보을(를) 참조하세요.

Note

조직 마이그레이션이 아닌 리포지토리 마이그레이션이 포함된 --download-migration-logs 플래그만 사용할 수 있습니다.

조직 마이그레이션 로그 액세스

대상 조직의 소유자는 GitHub 관련 조직 마이그레이션에 대한 마이그레이션 로그에 액세스할 수 있습니다.

조직 마이그레이션에 대한 마이그레이션 로그에 액세스하려면 대상 조직에서 gei-migration-results(이)라는 리포지토리로 이동합니다.

리포지토리의 루트에 있는 README.md 파일에는 조직 마이그레이션에 대한 다음 정보가 포함됩니다.

  • 설정 및 팀과 같은 조직 수준 데이터의 마이그레이션과 관련된 경고 또는 오류
  • 성공적으로 마이그레이션된 리포지토리의 수 및 마이그레이션에 실패한 리포지토리의 수

/success 및 /failure 디렉터리에는 성공적으로 마이그레이션되었거나 마이그레이션에 실패한 각 리포지토리에 대해 각각 하나의 파일이 포함됩니다. 파일은 명명 규칙 REPO_NAME.md을(를) 따릅니다.

Note

gei-migration-results 리포지토리는 마이그레이션 프로세스의 시작 부분에서 만들어지지만 마이그레이션이 완료된 후에만 마이그레이션 로그로 업데이트됩니다.