Gitlab ISG D-ITET to ID migration
This page describes how to migrate a Gitlab project from ISG D-ITET Gitlab Server to ID Gitlab Server.
Contents
- Gitlab ISG D-ITET to ID migration
Project export on ISG D-ITET Gitlab server
It is a good idea to inform all project members about the upcoming migration of a project to avoid any confusion.
Set the project to read-only
Log in to the ISG D-ITET Gitlab instance (https://git.ee.ethz.ch/)
- Open the project you want to export
Follow the steps on the following screenshot:
Click on Settings
Click on General
Open Advanced
Click on the Archive project button
Start the project export
Follow the steps on the following screenshot:
Click on Settings
Click on General
Open Advanced
Click on the Export button
Info regarding project members
Project members are not exported.
- Project members must be invited again after the import.
In the ID Gitlab instance it is currently not possible to invite external users via email address. External users therefore need an ETH guest account. Please contact your IT responsible/IT contact in your institute/group.
The following message will be displayed:
Download the project/export
Option 1 - Gitlab
Follow the steps on the following screenshot:
Click on Settings
Click on General
Open Advanced
Click on the Download export button
Option 2 - Email
Just open the link in the email.
Project import on ID Gitlab server
Log in to the ID Gitlab instance (https://gitlab.ethz.ch/)
Create a new project and choose Import project
Click on the Gitlab export button
Then follow the steps on the following screenshot
If everything worked, the following message/view should appear:
Further steps after import
Manually recreate data that could not be exported
Everything that could not be exported by Gitlab must be recreated in ID Gitlab after the import.
Remove the read-only status
In ID Gitlab, remove the read-only status after import.
Follow the steps on the following screenshot:
Click on Settings
Click on General
Open Advanced
Click on the Unarchive project button
SSH keys
Import your SSH key into ID Gitlab if you have already worked with it at ISG D-ITET Gitlab.
Redirect ISG D-ITET Gitlab project URL to ID Gitlab
If you want to have a redirect from ISG D-ITET Gitlab to ID Gitlab after importing to ID Gitlab, please send us a mail to support@ee.ethz.ch.
Please send us the following information:
Original URL https://git.ee.ethz.ch/<namespace>/<projectname>
It is important to note that the redirect only works in the browser, not for git commands such as git clone.
What will happen to your projects in the ISG D-ITET Gitlab instance after 12/31/2021?
We will archive the projects on file level and remove them from the ISG D-ITET Gitlab, if they have not been deleted by yourself before.