Skip to main content

GitHub Enterprise Server에서 GHE.com 실시간 마이그레이션 문제 해결

마이그레이션에 발생할 수 있는 문제에 대한 조언입니다.

참고

Enterprise Live Migrations 가 있으며 공개 미리 보기 변경될 수 있습니다.

마이그레이션에 문제가 발생하는 경우 마이그레이션 상태를 elm migration status --migration-id MIGRATION-ID 확인하고 오류 정보를 검토합니다.

상태Meaning권장 작업
생성됨마이그레이션이 만들어졌지만 아직 시작되지 않았습니다.
elm migration start을 실행합니다.
대기 중 ****마이그레이션이 시작되기를 기다리고 있습니다.Wait
내보내기원본에서 데이터를 내보내고 있습니다.다음을 사용하여 모니터링 elm migration status
처리 중내보낸 데이터를 대상 위치로 가져오고 있습니다.다음을 사용하여 모니터링 elm migration status
전환 준비초기 마이그레이션이 완료되고 마이그레이션이 중단할 준비가 완료되었습니다.준비가 되면 실행 elm migration cutover-to-destination
절단 오버원본 리포지토리가 잠겨 있고 나머지 변경 내용이 대상에 적용되고 있습니다.모니터; 상태가 완료됨으로 전환됩니다 .
Completed마이그레이션이 성공적으로 완료되었습니다.대상 리포지토리 확인 및 마네킹 회수
실패마이그레이션에서 복구할 수 없는 오류가 발생했습니다.오류 조사(아래 참조)
일시 중지된마이그레이션이 일시 중지됨마이그레이션 다시 시작
종료된마이그레이션이 취소되었습니다.N/A
성능 저하됨대상에 연결할 수 없습니다.GitHub Enterprise Server 어플라이언스와 GHE.com 간의 네트워크 연결 확인(아래 참조)

마이그레이션 상태가 "실패"입니다.

복구할 수 없는 오류가 계속되지 않으면 마이그레이션이 실패 상태로 전환됩니다. 이는 가져오지 못하는 개별 리소스와 다릅니다. 마이그레이션에 실패하면 마이그레이션 자체를 진행할 수 없습니다.

조사하려면 elm migration status --migration-id MIGRATION-ID을 실행하고 응답에서 오류 세부 정보를 검토하십시오. 각 오류에는 형식 (Correlation ID for Support: UUID)의 상관 관계 ID가 포함됩니다. GitHub 지원에 연락하실 경우, 지원 팀이 조사할 수 있도록 이 ID를 제공하세요.

기본 문제를 해결한 후 실패한 마이그레이션을 중단하고 새 마이그레이션 elm migration cancel --migration-id MIGRATION-ID 을 시작합니다.

마이그레이션 상태가 "저하됨"입니다.

성능 저하 상태는 어플라이언스에서 GitHub Enterprise Server 마이그레이션 서비스가 대상 엔터프라이즈에 연결할 수 없음을 의미합니다. 마이그레이션은 원본 쪽에서 계속되지만 대상 상태를 알 수 없습니다.

장치 GitHub Enterprise Server와 GHE.com의 서브도메인 간의 네트워크 연결을 확인한 후 elm migration status --migration-id MIGRATION-ID를 다시 실행합니다. 상태 응답에는 연결 문제가 발생한 기간을 평가하는 데 도움이 될 수 있는 대상과의 마지막으로 성공한 연락처에 대한 타임스탬프가 포함됩니다.

일부 리소스를 가져오지 못했습니다.

개별 리소스를 가져오지 못하면 전체 마이그레이션이 실패할 수 있습니다. 의 출력 elm migration status --migration-id MIGRATION-ID에서 실패한 리소스 수를 볼 수 있습니다.

실패한 리소스는 모든 자동 재시도를 모두 소진한 후에만 표시되므로 표시되는 모든 오류는 개입 없이는 확인할 수 없는 것으로 확인됩니다. 상태 응답에서 오류 세부 정보를 검토합니다. 백필 또는 라이브 업데이트에서 실패한 각 리소스가 표시됩니다 "state": "failed".

실패한 리소스의 수와 유형이 허용 가능한 경우 전환을 진행할 수 있습니다. 그렇지 않은 경우 마이그레이션을 중단하고 기본 문제를 해결한 다음 새 마이그레이션을 시작합니다.

전환이 실패하고 원본 리포지토리가 잠겨 있습니다.

중간에 중단이 실패하면 원본 리포지토리가 잠겨 있거나 보관된 상태로 유지될 수 있습니다. 이렇게 하면 대상이 아직 불완전할 수 있는 동안 개발자가 원본으로 푸시할 수 없습니다.

원본 리포지토리의 잠금을 해제하려면 사이트 관리자가 해당 리포지토리의 잠금을 GitHub Enterprise Server관리 콘솔해제해야 합니다.

원본이 잠금 해제된 후에는 elm migration cutover-to-destination --migration-id MIGRATION-ID를 사용해 커버를 다시 시도하거나 elm migration cancel --migration-id MIGRATION-ID로 마이그레이션을 중단하고 준비가 되셨을 때 새 마이그레이션을 시작할 수 있습니다.

강제 푸시로 인해 마이그레이션을 다시 시작해야 합니다.

마이그레이션이 진행되는 동안 누군가가 원본 리포지토리의 기본 분기로 강제 푸시하는 경우 원본과 대상 간의 Git 동기화가 중단됩니다. 강제 푸시는 증분적으로 조정할 수 없는 방식으로 커밋 기록을 다시 작성합니다.

이 경우, 마이그레이션을 elm migration cancel --migration-id MIGRATION-ID 중단하고 새 마이그레이션을 시작합니다. 다시 시작하기 전에 마이그레이션이 활성 상태일 때 기본 분기로 강제 푸시가 금지된다는 것을 팀에게 알리십시오.

액세스 토큰이 거부되었습니다.

인증 오류로 마이그레이션이 실패하는 경우 다음을 확인합니다.

  • 원본 및 대상 토큰은 모두 다음과 같습니다 personal access tokens (classic). 세분화된 토큰은 지원되지 않습니다.
  • 토큰에는 Enterprise Live Migrations를 사용하여 리포지토리 마이그레이션에 지정된 범위가 있습니다.
  • 대상 조직에서 SAML Single Sign-On을 적용하는 경우 토큰에 SSO에 대한 권한이 부여되어야 합니다.

원본 GHES URL이 거부되었습니다.

Enterprise Live Migrations 에서는 GitHub Enterprise Server URL이 HTTPS를 사용해야 합니다. URL이 HTTP로 구성된 경우 마이그레이션은 실행 전 유효성 검사에 실패합니다.