GitLab

Service description

GitLab is a collaborative hosted git service. Our GitLab instance is provided to academic users members of the federation eduGAIN and their collaborators, for a professional use only. It is deployed using the Community Edition version.

In case of problem, please contact our user support.

Disclaimer

Quality of service

We provide this service on a best effort basis.

Compliance with the terms of use

We may disable/remove accounts or projects that do not comply with the terms of use, in particular with respect to intellectual property rights.

Project visibility

There are 3 levels of visibility for a project (and the code that it contains):

  • Private: the project is visible and may be cloned only by the owner and users or group that he has explicitly added;
  • Internal: the project is visible and may be cloned by any logged user;
  • Public: the project can be cloned without any authentication. It will also be listed on the public access directory (/public).

By default, every new project is private but can inherit its parent group visibility.

User accounts

How to Sign-up

  • academic users should register using eduGAIN federation, by clicking on [Shibboleth]
  • other users must register by clicking [Sign-up]

Registering with your institutional e-mail is preferable.

For non-eduGAIN users who wish to get a full access, someone belonging to a partner organization should vouch for you to user support. New non-eduGAIN users will, by default, be set as external. Validators will unlock the account after verification.

SSH configuration

The recommended way to interact with a git repository (project) is to use SSH. You can follow this documentation to help configure your SSH key.

Enable Shibboleth

When an account is created using the standard [Sign-up] method, the user won’t be able to use Shibboleth authentication. To be able to do so, you should configure it in your profile:

Profile Settings > Account > Social sign-in

The goal is to use the Single Sign On method proposed by the Identity federations.

Shibboleth duplicates

When registering with Shibboleth, GitLab builds the username field using the first part of the e-mail address up to the @ character. This may create duplicates with already registered usernames from the user organizations. To avoid it you have to:

  • register using the [Sign-up] option and choosing a different username;
  • enable Shibboleth for that account.

Continuous Integration/Deployment

The continuous integration platform is based on GitLab. You must configure your GitLab project to use a Runner; thus each commit or push triggers the execution of continuous integration pipelines.

Information concerning continuous integration (pipelines, jobs, environments, etc.) is displayed in the “CI/CD” menu of the GitLab vertical menu. For any issue you may contact our user support.

Uploading large files

GitLab is not made to store large binary files. To manage files, such as audio, video, graphics files or virtual machines images, GitLab supports “git lfs”.