매니페스트 파일을 통한 마이그레이션
GitLab v19.4Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
Android 리포지터리에서 사용하는 것과 같은 매니페스트 파일을 기반으로 Git 리포지터리를 가져옵니다. 매니페스트 파일은 크기가 최대 1MB인 XML 파일이어야 합니다. GitLab은 remote 태그의 URL과 프로젝트 이름을 조합하여 리포지터리 URL을 구성합니다.
Android 리포지터리에서 사용하는 것과 같은 매니페스트 파일을 기반으로 Git 리포지터리를 가져옵니다. 매니페스트를 사용하면 Android Open Source Project(AOSP)처럼 리포지터리가 많은 프로젝트를 가져올 수 있습니다.
사전 요구 사항#
- 매니페스트 가져오기 소스가 활성화되어 있어야 합니다. 활성화되어 있지 않다면 GitLab 관리자에게 활성화를 요청합니다. 매니페스트 가져오기 소스는 GitLab.com에서 기본적으로 활성화되어 있습니다.
- 가져올 대상 최상위 그룹의 Maintainer 또는 Owner 권한. 가져오기를 위해 새 최상위 그룹을 생성할 수도 있습니다.
매니페스트 파일 형식#
매니페스트 파일은 크기가 최대 1MB인 XML 파일이어야 합니다. 파일에는 다음이 있어야 합니다.
- Git 서버 URL을 담은
review속성이 있는remote태그 하나. name과path속성이 있는project태그.
GitLab은 remote 태그의 URL과 프로젝트 이름을 조합하여 리포지터리 URL을 구성합니다.
path 속성은 GitLab에서 프로젝트 경로를 나타내는 데 사용됩니다.
예를 들면 다음과 같습니다.
<manifest>
<remote review="https://android.googlesource.com/" />
<project path="build/make" name="platform/build" />
<project path="build/blueprint" name="platform/build/blueprint" />
</manifest>
이 예에서 GitLab은 다음 프로젝트를 생성합니다.
| GitLab | Import URL |
|---|---|
https://gitlab.com/<group_name>/build/make |
https://android.googlesource.com/platform/build |
https://gitlab.com/<group_name>/build/blueprint |
https://android.googlesource.com/platform/build/blueprint |
리포지터리 가져오기#
매니페스트 파일을 사용하여 리포지터리를 가져오려면 다음과 같이 진행합니다.
- 오른쪽 상단 모서리에서 Create new(+)를 선택한 다음 New project/repository를 선택합니다.
- Import project를 선택합니다.
- Manifest file을 선택합니다.
- 가져올 그룹을 선택합니다.
- 사용할 XML 형식의 매니페스트 파일을 선택합니다.
- List available repositories를 선택합니다. 매니페스트 파일을 기반으로 한 프로젝트 목록과 함께 가져오기 상태 페이지로 이동합니다.
- 가져오려면 다음과 같이 진행합니다.
- 모든 프로젝트를 처음 가져오는 경우 Import all repositories를 선택합니다.
- 개별 프로젝트를 다시 가져오는 경우 Re-import를 선택합니다. 새 이름을 지정하고 Re-import를 다시 선택합니다. 다시 가져오면 소스 프로젝트의 새 복사본이 생성됩니다.