Gitea에서 마이그레이션
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Gitea 가져오기 도구는 Gitea에서 항목의 일부를 가져옵니다. Gitea 가져오기 도구는 GitLab.com 및 GitLab Self-Managed의 사용자 기여에 대한 마이그레이션 후 매핑을 지원합니다. 가져오기 시 개인 액세스 토큰을 생성하고 Gitea와 일회성 인증을 수행하여 GitLab에 저장소 액세스 권한을 부여합니다.
히스토리
- GitLab 15.8에서 GitLab이 더 이상 존재하지 않는 네임스페이스나 그룹을 자동으로 생성하지 않도록 변경되었습니다. GitLab은 또한 네임스페이스나 그룹 이름이 이미 사용 중인 경우 더 이상 사용자의 개인 네임스페이스로 폴백하지 않습니다.
- GitLab 16.0에서 Developer 역할 대신 Maintainer 역할 요구 사항이 도입되었으며 GitLab 15.11.1 및 GitLab 15.10.5에 백포트됨.
- GitLab 16.11에서 경로에
.이 포함된 프로젝트 가져오기 기능이 추가되었습니다. - GitLab 17.2에서 일부 가져온 항목에 가져옴 배지가 도입.
- GitLab 17.8에서 GitLab.com에서 마이그레이션 후 사용자 기여 및 멤버십 매핑으로 변경.
- GitLab 17.8에서 GitLab.com 및 GitLab Self-Managed에서 마이그레이션 후 사용자 및 기여 멤버십 매핑이 활성화됨.
Gitea에서 GitLab으로 프로젝트를 가져옵니다.
Gitea 가져오기 도구는 Gitea에서 항목의 일부를 가져옵니다.
| Gitea 항목 | 가져옴 |
|---|---|
| 저장소 설명 | ✅ |
| Git 저장소 데이터 | ✅ |
| 이슈 | ✅ |
| 풀 리퀘스트 | ✅ |
| 마일스톤 | ✅ |
| 레이블 | ✅ |
| 풀 리퀘스트의 diff 노트 | ❌ |
가져오기 도구 워크플로#
Gitea 가져오기 도구는 GitLab.com 및 GitLab Self-Managed의 사용자 기여에 대한 마이그레이션 후 매핑을 지원합니다. 가져오기 도구는 대체 방법도 지원합니다.
가져올 때:
- 저장소 공개 액세스가 유지됩니다. Gitea에서 저장소가 비공개이면 GitLab에서도 비공개로 생성됩니다.
- 가져온 이슈, MR 및 댓글에는 GitLab에 가져옴 배지가 표시됩니다.
- Gitea는 OAuth 제공자가 아니기 때문에 작성자 또는 담당자를 GitLab 인스턴스의 사용자에 매핑할 수 없습니다. 프로젝트 생성자(일반적으로 가져오기 프로세스를 시작한 사용자)가 작성자로 설정됩니다. 이슈의 경우 원래 Gitea 작성자를 볼 수 있습니다.
전제 조건#
- Gitea 버전 1.0.0 이상.
- Gitea 가져오기 소스를 활성화하거나 GitLab 관리자에게 활성화를 요청해야 합니다. GitLab.com에서 기본적으로 활성화됩니다.
- 가져올 대상 그룹에 Maintainer 또는 소유자 역할이 있어야 합니다.
Gitea 저장소 가져오기#
가져오기 시 개인 액세스 토큰을 생성하고 Gitea와 일회성 인증을 수행하여 GitLab에 저장소 액세스 권한을 부여합니다.
Gitea 저장소를 가져오려면:
- 오른쪽 상단에서 새로 만들기 (+)를 선택하고 새 프로젝트/저장소를 선택합니다.
- 가져오기 인증 프로세스를 시작하려면 Gitea를 선택합니다.
https://your-gitea-instance/user/settings/applications로 이동합니다.your-gitea-instance를 Gitea 인스턴스 호스트로 교체합니다.- 새 토큰 생성을 선택합니다.
- 토큰 설명을 입력합니다.
- 토큰 생성을 선택합니다.
- 토큰 해시를 복사합니다.
- GitLab으로 돌아가서 Gitea 가져오기 도구에 토큰을 제공합니다.
- Gitea 저장소 목록 조회를 선택하고 GitLab이 저장소 정보를 읽을 때까지 기다립니다. 완료되면 GitLab은 가져올 저장소를 선택할 수 있는 가져오기 페이지를 표시합니다. 거기서 Gitea 저장소의 가져오기 상태를 볼 수 있습니다:
- 가져오는 중인 항목은 시작됨 상태를 표시합니다.
- 이미 성공적으로 가져온 항목은 완료됨 상태와 함께 녹색으로 표시됩니다.
- 아직 가져오지 않은 항목에는 테이블 오른쪽에 가져오기가 표시됩니다.
- 이미 가져온 항목에는 테이블 오른쪽에 다시 가져오기가 표시됩니다.
- Gitea 저장소 가져오기를 완료하려면:
- 모든 Gitea 프로젝트를 한 번에 가져올 수 있습니다. 왼쪽 상단에서 모든 프로젝트 가져오기를 선택합니다.
- 이름으로 프로젝트를 필터링하여 선택한 프로젝트만 가져올 수 있습니다. 필터를 적용하면 모든 프로젝트 가져오기는 선택한 프로젝트만 가져옵니다.
- 권한이 있는 경우 프로젝트에 다른 이름을 지정하고 다른 네임스페이스를 선택할 수 있습니다.
대체 매핑 방법#
GitLab 18.5 이하에서는 gitea_user_mapping 기능 플래그를 비활성화하여 가져오기에 대한 대체 사용자 기여 매핑 방법을 사용할 수 있습니다.
이 기능의 사용 가능 여부는 기능 플래그에 의해 제어됩니다. 이 기능은 권장되지 않으며 다음에는 사용 불가합니다:
- GitLab.com으로의 마이그레이션.
- GitLab Self-Managed 및 GitLab Dedicated 18.6 이상으로의 마이그레이션.
이 매핑 방법에서 발견된 문제는 수정될 가능성이 낮습니다. 이러한 제한이 없는 마이그레이션 후 방법을 대신 사용하세요.
자세한 내용은 이슈 512211을 참조하세요.
이 방법을 사용하면 사용자 기여가 기본적으로 프로젝트 생성자(일반적으로 가져오기 프로세스를 시작한 사용자)에게 할당됩니다.
