Gitlab ISG to ID migration

This page describes how to migrate a Gitlab project from ISG Gitlab Server to ID Gitlab Server.

Project export on ISG Gitlab server

{i} 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

  1. Log in to the ISG Gitlab instance (https://git.ee.ethz.ch/)

  2. Open the project you want to export

Follow the steps on the following screenshot:

  1. Click on Settings

  2. Click on General

  3. Open Advanced

  4. Click on the Archive project button

gitlab-export-project-10.png

Start the project export

Follow the steps on the following screenshot:

  1. Click on Settings

  2. Click on General

  3. Open Advanced

  4. Click on the Export button

gitlab-export-project-01.png

Info regarding project members





The following message will be displayed:
gitlab-export-project-02.png

Download the project/export

Option 1 - Gitlab

Follow the steps on the following screenshot:

  1. Click on Settings

  2. Click on General

  3. Open Advanced

  4. Click on the Download export button

gitlab-export-project-03.png

Option 2 - Email

Just open the link in the email.
gitlab-export-project-04.png

Project import on ID Gitlab server

  1. Log in to the ID Gitlab instance (https://gitlab.ethz.ch/)

  2. Create a new project and choose Import project
    gitlab-export-project-05.png

  3. Click on the Gitlab export button
    gitlab-export-project-06.png

  4. Then follow the steps on the following screenshot
    gitlab-export-project-07.png





If everything worked, the following message/view should appear:
gitlab-export-project-08.png

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.
gitlab-export-project-09.png

Remove the read-only status

In ID Gitlab, remove the read-only status after import.
Follow the steps on the following screenshot:

  1. Click on Settings

  2. Click on General

  3. Open Advanced

  4. Click on the Unarchive project button

gitlab-export-project-11.png

SSH keys

Import your SSH key into ID Gitlab if you have already worked with it at ISG Gitlab.

Redirect ISG Gitlab project URL to ID Gitlab

If you want to have a redirect from ISG 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:

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 Gitlab instance after 12/31/2021?

We will archive the projects on file level and remove them from the ISG Gitlab, if they have not been deleted by yourself before.


CategoryREVC

Services/VersionControlSystems/GitlabMigration (last edited 2021-07-22 12:09:12 by pmeier)