Import multiple repositories by uploading a manifest file
GitLab allows you to import all the required Git repositories based on a manifest file like the one used by the Android repository. This feature can be very handy when you need to import a project with many repositories like the Android Open Source Project (AOSP).
GitLab must be using PostgreSQL for its database, since subgroups are needed for the manifest import to work.
Read more about the database requirements.
A manifest must be an XML file. There must be one
remote tag with a
attribute that contains a URL to a Git server, and each
project tag must have
path attribute. GitLab will then build the URL to the repository
by combining the URL from the
remote tag with a project name.
A path attribute will be used to represent the project path in GitLab.
Below is a valid example of a manifest file:
<manifest> <remote review="https://android.googlesource.com/" /> <project path="build/make" name="platform/build" /> <project path="build/blueprint" name="platform/build/blueprint" /> </manifest>
As a result, the following projects will be created:
Importing the repositories
You can start the import with:
- From your GitLab dashboard click New project
- Switch to the Import project tab
- Click on the Manifest file button
- Provide GitLab with a manifest xml file
- Select a group you want to import to (you need to create a group first if you don’t have one)
- Click List available repositories. At this point, you will be redirected to the import status page with projects list based on the manifest file.
Check the list and click Import all repositories to start the import.