마이그레이션 유형
수행할 수 있는 마이그레이션에는 세 가지 유형이 있습니다.
- GitHub Enterprise Server 인스턴스에서 다른 기존 GitHub Enterprise Server 인스턴스로 마이그레이션합니다. 인스턴스의 모든 사용자 또는 조직이 소유한 리포지토리 수를 마이그레이션할 수 있습니다. 마이그레이션을 수행하기 전에 두 인스턴스에 대한 사이트 관리자 액세스 권한이 있어야 합니다.
- GitHub.com 조직에서 GitHub Enterprise Server 인스턴스로 마이그레이션합니다. 조직에서 소유한 리포지토리를 원하는 수만큼 마이그레이션할 수 있습니다. 마이그레이션을 수행하기 전에 GitHub.com 조직에 대한 관리 액세스 권한과 대상 인스턴스에 대한 사이트 관리자 액세스 권한이 있어야 합니다.
- _평가판 실행_은 준비 인스턴스로 데이터를 가져오는 마이그레이션입니다. 마이그레이션이 GitHub.com에 적용된 경우 어떤 일이 발생하는지 확인하는 데 유용할 수 있습니다. 프로덕션 인스턴스로 데이터를 가져오기 전에 스테이징 인스턴스에서 평가판을 실행하는 것이 좋습니다.
Note
하이퍼바이저 간에 GitHub Enterprise Server 인스턴스를 전송하는 데는 ghe-migrator를 사용하지 않는 것이 좋습니다. 대신 GitHub Enterprise Server Backup Utilities을(를) 사용하여 새 위치로 백업 및 복원하거나 새 위치에 복제본을 만든 다음 복제본 어플라이언스 장애 조치할 것을 제안합니다. 자세한 내용은 인스턴스에서 백업 구성, 고가용성 복제본 만들기, 복제본 어플라이언스로 장애 조치(failover) 시작을(를) 참조하세요.
마이그레이션된 데이터
ghe-migrator를 사용하여 모든 것이 리포지토리를 중심으로 진행됩니다. 리포지토리와 연결된 대부분의 데이터를 마이그레이션할 수 있습니다. 예를 들어 조직 내의 리포지토리는 리포지토리 및 조직뿐만 아니라 리포지토리에 연결된 모든 사용자, 팀, 문제 및 끌어오기 요청을 마이그레이션합니다.
아래 표의 항목은 리포지토리를 사용하여 마이그레이션할 수 있습니다. Git LFS 자산을 포함하여 마이그레이션된 데이터 목록에 표시되지 않는 모든 항목을 마이그레이션할 수 없습니다.
Note
마이그레이션 후에는 포크 관계가 유지되지 않습니다.
| 마이그레이션된 리포지토리와 연결된 데이터 | 주의 |
|---|---|
| 사용자 | 사용자의 @mentions이 대상과 일치하도록 재작성되었습니다. |
| 조직 | 조직의 이름과 세부 정보가 마이그레이션됩니다. |
| 리포지토리 | 대상과 일치하도록 Git 트리, Blob, 커밋 및 라인에 대한 링크를 다시 작성합니다. 내부 리포지토리는 프라이빗 리포지토리로 마이그레이션됩니다. 보관 상태는 설정되지 않습니다. |
| Wikis | 모든 Wiki 데이터가 마이그레이션됩니다. |
| Teams | 사용자의 @mentions이 대상과 일치하도록 재작성되었습니다. |
| 마일스톤 | 타임스탬프는 유지됩니다. |
| Projects (classic) 보드 | 리포지토리 및 리포지토리를 소유한 조직과 연결된 프로젝트(클래식)가 마이그레이션됩니다. 새로운 프로젝트 환경인 Projects은(는) 지원되지 않습니다. |
| 문제 | 문제 참조 및 타임스탬프는 유지됩니다. |
| 이슈 설명 | 설명에 대한 상호 참조는 대상 인스턴스에 대해 다시 작성됩니다. |
| 끌어오기 요청 | 끌어오기 요청에 대한 상호 참조는 대상과 일치하도록 다시 작성됩니다. 타임스탬프는 유지됩니다. |
| 끌어오기 요청 검토 | 끌어오기 요청 검토 및 관련 데이터가 마이그레이션됩니다. |
| 끌어오기 요청 검토 설명 | 설명에 대한 상호 참조는 대상 인스턴스에 대해 다시 작성됩니다. 타임스탬프는 유지됩니다. 파일 수준 주석은 마이그레이션되지 않습니다. |
| 커밋 주석 | 설명에 대한 상호 참조는 대상 인스턴스에 대해 다시 작성됩니다. 타임스탬프는 유지됩니다. |
| 릴리스 | 모든 릴리스 데이터가 마이그레이션됩니다. |
| 끌어오기 요청 또는 문제에 대해 수행된 작업 | 끌어오기 요청 또는 문제(예: 사용자 할당, 제목 변경 및 레이블 수정)에 대한 모든 수정 사항은 각 작업에 대한 타임스탬프와 함께 유지됩니다. |
| 첨부 파일 | 문제 및 끌어오기 요청에 대한 첨부 파일은 마이그레이션됩니다. 마이그레이션의 일부로 이 기능을 사용하지 않도록 설정할 수 있습니다. |
| 웹후크 | 활성 웹후크만 마이그레이션됩니다. |
| 리포지토리 배포 키 | 리포지토리 배포 키가 마이그레이션됩니다. |
| 보호된 분기 | 보호된 분기 설정 및 연결된 데이터가 마이그레이션됩니다. |
외부 인증 데이터의 마이그레이션 정보
마이그레이션의 원본 위치가 LDAP 또는 SAML 인증을 사용하는 GitHub 제품인 경우 ghe-migrator는 사용자 계정에 연결된 외부 인증 데이터를 마이그레이션하지 않습니다. 인증 옵션에 대한 자세한 내용은 GitHub Enterprise Server를 참조하세요. GitHub Enterprise Server 문서 또는GitHub Enterprise Cloud 문서의 “엔터프라이즈 인증 정보”를 참조하세요.
대상 인스턴스로 마이그레이션한 다음 외부 인증을 구성하는 경우 사용자는 원본 인스턴스의 계정과 동일한 사용자 이름 또는 사용자 ID를 가진 사용자 계정으로 대상 인스턴스에 로그인해야 합니다. 관리자는 인스턴스가 관리 콘솔에서 사용자 계정 이름을 매핑하는 데 사용하는 외부 특성을 검토할 수 있습니다. 자세한 내용은 관리 콘솔에 액세스을(를) 참조하세요.