manifest 파일을 업로드하여 여러 개의 저장소 가져오기
세부 정보: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
- GitLab 11.2에서 소개.
- 프로젝트 재가져오기 기능은 GitLab 15.9에서 소개됐습니다.
GitLab을 사용하면 Android 저장소에서 사용하는 것과 같은 manifest 파일을 기반으로 필요한 모든 Git 저장소를 가져올 수 있습니다. Android 오픈 소스 프로젝트(AOSP)와 같이 여러 저장소가 있는 프로젝트를 가져오기 위해 manifest를 사용하세요.
전제 조건
- Developer 역할 대신 Maintainer 역할이 GitLab 16.0에 도입되었으며, GitLab 15.11.1 및 GitLab 15.10.5로 백포팅되었습니다.
- Manifest import source가 활성화되어 있어야 합니다. 비활성화된 경우 GitLab 관리자에게 활성화할 것을 요청하세요. Manifest import source는 기본적으로 GitLab.com에서 활성화됩니다.
- GitLab은 manifest 가져오기가 작동하려면 데이터베이스로 PostgreSQL을 사용해야 합니다. manifest 가져오기에 subgroups이 필요하므로 데이터베이스 요구 사항을 자세히 읽어보세요(../../../install/requirements.md#database).
- 가져오기 대상 그룹에서 적어도 Maintainer 역할이 있어야 합니다.
Manifest 형식
Manifest는 XML 파일이어야 합니다. remote
태그에는 Git 서버의 URL을 포함하는 review
속성이 하나 있어야 하며, 각 project
태그에는 name
과 path
속성이 있어야 합니다. 그런 다음 GitLab은 remote
태그에서의 URL과 프로젝트 이름을 결합하여 저장소의 URL을 구축합니다.
path
속성은 GitLab에서 프로젝트 경로를 나타내는 데 사용됩니다.
아래는 유효한 manifest 파일 예시입니다:
<manifest>
<remote review="https://android.googlesource.com/" />
<project path="build/make" name="platform/build" />
<project path="build/blueprint" name="platform/build/blueprint" />
</manifest>
결과적으로 다음 프로젝트가 생성됩니다:
GitLab | Import URL |
---|---|
https://gitlab.com/YOUR_GROUP/build/make
| https://android.googlesource.com/platform/build |
https://gitlab.com/YOUR_GROUP/build/blueprint
| https://android.googlesource.com/platform/build/blueprint |
저장소 가져오기
가져오기를 시작하려면 다음을 수행하세요:
- GitLab 대시보드에서 새 프로젝트를 선택합니다.
- 프로젝트 가져오기 탭으로 전환합니다.
- Manifest 파일을 선택합니다.
- GitLab에게 manifest XML 파일을 제공합니다.
- 가져오기를 원하는 그룹을 선택합니다(그룹이 없는 경우 먼저 그룹을 생성해야 합니다).
- 사용 가능한 저장소 목록 표시를 선택합니다. 이 시점에서 manifest 파일을 기반으로 한 프로젝트 목록이 있는 가져오기 상태 페이지로 리디렉션됩니다.
- 가져오려면:
- 처음에는 모든 프로젝트를 가져오려면 모든 저장소 가져오기를 선택합니다.
- 다시 개별 프로젝트를 가져오려면 재가져오기를 선택합니다. 새 이름을 지정하고 다시 재가져오기를 선택합니다. 재가져오기를 하면 소스 프로젝트의 새 복사본이 생성됩니다.