First Steps with git.nrw

You can login via the single sign-on of your university.

Create a project

A new project can be created using the “+” symbol or the “New Project” button. Important Details here:

• Project Name — Name of the project e.g. “my test project”. The name must not contain any spaces or special characters.
• Visibility Level
  • Private (Only you can see the project)
  • Internal (All users of the git.nrw instance can see the project)
  • Public (The project can be seen worldwide)

Click on the button “Create Project” to create the project.

The project can optionally be initialized with a README file, which is written in Markdown. Further settings can also be made after the project has been created, e.g. adding members, configuring CI/CD pipelines, etc.

Runner

You can find instructions on how to install the GitLab Runner on different operating systems at docs.gitlab.com/runner .

Export projects

When exporting projects, the following elements are exported:

• Project and Wiki repository
• Project uploads
• Project configuration including services
• Issues with comments, Merge Requests with Diffs and comments, Labels, Milestones, Snippets and other parts of the project
• LFS Objects
• Issue Boards

The following elements are not exported:

• Job artifacts
• Container and Registry Images
• CI Variables
• Webhooks
• All encrypted Tokens

Export via GUI

1. Open the project page
2. Click on “Settings” then “General” in the left-hand navigation bar
3. Scroll down to “Advanced”
4. Find the “Export project” section and press the button “Export project”

As soon as the export is complete, a “Download export” button appears next to the “Export project” button. Click on this. Once the export has been downloaded, it can be imported back into GitLab.

Import projects

Import via GUI

To import while creating a new project, click on “Import Project” and then “GitLab Export”. In the next step, set “Project name”, “Project URL” and “Project slug”.

The GitLab export can now be selected under “Choose File”. You can then select the visibility level and optionally enter a description. The import is then completed by clicking the “Create project” button.

During the migration, authorizations are not transferred and existing local copies of the project must be updated.

Create a group

The group overview can be opened by clicking on “Groups” in the top menu and then “Your Groups”. The group can then be created using the “New Group” button. The following settings have to be made:

• Assign a group name under “Group name”
• The “Group URL” is automatically filled in according to the project name
• The “Group description” can be filled with a description of the group
• A group picture can be defined under “Group avatar”
• The visibility level of the group is set under “Visibility level” (private, internal, public)

Click on “Create group” to create the group and add members. To do this, click on “Members” in the group menu and enter the e-mail addresses or user names. In this view, members can also be removed or the group can be left by the creator.