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

마이그레이션에 문제가 발생하는 경우 마이그레이션 상태를 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로 구성된 경우 마이그레이션은 실행 전 유효성 검사에 실패합니다.