Differences between revisions 10 and 20 (spanning 10 versions)
Revision 10 as of 2021-05-21 09:37:33
Size: 2308
Editor: pmeier
Comment:
Revision 20 as of 2023-10-16 11:13:09
Size: 3981
Editor: alders
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Gitlab ISG to ID migration =
This page describes how to migrate a Gitlab project from ISG Gitlab Server to ID Gitlab Server.
= 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.
Line 6: Line 6:
== Project export on ISG Gitlab server == == Project export on ISG D-ITET Gitlab server ==
{i} It is a good idea to inform all project members about the upcoming migration of a project to avoid any confusion.
Line 8: Line 9:
 1. Log in to the ISG Gitlab instance ([[https://git.ee.ethz.ch/|https://git.ee.ethz.ch/|target="_blank"]]) === Set the project to read-only ===
1. Log in to the ISG D-ITET Gitlab instance ([[https://git.ee.ethz.ch/|https://git.ee.ethz.ch/|target="_blank"]])
Line 11: Line 13:
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
{{attachment:gitlab-export-project-10.png}}

=== Start the project export ===
Line 18: Line 28:
Info regarding project members:
 * Project members are also '''not''' exported.
=== Info regarding project members ===
 * Project members are '''not''' exported.
Line 55: Line 65:
=== Manually recreate data that could not be exported ===
Line 57: Line 68:
<<BR>>
=== Remove the read-only status ===
In ID Gitlab, remove the read-only status after import.<<BR>>
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
{{attachment:gitlab-export-project-11.png}}

=== 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.<<BR>>
Please send us the following information:
 * Original URL https://git.ee.ethz.ch/<namespace>/<projectname>
 * Target URL https://gitlab.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.

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.

Project export on ISG D-ITET 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 D-ITET 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

  • 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:
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 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:

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.


CategoryREVC

Services/VersionControlSystems/GitlabMigration (last edited 2023-10-16 11:13:09 by alders)