GitLab User Documentation

Welcome on the UNIGE GitLab documentation. You will find here all the information you need to use the UNIGE GitLab instance.

Please see the UNIGE official formations at Source code management with Git.

gitlab.unige.ch is open to the whole Swiss educational audience via SWITCHaai (UNIGE members should use their ISIs credentials) and to any non-academic entity via SWITCH edu-ID (free registration required) . For this reason, password authentication has been deactivated.

Git clone/push/pull are available:

1. via SSH (see https://gitlab.unige.ch/help/user/ssh ) after either the user has added a key in the GitLab profile settings or one of the project administrators has set up a Deploy Key in the GitLab project interface (see https://gitlab.unige.ch/help/user/project/deploy_keys/index.md )
2. via HTTPS after the user has generated a Personal Access Token in the GitLab profile settings (see https://gitlab.unige.ch/help/user/profile/personal_access_tokens.md ) or one of the project administrators has set up a Deploy Token in the GitLab project interface (see https://gitlab.unige.ch/help/user/project/deploy_tokens/index.md )

Access to each resource is directly managed per (sub)group or project via the web interface (see https://gitlab.unige.ch/help/user/permissions ).

To easy access management, you should think in a hierarchical terms from the very beginning:

1. create a top-level group with the least possible members (basically, only the administrators)
2. inside this group, create sub-groups or projects with specific permissions

By default, the following settings apply to any internal users:

1. maximum number of projects: 20
2. maximum size of a single project: 100MB
3. maximum size of an attachment: 10MB
4. maximum size of a single git push : 1MB

Please contact the UNIGE GitLab administrators (see https://catalogue-si.unige.ch/gitlab ) if you need more resources.

The UNIGE GitLab instance is based on the upstream Community Edition (cf. https://about.gitlab.com/install/ce-or-ee/), since until now no Enterprise features have been needed after various evaluation.

Of the CE-included feature, the UNIGE GitLab instance does not support the following ones:

1. CI/CD shared runners (cf. https://dataforum.unige.ch/t/gitlab-runners-not-available/401)
2. Pages (cf. https://dataforum.unige.ch/t/gitlab-pages-support/194)
3. PlantUML (cf. https://gitlab.unige.ch/help/administration/integration/plantuml.md via https://support-si.unige.ch/openentry.html?tid=INC000000146442)

By default, each project is private , i.e. they can only be cloned and viewed by project members.

For more details, please check the corresponding section of the upstream documentation of the UNIGE GitLab instance.

The link contained in the e-mail from the address GitLab noreply-gitlab@unige.ch sent to your email address is valid for three days.

After this time, you must request a confirmation again by yourself.

Please do not attempt to authenticate yourself by clicking on the Sign in link on this page!

Here are the procedures for both cases:

• open the confirmation e-mail with Confirmation instructions subject from GitLab noreply-gitlab@unige.ch
• click on Confirm your email address link
  • here's an example of a confirmation link:

• you will be automatically authenticated and you will obtain the following message confirming your e-mail address validation:

• open the confirmation e-mail with Confirmation instructions subject from GitLab noreply-gitlab@unige.ch
• click on Confirm your email address link
  • here's an example of a confirmation link:

• on this page you will obtain the following error message explaining that the deadline has been exceeded:

• in the email field below error message, input again your email address to be confirmed
• click on the Resend button
• as soon you receive your new confirmation e-mail, follow the steps in the previous paragraph (Email address confirmation within the three days deadline).

Learn Git with a game: https://ohmygit.org/

Git Windows client https://dataforum.unige.ch/t/recommended-git-client-for-gitlab-unige-account/322/2

SPC VCS courses https://spc.unige.ch/en/teaching/digitalskills/source-code-management-git/

You did something wrong with Git? This site may help you: https://ohshitgit.com/