User Tools

Site Tools


gitlab:start

GitLab User Documentation

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

See https://gitlab.unige.ch/help/user/index.md if you are looking for the upstream documentation of the UNIGE GitLab running instance.

Access

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.

SSH

Git clone/push/pull are available:

  1. via SSH (see https://gitlab.unige.ch/help/ssh/README.md ) 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 )

Permissions

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
Independently of the authentication source (SWITCHaai or SWITCH edu-ID), those users without a UNIGE mail address will automatically get an external account (see https://gitlab.unige.ch/help/user/permissions#external-users ), which means that:
  1. they can not create groups or projects
  2. read access to private or internal projects must be explicitly granted
  3. read access to public projects is permitted
  4. write access to any project must be explicitly granted

Resources

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.

Project visibility

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.

External resources

gitlab/start.txt · Last modified: 2021/09/20 16:41 by Yann Sagon