= 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.

<<TableOfContents()>>

== 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/|https://git.ee.ethz.ch/|target="_blank"]])
 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
{{attachment: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
{{attachment:gitlab-export-project-01.png}} 
<<BR>>
=== 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.
<<BR>>
<<BR>>
<<BR>>
<<BR>>
The following message will be displayed:<<BR>>
{{attachment: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
{{attachment:gitlab-export-project-03.png}} 

=== Option 2 - Email ===
Just open the link in the email.<<BR>>
{{attachment:gitlab-export-project-04.png}} 

== Project import on ID Gitlab server ==
 1. Log in to the ID Gitlab instance ([[https://gitlab.ethz.ch/|https://gitlab.ethz.ch/|target="_blank"]])
 2. Create a new project and choose '''Import project'''<<BR>>{{attachment:gitlab-export-project-05.png}} 
 3. Click on the '''Gitlab export''' button<<BR>>{{attachment:gitlab-export-project-06.png}} 
 4. Then follow the steps on the following screenshot<<BR>>{{attachment:gitlab-export-project-07.png}} 
<<BR>>
<<BR>>
<<BR>>
<<BR>>
If everything worked, the following message/view should appear:<<BR>>
{{attachment: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.<<BR>>
{{attachment:gitlab-export-project-09.png}} 

=== 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.
----
[[CategoryREVC]]