Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

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

리포지토리 마이그레이션 중에 발생한 이벤트 및 오류 기록을 검토하려면 GitHub에서 또는 GitHub CLI를 사용하여 마이그레이션 로그에 액세스할 수 있습니다.

마이그레이션 로그 정보

GitHub Enterprise Importer을(를) 사용하여 마이그레이션을 실행할 때마다 마이그레이션 로그가 만들어집니다. 마이그레이션 로그는 마이그레이션의 일부로 완료된 단계를 나열하고 추가 정보를 포함합니다.

  • 마이그레이션을 실행한 사람
  • 마이그레이션의 원본
  • 마이그레이션에 걸린 시간
  • 예상대로 마이그레이션되지 않은 모든 리소스

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

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

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

마이그레이션 로그에서 오류 메시지를 해석하는 방법에 대한 자세한 내용은 "GitHub Enterprise Importer를 사용하여 마이그레이션 문제 해결 참조하세요.

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

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

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

  2. 리포지토리 이름 아래에서 문제를 클릭합니다.

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

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

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

조직 소유자와 마이그레이션자 역할이 있는 사용자는 GitHub CLI를 사용하여 마이그레이션 로그를 다운로드할 수 있습니다. 마이그레이션자 역할에 대한 자세한 내용은 "GitHub Enterprise Importer에 대한 마이그레이션자 역할 부여"을 참조하세요.

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

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

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

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

Shell
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

대상 조직에 대한 액세스 권한이 있는 GH_PAT personal access token에 대한 환경 변수가 아직 설정되어 있지 않은 경우 을 personal access token로 TOKEN 대체--github-target-pat TOKEN합니다. personal access token 요구 사항은 "GitHub Enterprise Importer에 대한 액세스 관리"을 참조하세요.

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

참고: GitHub Enterprise Importer를 사용하여 Bitbucket Server에서 마이그레이션하는 작업은 현재 프라이빗 베타로 제공되며 변경될 수 있습니다. 베타에 대한 액세스를 요청하려면 Bitbucket 서버 마이그레이션 대기 목록 조인을 참조하세요.

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

Shell
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

대상 조직에 대한 액세스 권한이 있는 GH_PAT personal access token에 대한 환경 변수가 아직 설정되어 있지 않은 경우 을 personal access token로 TOKEN 대체--github-target-pat TOKEN합니다. personal access token 요구 사항은 "GitHub Enterprise Importer에 대한 액세스 관리"을 참조하세요.

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

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

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

대상 조직에 대한 액세스 권한이 있는 GH_PAT personal access token에 대한 환경 변수가 아직 설정되어 있지 않은 경우 을 personal access token로 TOKEN 대체--github-target-pat TOKEN합니다. personal access token 요구 사항은 "GitHub Enterprise Importer에 대한 액세스 관리"을 참조하세요.

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

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

참고: 조직 마이그레이션이 --download-migration-logs 아닌 리포지토리 마이그레이션에서만 플래그를 사용할 수 있습니다.

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

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

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

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

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

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

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